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

Throk 提供 [MCP（Model Context Protocol）](https://modelcontextprotocol.io) 伺服器。設定好之後，你可以直接用自然語言請 AI 助手查資料，例如：

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

## 連線資訊

| 項目 | 值 |
| --- | --- |
| 網址 | `https://premium-api.throk.ai/mcp` |
| 傳輸方式 | Streamable HTTP |
| 認證 | 標頭 `Authorization: Bearer sk-throk-...`（與 REST API 使用同一把金鑰） |

## 安裝

開發者平台的 [**MCP 伺服器**](https://developer.throk.ai/dashboard/mcp) 頁面也有各個 AI 工具的設定範例，可以直接複製。

### Claude Code

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

### Claude Desktop

在設定檔的 `mcpServers` 加入：

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

### Cursor

在 `.cursor/mcp.json` 加入相同的設定：

```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 完全相同，請見[搜尋規則](/api/guides/search-rules/)。