# Throk MCP の設定：Claude や Cursor で Threads のデータを照会する

Throk は [MCP（Model Context Protocol）](https://modelcontextprotocol.io) サーバーを提供しています。設定が済めば、AI アシスタントに自然な言葉でデータの照会を頼めます。例：

> 「減脂」の直近 30 日間の台湾での言及量の推移を調べて、いいね数が最も多い投稿を 5 件見つけ、それぞれの書き出しをまとめて。

## 接続情報

| 項目 | 値 |
| --- | --- |
| URL | `https://premium-api.throk.ai/mcp` |
| トランスポート | Streamable HTTP |
| 認証 | ヘッダー `Authorization: Bearer sk-throk-...`（REST API と同じキーを使用） |

## インストール

開発者プラットフォームの [**MCPサーバー**](https://developer.throk.ai/dashboard/mcp) ページにも、各 AI ツール向けの設定例があり、そのままコピーできます。

### Claude Code

```bash
claude mcp add --transport http throk \
  https://premium-api.throk.ai/mcp \
  --header "Authorization: Bearer sk-throk-..."
```

### Claude Desktop

設定ファイルの `mcpServers` に次の内容を追加します。

```json
{
  "mcpServers": {
    "throk": {
      "url": "https://premium-api.throk.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-throk-..."
      }
    }
  }
}
```

### Cursor

`.cursor/mcp.json` に同じ設定を追加します。

```json
{
  "mcpServers": {
    "throk": {
      "url": "https://premium-api.throk.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-throk-..."
      }
    }
  }
}
```

## 利用できるツール

すべてのツールは読み取り専用です。

### 検索

| ツール | 用途 | クレジット |
| --- | --- | --- |
| `search_posts` | キーワードで投稿を検索（最大 25 件） | 1 件につき 1 クレジット（詳細データ込みの場合は 1 件につき 2 クレジット） |
| `semantic_search_posts` | 直近 30 日の投稿を意味で検索（最大 10 件） | 30 クレジット |
| `get_inspiration` | 高エンゲージメントの厳選投稿からアイデアを探す（最大 10 件） | 30 クレジット |
| `get_hot_posts` | 人気投稿（30〜50 件） | 70 クレジットから。1 件増えるごとに 2 クレジット追加（閲覧数順の場合は 100 クレジットから） |
| `get_keyword_trend` | キーワードの日次言及量（最大 10 キーワード、90 日） | 3 クレジット × キーワード数 × 日数（エンゲージメント数込みの場合は 4 クレジット） |

### アカウント

| ツール | 用途 | クレジット |
| --- | --- | --- |
| `get_user` | アカウント情報と最近の投稿 | 1 クレジット。投稿 5 件ごとに 1 クレジット追加 |
| `get_user_top_threads` | アカウントのいいね数上位の投稿 | 70 クレジットから |
| `get_user_follower_history` | アカウントの日次フォロワー数（最大 365 日） | 日数 ÷ 3（切り上げ）、最低 1 クレジット |

### ランキング

| ツール | 用途 | クレジット |
| --- | --- | --- |
| `get_cool_replies` | 神返信ランキング | 70 クレジットから |
| `get_post_like_growth` | バズ投稿（いいね数の伸びが最も速い投稿） | 70 クレジットから |
| `get_follower_growth` | フォロワーの伸びが最も速いアカウント | 70 クレジットから |
| `get_follower_ladder` | フォロワー数ラダー（各レンジの基準値） | 5 クレジット |
| `get_like_ladder` | いいね数ラダー（直近 24 時間） | 5 クレジット |
| `get_power_hours` | プラットフォームのゴールデンタイム（直近 28 日） | 5 クレジット |

### ライブデータと予測

| ツール | 用途 | クレジット |
| --- | --- | --- |
| `forecast_posts` | 投稿から 1〜12 時間以内の投稿が、閲覧数の基準に達するかを予測 | 1 件につき 10 クレジット |
| `get_live_posts` | 投稿の現在の数値をリアルタイムで取得（投稿時期を問わない） | 1 件につき 3 クレジット（閲覧数が非表示の場合は 1 クレジット） |
| `get_live_users` | アカウントの現在のフォロワー数とプロフィールをリアルタイムで取得 | 1 アカウントにつき 3 クレジット |

### アカウント残高

| ツール | 用途 | クレジット |
| --- | --- | --- |
| `get_balance` | 残りのクレジットを照会 | 無料 |

## REST API との違い

- **件数の上限が小さめです。** レスポンスを簡潔に保つためです。例：`search_posts` は最大 25 件、`semantic_search_posts` は最大 10 件。大量のデータが必要な場合は REST API を使ってください。
- **デフォルトではメディアの URL とプロフィール画像の URL を含みません。** 必要な場合は、このパラメータに対応したツールで `include_media=true` を指定してください。
- **1 回の呼び出しのタイムアウトは 60 秒です。**
- 検索ルールは REST API とまったく同じです。[検索ルール](/ja/api/guides/search-rules/)をご覧ください。