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 次（合理使用），即時輸出

合併端點以相同的每個引擎速率計為一次（絕不會對單次呼叫收取三次費用）。

端點

GET/api/analyze?url=

Get Found — AI 可讀性掃描（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 — 三個引擎，一次呼叫

對一個 URL 執行全部三個引擎，並回傳一個酬載：三個獨立的分數區塊（絕不平均）、一個交集摘要，指出最弱的維度及最重要的下一步行動，以及一個永久連結。在單一請求中獲取完整圖像的最快方式。

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。每個工具都會先顯示分數和最重要的可立即貼上修正建議，並包含報告連結。

新增方式（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 中，使用一行指令：

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

MCP 伺服器可在無金鑰的情況下以免費層級試用；使用金鑰可提高速率並回傳即時輸出，與 HTTP API 完全相同。

想要追蹤網站、查看歷史記錄，並透過嵌入自動套用修正？建立帳戶 — 或先免費掃描一個應用程式。

詢問 Ray