Citevana APIとMCPサーバー

REST API

レスポンスはすべてJSONです。成功時は "ok": true が含まれます。無料ツールは、わかりやすい要約と、重要度順で所要時間の目安付きのやることリストを返します。

リクエスト例

curl -s https://citevana.com/api/v1/tools/ai-crawlers \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

curl -s https://citevana.com/api/v1/sites \
  -H "Authorization: Bearer $CITEVANA_API_KEY"

エラー

エラーはすべて同じJSON形式です（下記参照）。エラーコードには invalid_request、invalid_url、blocked_host、fetch_failed、unauthorized、insufficient_scope、not_found、rate_limited、quota_exceeded などがあります。

{
  "ok": false,
  "error": {
    "code": "quota_exceeded",
    "message": "Daily api_calls quota reached."
  },
  "requestId": "req_…"
}

上限とヘッダー

カウント対象のレスポンスには X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset（Unix秒）が含まれ、その呼び出しがどの枠に計上されたかを示します。429レスポンスには Retry-After も含まれます。キーなしの呼び出しはインターネット回線ごとの無料ツール共有枠から、キー付きの呼び出しはワークスペースの1日あたりの api_calls 枠から差し引かれ、キーごとにさらに低い1日の上限も設定できます。サイトに到達できなかった場合やボット保護が代わりに応答した場合など、結果が返らなかった呼び出しは計上されません。

無料ツールのエンドポイントは、キーなしでどのサイトのブラウザからでも呼び出せます。キーが必要なエンドポイントはブラウザからのクロスオリジン要求を受け付けないため、サーバーから呼び出してください。

ツールのエンドポイントに ?locale=es、pt-BR、de、fr、ja、id、hi、tr、vi、ar を付けると、その言語で要約を受け取れます。

出典（2026年9月16日確認）: https://spec.openapis.org/oas/v3.1.1.html

MCPサーバー

リモートサーバーに対応したMCPクライアントを https://citevana.com/api/mcp に接続してください。Streamable HTTPトランスポートを使い、JSONで応答し、セッションは保持しません。

• check_ai_crawlers — サイトがどのAI検索・アシスタント・学習用クローラーを許可しているかを確認します。無料。
• audit_page — 1つのURLのオンページSEOとAI対応を監査します。無料。
• generate_llms_txt — サイト名、要約、リンクからllms.txtファイルを作成します。無料で、外部へのアクセスは行いません。
• get_site_audit_summary — 自分のサイトの最新の監査結果を返します。read:audits を持つAPIキーが必要です。

サーバーはプロトコルのリビジョン2026-07-28（リクエストごとのメタデータとserver/discover）に対応しています。リビジョン2025-11-25、2025-06-18、2025-03-26のinitializeハンドシェイクも受け付けます。

3つの無料ツールは認証なしで使え、キーなしの枠（1日3回、インターネット回線ごと）を共有します。get_site_audit_summary を使うには、クライアントがAPIキーを Authorization: Bearer ヘッダーで送信する必要があり、これにより1日の枠も広がります。Citevanaは現在、MCP向けのOAuthサインインを提供していません。

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_ai_crawlers",
    "arguments": {
      "url": "https://example.com"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

出典（2026年9月16日確認）: https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http

その他のMCPクライアントや自作エージェント

クライアントでリモートサーバー用のHTTPヘッダーを設定できる場合は、Authorization: Bearer の後にキーを指定すると get_site_audit_summary を使えます。キー付きの呼び出しはREST APIと同じ1日の api_calls 枠から、キーなしの呼び出しは無料ツールの共有枠から差し引かれます。

Chrome拡張機能

CitevanaのChrome拡張機能は、このAPIを使って、表示中のタブのAIクローラーチェックとページ監査を実行します。アカウントは不要でキーなしの枠を使い、任意のキーを設定するとその上限が広がり、自分のサイトの監査結果も表示できます。現在、Chrome Web Storeへの公開を準備中です。

要求する権限は activeTab と storage、およびCitevana APIへのアクセスのみです。ページのアドレスはチェックをクリックしたときだけ送信し、クエリ文字列は送信しません。

出典（2026年9月16日確認）: https://developer.chrome.com/docs/extensions/develop/concepts/activeTab

安全性とプライバシー

• すべてのツールは読み取り専用です。あなたのサイトを変更することはありません。
• 取得したページからコピーしたテキストは信頼できないデータとして明示されるため、AIアシスタントはその中の指示に従いません。
• 取得するのは公開ページのみで、CitevanaBotとしてアクセスします。プライベートや予約済みのネットワークアドレスはブロックします。
• 各APIキーはSHA-256ハッシュのみを保存します。キーは一度だけ表示され、いつでも無効化できます。キーの作成と無効化は監査ログに記録されます。

CitevanaBot

よくある質問

出典

• https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http
• https://modelcontextprotocol.io/specification/2026-07-28/basic/versioning
• https://developers.openai.com/apps-sdk/deploy/connect-chatgpt
• https://developers.openai.com/apps-sdk/build/auth
• https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
• https://spec.openapis.org/oas/v3.1.1.html
• https://developer.chrome.com/docs/extensions/develop/concepts/activeTab
• https://developer.chrome.com/docs/webstore/program-policies/policies