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%はまだ辞めていない様子見層からで、この層は代弁者を探しています。
接続方法
MCP か REST
AgentにはMCP、サービスにはREST。
02 · REST API
REST API
またはRESTを直接叩く
THREADS API 料金
月額US$30から。月間クレジットで選べます。
4プランすべてで全APIエンドポイントを利用できます。Throk MCPとREST APIは同じ開発者クレジットを使います。
答えられること
AI AgentはThrokで何を調べられる？
先に判断したいことを決め、必要なThreadsデータを選びます。ツール名と制限は技術資料にまとめています。
- 01
テーマと需要を探す
投稿、意味の近いコンテンツ、キーワード量を検索。
- 02
競合とアカウントを見る
最近の投稿、人気投稿、フォロワー変化を確認。
- 03
トレンドとタイミングをつかむ
人気・成長ランキングと投稿時間帯を確認。
13ツールと検索制限を見る＋
全ツール一覧
13のツール、1つのキー
キーワード・セマンティック検索、人気・急上昇ランキング、神リプライやフォロワー増加から、ゴールデンタイムのヒートマップ、フォロワー・いいねのパーセンタイル、ユーザープロフィールとフォロワー履歴まで。
| ツール | 返すもの | 上限 |
|---|---|---|
| search_posts | キーワードで公開投稿を検索 | 25 件 / 回 |
| get_inspiration | トピックで高エンゲージ投稿を意味検索 | 10 件 |
| get_hot_posts | 人気投稿ランキング | 50 件 |
| get_keyword_trend | キーワードの日次ボリューム | 10 語 × 90 日 |
| get_post_like_growth | 急上昇投稿ランキング | 50 件 |
| get_cool_replies | 神リプライランキング | 50 件 |
| get_follower_growth | フォロワー急増ランキング | 50 件 |
| get_power_hours | ゴールデンタイムのヒートマップ | 直近 28 日 |
| get_follower_ladder | フォロワー数パーセンタイル | パーセンタイル |
| get_like_ladder | いいね数パーセンタイル | 直近 24 時間 |
| get_user | ユーザープロフィールと最近の投稿 | 各 25 件 |
| get_user_top_threads | ユーザーのいいね上位投稿 | 最長 720 日 |
| get_user_follower_history | フォロワー数履歴 | 最長 365 日 |
よくある質問
- APIのクレジットはThrokのサブスクと同じですか？
- いいえ。開発者プラットフォームには独立したAPIプランとクレジットがあり、ウェブ版のFree／Creator／Creator+サブスクとは完全に別建てで、相互に利用できません。開発者コンソールで別途契約が必要です。
- 無料枠はありますか？料金は？
- APIアクセスに無料枠はありません。プランは月間クレジット数で分かれ、API Lite（月15,000クレジット）からPremium（月6,000,000クレジット）まで、開発者コンソールで購入できます。
- クレジットの有効期限は？
- クレジットは購入日から1か月間有効で、未使用分は翌期に繰り越されません。もっと必要なときは、上位プランへのアップグレードのほか、プランのレート（API Standard US$10／Plus US$5／Premium US$4・10,000 クレジットあたり）で買い切りの追加購入もできます。追加分は今の請求サイクル終了時にリセットされます。
- MCPとREST、どちらを使う？対応クライアントは？
- AIエージェントに使わせるならMCP。Claude、Cursorなどに対応し、コマンド1行で接続できます。自分のサービスから直接呼ぶならREST。すべての機能は両方でカバーされます。
- データの範囲は？
- Threads公開投稿の検索、人気ランキング、キーワードトレンド、ユーザープロフィール、フォロワー履歴をカバーし、地域に応じて繁体字中国語・日本語・韓国語の市場に対応します。
- どう始めれば？
- developer.throk.aiで登録してAPIキーを発行し、プランを選べば呼び出しを始められます。