Throk MCP 安裝設定：在 Claude、Cursor 查詢 Threads 資料

Throk 提供 MCP（Model Context Protocol）伺服器。設定好之後，你可以直接用自然語言請 AI 助手查資料，例如：

幫我看「減脂」最近 30 天在台灣的聲量趨勢，再找出讚數最高的 5 篇串文，整理它們的開頭寫法。

連線資訊

項目	值
網址	`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 積分（含詳細資料每篇 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 小時內的串文能否達到瀏覽數門檻	每篇 10 積分
`get_live_posts`	即時讀取串文目前的數字（不限發文時間）	每篇 3 積分（瀏覽數隱藏時 1 積分）
`get_live_users`	即時讀取帳號目前的粉絲數與資料	每個帳號 3 積分

帳戶

工具	用途	積分
`get_balance`	查詢剩餘積分	免費

與 REST API 的差異

筆數上限較小，讓回應保持精簡，例如 search_posts 最多 25 筆、semantic_search_posts 最多 10 筆。需要大量資料時請改用 REST API。
預設不含媒體網址與大頭貼網址。 需要時，在有提供這個參數的工具加上 include_media=true。
每次呼叫的逾時為 60 秒。
搜尋規則與 REST API 完全相同，請見搜尋規則。