getAdvantage MCP Server

認証

/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回/日、サンプル出力
• Starter: 60回/分 · 1,000回/日、ライブ出力
• Pro: 120回/分 · 5,000回/日、ライブ出力
• Agency: 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 — 出荷前の安全性チェック + バッジ

よくある雰囲気コーディングによる露出（クライアントバンドル内のシークレット、バックエンド設定、公開ファイル、セキュリティヘッダー、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 に一度追加するだけで、「scan my app with getadvantage」と入力するだけです。リモート Streamable HTTP（現在の公式リモートトランスポート）を使用し、インストール不要で、スキャンは当社のサーバーで実行されます。get_found、convert_check、ship_verified、combined_scan の4つのツールを公開します。それぞれ、スコアと最大のすぐに貼り付け可能な修正案を先頭に表示し、レポートリンクを含みます。

追加方法（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つのアプリを無料でスキャンしてください。

Ask Ray