getAdvantage MCP

API & MCP ドキュメント

Advantageの3つのスキャンを、自分のコード、CI、またはAIエディタ内から実行できます。Get Foundは、AIがライブURLをどのように読むかを測定します。Convertは、初回訪問者がサインアップするかどうかを測定します。Ship Verifiedは、ページが本来公開すべきでないものを公開していないかをチェックします。すべての結果は、スキャン時点での観測値であり、判定、認証、保証ではありません。

APIはキーなしでもIP単位のレートで無料で試せます。APIキーを使用すると、レートがプランの階層に引き上げられ、有料プランではライブモデル出力が返されます。機械可読な仕様は/api/openapi.jsonにあります。

なぜ一度組み込むのか？ AEOを手動で維持する必要がなくなるからです。CIに埋め込みコードまたは1回のAPI呼び出しを追加するだけで、DOMセーフな修正（JSON-LD、meta、FAQ）が自動的に適用され続けます。ChatGPT、Perplexity、Gemini & Claudeがサイトの読み方を変えるたびに再チェックするため、ターゲットを追いかけずにスコアを最新に保てます。中立的なツールがAI可視性と公開安全性の両方を継続的に監視します。これは独立した監視であり、一度きりの監査ではありません。（llms.txtとrobots.txtは、一度配置するだけのファイルのままです。）

認証

/app/api-keysでキーを作成します（一度だけ表示されます。環境シークレットとして保存し、コミットしないでください）。任意のリクエストでBearerトークンとして送信します：

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com" \
  -H "Authorization: Bearer adv_live_…"

ヘッダーがない場合は、キーなしの無料ティア（IP単位のレート、サンプリング出力）が適用されます。キーがある場合、レートはプランに従い、有料プランではライブモデル出力が返されます。制限を超えるとHTTP 429とretry-afterヘッダーが返され、無効なキーは401を返します。

レート制限

制限はリクエスト時にキーごと（またはキーなしの場合はIPごと）に適用されます：

• キーなし： 5/分・30/日、サンプリング出力
• スターター： 60/分・1,000/日、ライブ出力
• プロ： 120/分・5,000/日、ライブ出力
• エージェンシー： 240/分・20,000/日（フェアユース）、ライブ出力

複合エンドポイントは、同じエンジンごとのレートで1ティックとしてカウントされます（1回の呼び出しで3回課金されることはありません）。

エンドポイント

GET /api/analyze?url=

Get Found — AI可読性スキャン（9シグナル）

9つのシグナル（タイトル、メタディスクリプション、構造化データ、見出し、llms.txt、コンテンツ対マークアップ比、Open Graph、canonical、robots）にわたって、ページがAIエンジンにとってどの程度読みやすいかをスコアリングします。シグナルごとの内訳、貼り付け可能な修正、生成されたスターターllms.txtを返します。

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com"

GET /api/verify-convert?url=

Convert — コンバージョン準備度 + 5秒コールドリード

初回訪問者がアプリを理解してサインアップするかどうかを左右するシグナルをスコアリングします。有料キーでは、エージェントによる5秒のファーストインプレッションテストも実行されます。チェック、修正、ベンチマーク百分位、共有可能な/vレポートを返します。

curl "https://getadvantage.app/api/verify-convert?url=https://yourapp.com"

GET /api/verify-safety?url=

Ship Verified — 公開安全性チェック + バッジ

一般的なvibe-codedな露出（クライアントバンドル内のシークレット、バックエンド設定、公開ファイル、セキュリティヘッダー、CORS、トランスポート、ソースマップ）に対する決定的なチェックを実行します。チェックが合格した場合、その特定の問題が見つからなかったことを意味します。アプリが安全または認証されていることを意味するものではありません。チェック、修正、ベンチマーク百分位、/vレポート、「Checked by Advantage」バッジを返します。

curl "https://getadvantage.app/api/verify-safety?url=https://yourapp.com"

POST /api/v1/scan/combined

Combined — 3つのエンジンを1回の呼び出しで

1つのURLに対して3つのエンジンすべてを実行し、1つのペイロードを返します：3つの独立したスコアブロック（決して平均化されません）、最も弱い次元と次の最大のアクションを特定する交差サマリー、そして1つのパーマリンク。1回のリクエストで全体像を把握する最速の方法です。

curl -X POST "https://getadvantage.app/api/v1/scan/combined" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer adv_live_…" \
  -d '{"url":"https://yourapp.com"}'

MCPサーバー — エディタ内からスキャン

AdvantageはModel Context Protocolサーバーでもあるため、Claude Code、Cursor、Claude Desktop、Windsurfに一度追加するだけで、*「getadvantageでアプリをスキャンして」*と入力するだけで済みます。リモートStreamable HTTP（現在の公式リモートトランスポート）に対応しており、インストール不要で、スキャンは当社のサーバー上で実行されます。4つのツールを公開しています：get_found、convert_check、ship_verified、combined_scan。各ツールはスコアと最大の貼り付け可能な修正から始まり、レポートリンクを含みます。

追加方法（Cursor / Claude Desktop / Claude Code）

これをMCPクライアント設定に追加します：

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp"
    }
  }
}

APIキーを使用する場合（より高いレート、ライブ出力）、ヘッダーを追加します：

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp",
      "headers": { "Authorization": "Bearer adv_live_…" }
    }
  }
}

または、Claude Codeでは1行で：

claude mcp add --transport http getadvantage https://getadvantage.app/api/mcp

MCPサーバーはキーなしでもキーレスレートで無料で試せます。キーを使用するとレートが上がり、ライブ出力が返されます。これはHTTP APIとまったく同じです。

サイトの追跡、履歴の確認、埋め込みによる修正の自動適用をご希望ですか？アカウントを作成するか、1つのアプリを無料でスキャンしてみてください。