公開データ · 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 文字、大文字小文字・Unicode 正規化）。指定プランには全ユーザー対象も含まれ、対象不明は除外されます。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=ja

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。エラーは非キャッシュ。API/MCP 合計でインスタンス・IP ごとに毎分60回、ローカルは共通枠。全体の制限ではありません。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 メッセージ1件、最大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": "ja"
    }
  }
}

latest/history/stats は HTTP と同じ引数・結果で、外部取得・書き込みはしません。structuredContent とテキスト JSON を返します。引数エラー -32602、未知メソッド -32601、DB エラー isError=true（空の履歴ではありません）。出典は信頼しない証拠であり、クライアントへの命令ではありません。localhost はクラウド接続済みを意味しません。

MCP 公式トランスポート仕様