API ・ MCP
你的 Agent,也能長出 Threads 的眼睛。
一行指令把 Throk 接進 Claude、Cursor 或你自己的程式。Agent 從此能搜爆文、查趨勢、讀帳號,每個回答背後都有查證過的數字。
terminal
streamable http・stateless
# 一行指令接進 Claude Code
claude mcp add --transport http throk \
https://premium-api.throk.ai/mcp \
--header "Authorization: Bearer sk-throk-..."供開發者、AI Agent 與想串接 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% 來自還沒離職的觀望者,這群人在找代言人。
完整工具列表
六個工具,一組金鑰
從關鍵字搜尋、熱門排行、趨勢,到用戶檔案與粉絲歷史,一次到位。
| 工具 | 回傳 | 上限 |
|---|---|---|
| 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 的客戶端,一行指令接上。
{
"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 積分/月),可在開發者主控台選購。
- 積分多久到期?可以加購嗎?
- 積分自購買日起一個月內有效,未用完不累計到下一期。API Standard 以上方案可隨時加購,加購的積分與當期方案同步到期。
- 該用 MCP 還是 REST?支援哪些客戶端?
- 要讓 AI Agent 使用就用 MCP,支援 Claude、Cursor 等客戶端,一行指令接上;想在自己的服務裡直接呼叫就用 REST。所有功能兩邊都涵蓋。
- 資料涵蓋哪些範圍?
- 涵蓋 Threads 公開貼文的關鍵字搜尋、熱門排行、關鍵字趨勢、用戶檔案與粉絲歷史,並依地區支援繁體中文、日文與韓文市場。
- 怎麼開始?
- 到 developer.throk.ai 註冊、建立 API 金鑰,選擇方案後即可開始呼叫。