MindThread API 5 分鐘上手教學
5 分鐘串接 MindThread API
更新於 2026-10-05：對齊 API 1.15.0，包含十項權限與本人確認、統一的 publish_at 排程欄位、MCP。完整規格以 OpenAPI 與 llms.txt 為準，給人看的文件在 開發者頁。
事前準備
- 註冊 MindThread，連結至少一個 Threads 帳號
- 到「設定 → API 金鑰」建立金鑰。正式金鑰是
mt_live_...，只會顯示一次，請立刻複製保存 - 想先試試看：建立
mt_test_...測試金鑰。寫入一律是模擬，回應帶test_mode: true、persisted: false，不會動到真的帳號
先懂權限：哪些動作要你本人確認
每把金鑰對十項權限各設「允許、詢問、拒絕」，GET /me 的 data.key.scopes 看得到。新的正式金鑰預設是 standard：
- 直接允許：讀取、產文與草稿、30 分鐘以後的排程、webhook
- 要你本人確認：立刻發文或 30 分鐘內的排程、送出雲端留言、開啟雲端留言、瀏覽器指令、連結帳號、放寬帳號規則
需要確認的動作會回 HTTP 403 approval_required，並附 human_url。把連結交給帳號擁有者本人，登入後在 https://mindthread.tw/approve/{id} 確認，伺服器就會代為執行。程式不要自己開連結，也不要重送同一個請求，改成輪詢 GET /approvals/{id}。
Step 1：查帳號
``bash`
curl https://mindthread.tw/api/v1/accounts \
-H "Authorization: Bearer mt_live_你的金鑰"
回應裡每個帳號的 id 就是之後要帶的 account_id，帳號名稱在 threads_username（含 @）。
Step 2：產文（不會發出）
`python
import requests
API_KEY = "mt_live_你的金鑰"
BASE = "https://mindthread.tw/api/v1"
H = {"Authorization": f"Bearer {API_KEY}"}
r = requests.post(f"{BASE}/content/generate", headers=H, json={
"account_id": "你的帳號 id",
"topic": "遠距工作的效率秘訣",
"formula": "auto",
"count": 1,
})
post = r.json()["data"]["contents"][0]
print(post["text"], post["formula_used"], post["char_count"])
`
帶了 account_id 就會套用那個帳號的人設，人設跟公式衝突時以人設為準。帳號有設內容規則（content_rules）的話，產出會照規則檢查。
Step 3：排程發文（30 分鐘以後，不用確認）
`python`
r = requests.post(f"{BASE}/content/publish", headers=H, json={
"account_id": "你的帳號 id",
"text": post["text"],
"publish_at": "2026-10-10T09:00:00+08:00",
})
print(r.json()["data"]["post"])
排程時間欄位統一叫 publish_at（ISO 8601，要帶時區）。舊的 schedule_at、scheduled_at 還能用，但不建議。排程貼文會在時間到後 5 分鐘內發出，要取消用 DELETE /schedules/{id}。
Step 4：立刻發文（要你本人確認）
把 publish_at 換成 "publish_now": true，或把時間設在 30 分鐘內，就算立刻發文。standard 金鑰會先回 approval_required，你確認後才會發出。
POST /content/generate-and-schedule不支援等待確認：要立刻發文，請先用/content/generate產文，再用/content/publish發出。
其他常用端點
`python`
requests.get(f"{BASE}/me", headers=H) # 方案、金鑰權限、剩餘額度
requests.get(f"{BASE}/schedules", headers=H) # 排程列表
requests.delete(f"{BASE}/schedules/{schedule_id}", headers=H) # 取消排程
requests.get(f"{BASE}/analytics/insights", headers=H, # 數據（account_id 必填）
params={"account_id": "你的帳號 id", "period": "30d"})
requests.post(f"{BASE}/keys/current/disable", headers=H) # 緊急停用這把金鑰（無法復原）
公式清單：GET /formulas。
額度
| 方案 | 每把正式金鑰每天可呼叫 |
|---|---|
| Free | 50 |
| Connect | 500 |
| Pro | 1,000 |
| Business | 5,000 |
另外每把金鑰每分鐘上限 120 次，每天台北時間 00:00 歸零。每個回應都帶 X-RateLimit-* 標頭；遇到 429 照 Retry-After 等，不要迴圈重試。
不寫程式：用 MCP 接 AI 助理
Claude、ChatGPT 這類 AI 助理可以直接接 MCP：POST https://mindthread.tw/api/mcp，帶同一把金鑰。tools/list` 會列出目前的工具（API 1.15.0 時是 39 個），工具跟 API 一一對應。