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

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

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

接続情報

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

インストール

開発者プラットフォームの MCPサーバー ページにも、各 AI ツール向けの設定例があり、そのままコピーできます。

Claude Code

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

Claude Desktop

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

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

Cursor

.cursor/mcp.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 とまったく同じです。検索ルールをご覧ください。