note-research

name	note-research
description	note.comのリサーチツール - 非公式API + MCP + WebSearchでゼロコストリサーチ
disable-model-invocation	false
allowed-tools	["Bash","Read","Write","WebSearch","WebFetch","Grep","Glob"]

note-research - ゼロコストnoteリサーチシステム

概要

note.comの記事・ユーザー情報をコストゼロで取得するリサーチツール。

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

使い方

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

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

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

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

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

note.com 非公式API エンドポイント

1. ユーザー情報取得

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

レスポンス例:

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

2. 記事情報取得

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

note_keyの取得方法: URLから抽出

• https://note.com/username/n/n1234567890ab → n1234567890ab

3. タグ別記事一覧

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

4. ユーザーの記事一覧

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

5. 人気記事（トレンド）

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. レポート生成

実装スクリプト

Pythonスクリプト（scripts/note_api.py）

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 = ) -> []:
        
        url = 
        params = {: , : page}
        :
            resp = .session.get(url, params=params)
             resp.status_code == :
                 resp.json().get(, {}).get(, [])
         Exception  e:
            ()
         []

     () -> []:
        
        url = 
        :
            resp = .session.get(url)
             resp.status_code == :
                 resp.json().get()
         Exception  e:
            ()
         

     () -> []:
        
        url = 
        :
            resp = .session.get(url)
             resp.status_code == :
                 resp.json().get(, [])
         Exception  e:
            ()
         []

     () -> []:
        
        url = 
        params = {: tag, : page}
        :
            resp = .session.get(url)
             resp.status_code == :
                 resp.json().get(, [])
         Exception  e:
            ()
         []


 () -> :
    
    researcher = NoteResearcher()
    results = {
        : genre,
        : [],
        : [],
    }

    
    results[] = researcher.get_trending()

    
    results[] = researcher.search_by_tag(genre)

     results


 () -> :
    
    researcher = NoteResearcher()
    results = {
        : username,
        : ,
        : [],
    }

    
    results[] = researcher.get_user(username)

    
     page  (, ):
        notes = researcher.get_user_notes(username, page)
          notes:
            
        results[].extend(notes)
        time.sleep()  

     results

レポートテンプレート

ジャンル別レポート（templates/genre_report.md）

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

**調査日**: {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}

WebSearch検索パターン

ジャンル別

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/       # 抽出したテンプレート

制限事項

1. レート制限: 非公式APIは過度なアクセスを避ける（1秒間隔）
2. 認証: ログイン必須のデータは取得不可
3. 価格情報: 有料記事の本文は取得不可（メタデータのみ）

関連スキル

• research-free - 汎用WebSearchリサーチ
• mega-research - API統合リサーチ（要APIキー）
• keyword-free - キーワード抽出