# Throk API 與 MCP 更新紀錄

Throk API（`premium-api.throk.ai`）與 MCP 工具的更新紀錄，最新的在最上面。標示 **MCP** 的項目也適用於對應的 MCP 工具。

## 2026-09-23 · 1.9.1

- **修正**：熱門串文（`/post/hot`、MCP `get_hot_posts`）沒有結果時不再扣積分。
- **修正**：`/post/search` 回傳的 `total_pages` 改為無條件進位，最後一頁不足一頁時也會算進總頁數。
- **修正**：Webhook 事件現在會附上簽章：`X-Throk-Signature` 標頭帶有 `v1`，可以依 [驗證簽章](/api/webhooks/#驗證簽章) 的方式確認請求來自 Throk。之前送出的事件只有時間戳 `t`。
- **修正**：只設定瀏覽數門檻的熱門門檻 Webhook 規則，之前不會觸發，現在會正常送出；地區設定為 `tw` 或 `cn` 時也能使用。
- **說明**：Webhook 每送出一則事件扣 20 積分，以事件送出為準，不論接收端是否回應成功。

## 2026-09-22 · 1.9.0

- **新功能**：關鍵字趨勢（`/post/keyword-trend`、MCP `get_keyword_trend`）新增 `include_engagement` 參數，每天除了串文數，還會回傳這些串文的讚數、回覆數、轉發數與分享數加總。開啟時每個關鍵字每天 4 積分（原為 3 積分）；不開啟時回應與計費都和以前相同。
- **改進**：大量批次查詢帳號時，不再拖慢其他即時查詢。

## 2026-09-17 · 1.8.3

- **新功能**：`/post/search` 與 MCP `search_posts` 新增 `min_age_hours`、`max_age_hours`，可直接用「發文後幾小時」指定搜尋範圍（最長 90 天）。
- **改進**：`/post/{code}/chain` 會合併即時抓取的回覆，尚未收錄的串文也能查詢。
- **改進**：`/user` 與批次查詢帳號在資料不足時，會改用即時的帳號資料。

## 2026-09-17 · 1.8.2

- **改進**：`/live/posts` 回傳新增 `media_url` 與 `reshare_count`。MCP `get_live_posts` 一律回傳媒體網址。

## 2026-09-10 · 1.8.1

- **改進**：爆文預測（`/post/forecast`、MCP `forecast_posts`）改為發文 **1 小時**後即可預測（原為 2 小時），並更新了預測模型。發文 1–2 小時的串文現在也會計費。

## 2026-08-29 · 1.8.0

- **新功能**：`GET /live/posts`、`GET /live/users` 與 MCP `get_live_posts`、`get_live_users`，即時向 Threads 讀取串文與帳號**當下**的數字，不限發文時間、不限帳號。每篇串文或每個帳號 3 積分；Threads 隱藏瀏覽數時為 1 積分；讀取失敗不收費。

## 2026-08-25 · 1.7.1

- **改進**：`/user/{username}/top-threads` 查詢長時間範圍時大幅加快。
- **修正**：不再出現「回傳空結果卻扣了積分」的情況；後端暫時無法服務時會回傳 503。

## 2026-08-21 · 1.6.1 / 1.6.2

- **修正**：熱門串文、串文回覆鏈、語意搜尋、排行榜與帳號串文中的 `post_timestamp` 比實際早 8 小時的問題。
- **改進**：爆文預測接受以逗號分隔的多個串文代碼，錯誤訊息更清楚；不在預測時間範圍內的串文不收費。
- **修正**：Webhook 測試事件端點回傳 500 的問題。

## 2026-08-18 · 1.6.0

- **新功能**：`GET /post/forecast` 與 MCP `forecast_posts`（爆文預測）：回傳串文目前的瀏覽數，以及達到各瀏覽數門檻的機率與預估時間。每篇 10 積分。

## 2026-07-29 · 1.5.0

- **新功能**：新的地區值 `zh`、`tw`、`hk`、`cn`、`jp`、`kr`，適用於搜尋、熱門串文、關鍵字趨勢、排行榜與 Webhook。`tw` 與 `cn` 會分辨繁體與簡體。舊的 `chinese`、`japanese`、`korean` 仍可使用。詳見[地區與語言](/api/guides/regions/)。
- **改進**：語意搜尋的 REST API 單次最多可回傳 3000 篇；讚數與回覆數門檻在語意比對之後套用。
- **改進（MCP）**：每個工具的說明都會標示價格；天梯類工具可指定地區。

## 2026-07-26 · 1.4.0

- **新功能**：`GET /post/semantic-search` 與 MCP `semantic_search_posts`（語意搜尋）：用一句話描述主題，找出最近 30 天意思最接近的串文，每筆附相關度分數。前 10 篇 30 積分，之後每篇 2 積分。詳見[語意搜尋](/api/semantic-search/)。
- **新功能**：Webhook 規則可設定瀏覽數（`view_count`）門檻（07-23）。
- **新功能**：Webhook 規則可依語言或市場篩選（07-15）。
- **改進**：熱門串文、串文回覆鏈、含詳細資料的搜尋、帳號查詢與帳號熱門串文會回傳瀏覽數 `impression_count`（07-13）。
- **修正**：熱門串文依瀏覽數排序時，搭配香港或語言篩選的問題（07-15）。
- **改進（MCP）**：工具呼叫超過 60 秒會回傳說明訊息，不再卡住（07-11）。

## 2026-06-29

- **變更**：建立 Webhook 需要 API Standard 以上的方案。
- **變更**：Webhook 規則設有最低讚數與回覆數門檻。

## 2026-06-19 · 1.2.0

- **新功能**：搜尋、熱門串文與關鍵字趨勢新增 `language` 參數（`chinese`、`hk`、`japanese`、`korean`）。

## 2026-06-16 · 1.2.0

- **新功能**：REST 排行榜與數據端點：`/leaderboard/cool-replies`（神回覆）、`/leaderboard/post-like-growth`（爆紅串文）、`/leaderboard/follower-growth`（粉絲增長）、`/stats/follower-ladder`、`/stats/like-ladder`、`/stats/power-hours`，以及 `/post/inspiration`（靈感搜尋）。

## 2026-06-15 · 1.1.0

- **新功能（MCP）**：新增工具 `get_cool_replies`、`get_post_like_growth`、`get_follower_growth`、`get_follower_ladder`、`get_like_ladder`、`get_power_hours`、`get_inspiration`。

## 2026-06-10 · 1.0.0

- **新功能（MCP）**：推出 MCP 伺服器 `https://premium-api.throk.ai/mcp`，使用與 REST API 相同的金鑰與價格。首批工具：`search_posts`、`get_hot_posts`、`get_keyword_trend`、`get_user`、`get_user_top_threads`、`get_user_follower_history`、`get_balance`。設定方式請見[在 AI 助手中使用（MCP）](/api/mcp/)。

## 2026-05-19

- **新功能**：Webhook「熱門」規則：關鍵字可留空，回溯時間可設定 1–72 小時。