ドキュメント
MCP Server ドキュメント
AI Visibility Indexは MCP (Model Context Protocol) に対応しています。Claude Desktop、Cursor、その他MCP対応AIエージェントから、日本EC企業104社のAI可視性ランキングデータに直接アクセスできます。
無料 匿名アクセスで月10回まで利用可能。APIキー登録不要。
🚀 クイックスタート
Claude Desktop
Claude Desktopの設定ファイル claude_desktop_config.json に以下を追加:
{
"mcpServers": {
"ai-visibility-index": {
"url": "https://ai-visibility-index.dev/mcp"
}
}
}
Cursor / その他のMCPクライアント
エンドポイントURLを指定するだけで接続できます:
https://ai-visibility-index.dev/mcp
プロトコル: Streamable HTTP(JSON-RPC 2.0 over HTTP POST)
🔧 利用可能なツール
1. check_ai_visibility
特定ドメインのAI可視性スコアを照会します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
domain | string | ✓ | 照会するドメイン(例: zozo.jp) |
レスポンス例(ヒット時):
{
"company": "ZOZOTOWN",
"domain": "zozo.jp",
"overallScore": 72.5,
"rank": 3,
"totalCompanies": 104,
"engines": {
"chatgpt": 85.0,
"claude": 70.0,
"gemini": 65.0,
"perplexity": 70.0
},
"_links": {
"fullReport": "https://ai-visibility-index.dev/tools/?domain=zozo.jp",
"industryRanking": "https://ai-visibility-index.dev/ranking/fashion/",
"pricing": "https://ai-visibility-index.dev/pricing/"
}
}
2. list_ai_visibility_industries
9業界のAI可視性サマリーを一覧で返します。パラメータ不要。
3. get_ai_visibility_methodology
スコアリング方法論(計算式・対象エンジン・クエリ種別・データ更新頻度)を返します。パラメータ不要。
🔐 認証
匿名アクセス(APIキーなし)で月10回まで利用できます。より多くのリクエストが必要な場合は、料金プランからAPIキーを取得してください。
Chrome拡張APIキーは Authorization ヘッダーで送信します:
Authorization: Bearer avi_xxxxxxxxxxxxxxxxxxxxxxxx
⚡ レート制限
| プラン | 月間コール数 | バーストレート | 月額 |
|---|---|---|---|
| 匿名(キーなし) | 10 | 5/分 | 無料 |
| Free(登録済み) | 10 | 5/分 | 無料 |
| MCP Dev | 200 | 20/分 | ¥980 |
| Starter | 100 | 10/分 | ¥2,980 |
| Pro | 500 | 50/分 | ¥9,800 |
| Enterprise | 2,000 | 100/分 | ¥29,800 |
制限超過時は 429 Too Many Requests が返ります。
🔍 サーバーディスカバリ
MCP Discovery Protocolに対応しています:
GET https://ai-visibility-index.dev/.well-known/mcp.json
❌ エラーレスポンス
| コード | 意味 |
|---|---|
-32600 | 不正なリクエスト(JSON-RPC仕様違反) |
-32601 | 未知のメソッド |
-32602 | 不正なパラメータ |
-32000 | 認証エラー(無効なAPIキー) |
-32001 | レート制限超過 |
💰 カウント対象
以下の操作は月間コール数にカウントされません:
| 操作 | カウント |
|---|---|
initialize | 対象外 |
tools/list | 対象外 |
ping | 対象外 |
GET /mcp | 対象外 |
get_ai_visibility_methodology | 対象外 |
check_ai_visibility | カウント対象 |
list_ai_visibility_industries | カウント対象 |
接続テストやメタデータ取得で枠を消費しないので、安心して試せます。
📋 データの利用条件
MCP API経由で取得したデータの利用には以下の条件が適用されます:
| 項目 | 条件 |
|---|---|
| 出典表記 | 必須: AI Visibility Index by Pulse Digital |
| APIキー共有 | 禁止 |
| バルク取得・再販 | 禁止 |
| AIモデル訓練・RAGデータセット化 | 禁止(個別許諾で可能) |
| 自社サービスへの組み込み | 有料プランまたは個別契約で許可 |
詳細は利用規約 第9条・第11条・第12条をご確認ください。