┌─────────────────────────────────────────────────────────────────────┐
│                NOTE RESEARCH SYSTEM v1.0                            │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ┌───────────────┐    ┌───────────────┐    ┌───────────────┐       │
│  │  note.com     │    │   WebSearch   │    │   WebFetch    │       │
│  │  非公式API    │    │  (Anthropic)  │    │  (直接取得)   │       │
│  └───────┬───────┘    └───────┬───────┘    └───────┬───────┘       │
│          │                    │                    │               │
│          └────────────────────┼────────────────────┘               │
│                               ▼                                    │
│                    ┌─────────────────┐                             │
│                    │   データ統合    │                             │
│                    │   ・記事情報    │                             │
│                    │   ・ユーザー情報│                             │
│                    │   ・トレンド    │                             │
│                    └────────┬────────┘                             │
│                             ▼                                      │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │                    出力形式                                  │   │
│  │  ・ジャンル別レポート   ・ユーザー別レポート                 │   │
│  │  ・売れ筋分析           ・構成テンプレート抽出               │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                                                                     │
│  ✅ APIキー不要  ✅ コストゼロ  ✅ 即座に利用可能                  │
└─────────────────────────────────────────────────────────────────────┘

# ジャンル別リサーチ
/note-research ジャンル=副業

# ユーザー別リサーチ
/note-research ユーザー=@username

# キーワード検索
/note-research キーワード=ChatGPT 活用法

# 売れ筋分析
/note-research 売れ筋 ジャンル=マーケティング

# 構成テンプレート抽出
/note-research テンプレート ジャンル=ビジネス

GET https://note.com/api/v2/creators/{username}

{
  "data": {
    "id": 12345,
    "urlname": "username",
    "name": "表示名",
    "noteCount": 150,
    "followerCount": 5000,
    "followingCount": 200,
    "profile": "プロフィール文"
  }
}

GET https://note.com/api/v1/notes/{note_key}

GET https://note.com/api/v3/articles?tag={tag_name}&page=1

GET https://note.com/api/v2/creators/{username}/contents?kind=note&page=1

GET https://note.com/api/v3/trending/notes

1. WebSearch で note.com 内の記事を検索
   → "site:note.com {ジャンル} 有料記事"
   → "site:note.com {ジャンル} 人気"

2. 上位記事のURLを抽出

3. 各記事の非公式APIで詳細取得
   → スキ数、コメント数、価格

4. WebFetch で記事ページから構成を分析

5. レポート生成

1. 非公式API でユーザー情報取得
   → /api/v2/creators/{username}

2. ユーザーの記事一覧取得
   → /api/v2/creators/{username}/contents

3. 各記事の詳細分析

4. ユーザーの強み・パターン分析

5. レポート生成

import requests
import json
from typing import Optional, List, Dict
import time

class NoteResearcher:
    """note.com 非公式APIリサーチャー"""

    BASE_URL = "https://note.com/api"

    def __init__(self):
        self.session = requests.Session()
        self.session.headers.update({
            "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
            "Accept": "application/json",
        })

    def get_user(self, username: str) -> Optional[Dict]:
        """ユーザー情報を取得"""
        url = f"{self.BASE_URL}/v2/creators/{username}"
        try:
            resp = self.session.get(url)
            if resp.status_code == 200:
                return resp.json().get("data")
        except Exception as e:
            print(f"Error: {e}")
        return None

    def get_user_notes(self, username: str, page: int = 1) -> List[Dict]:
        """ユーザーの記事一覧を取得"""
        url = f"{self.BASE_URL}/v2/creators/{username}/contents"
        params = {"kind": "note", "page": page}
        try:
            resp = self.session.get(url, params=params)
            if resp.status_code == 200:
                return resp.json().get("data", {}).get("contents", [])
        except Exception as e:
            print(f"Error: {e}")
        return []

    def get_note(self, note_key: str) -> Optional[Dict]:
        """記事詳細を取得"""
        url = f"{self.BASE_URL}/v1/notes/{note_key}"
        try:
            resp = self.session.get(url)
            if resp.status_code == 200:
                return resp.json().get("data")
        except Exception as e:
            print(f"Error: {e}")
        return None

    def get_trending(self) -> List[Dict]:
        """トレンド記事を取得"""
        url = f"{self.BASE_URL}/v3/trending/notes"
        try:
            resp = self.session.get(url)
            if resp.status_code == 200:
                return resp.json().get("data", [])
        except Exception as e:
            print(f"Error: {e}")
        return []

    def search_by_tag(self, tag: str, page: int = 1) -> List[Dict]:
        """タグで記事を検索"""
        url = f"{self.BASE_URL}/v3/articles"
        params = {"tag": tag, "page": page}
        try:
            resp = self.session.get(url)
            if resp.status_code == 200:
                return resp.json().get("data", [])
        except Exception as e:
            print(f"Error: {e}")
        return []


def research_genre(genre: str) -> Dict:
    """ジャンル別リサーチ"""
    researcher = NoteResearcher()
    results = {
        "genre": genre,
        "trending": [],
        "by_tag": [],
    }

    # トレンド取得
    results["trending"] = researcher.get_trending()

    # タグ検索
    results["by_tag"] = researcher.search_by_tag(genre)

    return results


def research_user(username: str) -> Dict:
    """ユーザー別リサーチ"""
    researcher = NoteResearcher()
    results = {
        "username": username,
        "user_info": None,
        "notes": [],
    }

    # ユーザー情報
    results["user_info"] = researcher.get_user(username)

    # 記事一覧（最大3ページ）
    for page in range(1, 4):
        notes = researcher.get_user_notes(username, page)
        if not notes:
            break
        results["notes"].extend(notes)
        time.sleep(0.5)  # レート制限対策

    return results

# {ジャンル} ジャンル リサーチレポート

**調査日**: {date}
**調査対象**: note.com内 {ジャンル} 関連記事

---

## 概要

- **分析記事数**: {count}件
- **平均スキ数**: {avg_likes}
- **有料記事比率**: {paid_ratio}%

---

## トップ記事

| 順位 | タイトル | 著者 | スキ | 価格 |
|------|---------|------|------|------|
{top_articles_table}

---

## 売れ筋パターン

### タイトルパターン
{title_patterns}

### 価格帯分布
{price_distribution}

### 文字数分布
{char_count_distribution}

---

## 構成テンプレート

### パターン1: 問題解決型
{template_1}

### パターン2: ノウハウ提供型
{template_2}

---

## 推奨アクション

1. {recommendation_1}
2. {recommendation_2}
3. {recommendation_3}

site:note.com {ジャンル} 有料記事 人気
site:note.com {ジャンル} 売れてる
site:note.com {ジャンル} ベストセラー
site:note.com {ジャンル} おすすめ

site:note.com note 構成 テンプレート
site:note.com 売れる note 書き方
site:note.com note 有料記事 コツ
note記事 構成 黄金パターン
note 書き方 売れる コツ

site:note.com @{username}
"{username}" note 人気

research/note/<timestamp>__<query>/
├── input.yaml       # 入力パラメータ
├── raw_data.json    # 取得した生データ
├── analysis.json    # 分析結果
├── report.md        # 最終レポート
└── templates/       # 抽出したテンプレート