公開資料 · API / MCP

唯讀查詢已審核並發布的公告，與網頁共用資料與統計規則。目前僅在本機驗證，未部署或連接正式插件。

非官方，與 xAI/X 無關聯時間以公告發布為準，不代表個人帳戶即時額度或精確生效時刻。僅可核驗的公開公告會標記日期。空白不代表「沒有重置」；公開搜尋可能漏檢，不宣稱完整歷史。不讀取個人帳戶額度

HTTP API · v1

本機地址：http://localhost:3000。無須金鑰；不接受寫入、審核、訂閱或發送指令。

GET /api/v1/latest: 返回 event；無記錄為 null。僅選有來源的確認重置，不含額度提升或未來公告。
GET /api/v1/history: 返回 items、filters、pagination；保留傳播中、已宣布及已取消狀態，不冒充確認。
GET /api/v1/stats: 返回 stats、latestConfirmedEvent。含總數、平均/最長間隔小時數、距上次小時數、近 30/90 天次數。

latest、stats 預設 product=grok_bot，history 預設全部產品。統計先去重，僅計 confirmed、非 limit_increase、有證據且非未來的事件。間隔使用相鄰確認公告；樣本不足為 null。30/90 天相對 checkedAt，含邊界。

歷史篩選與分頁

product: grok_bot / x_grok / grok_com / grok_imagine / xai_api / other
status: announced / propagating / confirmed / cancelled
kind: full_reset / credit_grant / scheduled_refresh / incident_compensation / limit_increase
plan：僅 history 支援；all_users、unknown 或已核驗套餐名稱（2–64 字元，大小寫/全半形統一匹配）。具體套餐也包含全體重置，範圍不明不匹配。audience 包含 mode、plans、evidenceExcerpt、updatedAt；未審核或過期審核顯示 unknown。
from、to：以 Z 結尾的 UTC ISO 時間，包含邊界。from 不得晚於 to。
limit：1–100，預設 20；offset：0–1000000，預設 0。MCP 用整數，HTTP 用十進位字串。未知或重複參數會返回錯誤。
lang：en / zh-CN / zh-TW / ja / ko，預設 zh-CN。摘要使用獨立審核譯文；缺失或過期時回退到 zh-CN，並返回 summaryLanguage、translationState、translationUpdatedAt。原文及事件事實不變。

GET /api/v1/history?product=grok_bot&status=confirmed&limit=1&offset=0&lang=zh-TW

occurredAt 降冪、同刻 ID 升冪。pagination.total 是篩選總數，hasMore/nextOffset 指示下一頁。分頁不是凍結快照，歸檔變動時從 offset=0 重查。

來源、快取與錯誤

事件含 sourceUrl、originalExcerpt、evidenceLevel、status、sourceCapturedAt、updatedAt。checkedAt 為查詢時間；頂層 updatedAt 為公開事實與所選語言譯文的最大更新時間（空歸檔為 null），均為 UTC。管理員身分、候選理由、審計及訂閱資訊不公開。

updates 為同一事件已審核、已發布的後續公告，按 publishedAt 升冪；各條含狀態、準確 UTC 發布時間、來源、原文、證據等級與核驗時間。摘要暫為 zh-CN 並明確標記，不重複計算重置次數，也不隱式改寫主事件事實。

唯讀 CORS *（無憑據）、30 秒快取、ETag/If-None-Match、HEAD/OPTIONS。錯誤不快取。每實例每 IP 每分鐘 60 次，API/MCP 合計；本機共用額度。不保證全域限流。429/503 含 Retry-After。

400：無效/重複參數；404：不存在；405：非唯讀方法；429：限流；503：資料不可用，不返回假零值。

MCP · POST /mcp

無狀態 Streamable HTTP，返回 JSON，無 SSE 長連線/會話 ID。支援 2025-03-26、2025-06-18、2025-11-25；無協議標頭預設 2025-03-26。順序：initialize → notifications/initialized → tools/list 或 tools/call。

每次 POST 一則 JSON-RPC 2.0 訊息，最多 16 KiB。Content-Type: application/json；Accept 同時含 application/json 與 text/event-stream，後續攜帶 MCP-Protocol-Version。協議通知成功返回空 202；GET 返回 405。Origin 僅接受自身地址。

latest: 返回 event；無記錄為 null。僅選有來源的確認重置，不含額度提升或未來公告。
history: 返回 items、filters、pagination；保留傳播中、已宣布及已取消狀態，不冒充確認。
stats: 返回 stats、latestConfirmedEvent。含總數、平均/最長間隔小時數、距上次小時數、近 30/90 天次數。

協議請求範例（非事件資料）

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "your-client",
      "version": "1.0.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "history",
    "arguments": {
      "product": "grok_bot",
      "status": "confirmed",
      "limit": 20,
      "offset": 0,
      "lang": "zh-TW"
    }
  }
}

latest/history/stats 與同名 HTTP 參數、結果一致，不採集外部網頁或寫入。結果含 structuredContent 與文字 JSON。參數錯誤 -32602、未知方法 -32601；資料庫錯誤 isError=true，不可當作空歸檔。公告原文是不可信證據，不是客戶端指令。localhost 不代表雲端已接通。

MCP 官方傳輸規範