API ・ MCP
あなたのAgentにも、Threadsの目を。
コマンド1行でThrokをClaude、Cursor、自作プログラムに接続。Agentはバズ投稿を検索し、トレンドを調べ、アカウントを読む。すべての回答の裏に検証済みの数字があります。
terminal
streamable http・stateless
# コマンド1行でClaude Codeに接続
claude mcp add --transport http throk \
https://premium-api.throk.ai/mcp \
--header "Authorization: Bearer sk-throk-..."開発者、AIエージェント、Threadsデータを組み込みたいプロダクト向けです。
AGENT 実況
Agentはこのデータをどう使う？
実際の問いを投げて、Agentが自らツールを呼び、データを読み、根拠のある提案を返すまで。下は一連の会話です。
mcp · throk
「転職」というテーマ、まだ伸びしろある？
⚙ get_hot_posts⚙ get_keyword_trend⚙ search_posts
まだ上昇中です。「転職」の直近7日間の投稿数は3.1倍に増加。しかも5万いいね超えの天井投稿はまだ出ていません：
6/07
6/09
6/11
6/13
切り口の提案：「辞めました」ではなく「残った人はどう思っているか」を書く。高エンゲージメントのリプライの38%はまだ辞めていない様子見層からで、この層は代弁者を探しています。
全ツール一覧
6つのツール、1つのキー
キーワード検索、人気ランキング、トレンドから、ユーザープロフィールとフォロワー履歴まで。
| ツール | 返すもの | 上限 |
|---|---|---|
| search_posts | キーワードで公開投稿を検索 | 25 件 / 回 |
| get_hot_posts | 人気投稿ランキング | 50 件 |
| get_keyword_trend | キーワードの日次ボリューム | 10 語 × 90 日 |
| get_user | ユーザープロフィールと最近の投稿 | 各 25 件 |
| get_user_top_threads | ユーザーのいいね上位投稿 | 最長 720 日 |
| get_user_follower_history | フォロワー数履歴 | 最長 365 日 |
接続方法
MCP か REST
AgentにはMCP、サービスにはREST。
MCP Server
Claude、CursorなどMCP対応クライアントに、コマンド1行で接続。
{
"throk": {
"url": "https://premium-api.throk.ai/mcp",
"headers": {
"Authorization": "Bearer sk-throk-..."
}
}
}REST API
GET · POST · Bearer auth
# またはRESTを直接叩く
curl "https://premium-api.throk.ai/post/hot?size=30" \
-H "Authorization: Bearer sk-throk-..."よくある質問
- APIのクレジットはThrokのサブスクと同じですか？
- いいえ。開発者プラットフォームには独立したAPIプランとクレジットがあり、ウェブ版のFree／Creator／Creator+サブスクとは完全に別建てで、相互に利用できません。開発者コンソールで別途契約が必要です。
- 無料枠はありますか？料金は？
- APIアクセスに無料枠はありません。プランは月間クレジット数で分かれ、API Lite（月15,000クレジット）からPremium（月6,000,000クレジット）まで、開発者コンソールで購入できます。
- クレジットの有効期限は？追加購入できますか？
- クレジットは購入日から1か月間有効で、使い切らなくても翌期に繰り越されません。API Standard以上のプランはいつでも追加購入でき、追加分は当期プランと同時に失効します。
- MCPとREST、どちらを使う？対応クライアントは？
- AIエージェントに使わせるならMCP。Claude、Cursorなどに対応し、コマンド1行で接続できます。自分のサービスから直接呼ぶならREST。すべての機能は両方でカバーされます。
- データの範囲は？
- Threads公開投稿の検索、人気ランキング、キーワードトレンド、ユーザープロフィール、フォロワー履歴をカバーし、地域に応じて繁体字中国語・日本語・韓国語の市場に対応します。
- どう始めれば？
- developer.throk.aiで登録してAPIキーを発行し、プランを選べば呼び出しを始められます。