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可視性スコアを照会します。

パラメータ必須説明
domainstring照会するドメイン(例: 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キーを取得してください。

APIキーは Authorization ヘッダーで送信します:

Authorization: Bearer avi_xxxxxxxxxxxxxxxxxxxxxxxx

⚡ レート制限

プラン月間コール数バーストレート月額
匿名(キーなし)105/分無料
Free(登録済み)105/分無料
MCP Dev20020/分¥980
Starter10010/分¥2,980
Pro50050/分¥9,800
Enterprise2,000100/分¥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レート制限超過

より多くのデータが必要ですか?

MCP Devプラン(月額¥980)で200コール/月。AIエージェントビルダー向けのAPI特化プランです。

料金プランを見る →