getAdvantage MCP

官方

掃描 ChatGPT 和 Claude 如何讀取你的應用程式,查看它們提到誰而非你,並取得可直接貼上的修正方案(llms.txt、JSON-LD、FAQ、meta),以提升被發現的機會。

你可以用 getAdvantage MCP 做什麼?

  • 執行 AI 可讀性掃描 — 請你的助理對一個即時 URL 呼叫 get_found,以九個訊號評估該頁面對於 AI 引擎的可讀性分數,並提供可直接套用的修正建議。

  • 檢查轉換就緒度 — 使用 convert_check 衡量首次訪客是否會註冊,包括對付費方案進行 5 秒冷讀測試。

  • 驗證上線安全性 — 呼叫 ship_verified 執行常見暴露風險的確定性檢查,例如用戶端套件中的密鑰、安全性標頭,以及 CORS 問題。

  • 一次執行全部三種掃描 — 呼叫 combined_scan,在單一回應中取得 Get Found、Convert 與 Ship Verified 的結果,並附上交集摘要與永久連結。

文件

API 與 MCP 文件

從你自己的程式碼、CI 或 AI 編輯器內部執行三種 Advantage 掃描。Get Found 衡量 AI 如何讀取即時 URL。Convert 衡量首次造訪者是否會註冊。Ship Verified 檢查頁面是否發布了不應發布的內容。每個結果都是掃描當下的觀測數據——絕非裁決、認證或保證。

API 無需金鑰即可免費試用,採每 IP 速率限制。使用 API 金鑰 可將速率提升至你方案的等級,付費方案會回傳即時模型輸出。機器可讀的規格位於 /api/openapi.json。

為何只需整合一次? 這樣你就不用手動維護 AEO。將嵌入程式碼或一次 API 呼叫放入你的 CI,DOM 安全的修正(JSON-LD、meta、FAQ)就會持續自動套用;我們會隨著 ChatGPT、Perplexity、Gemini 與 Claude 改變讀取網站的方式而重新檢查,讓你的分數保持最新,無需你追著目標跑。一個中立工具持續監控 AI 可見度與發布安全性——獨立監督,而非一次性稽核。(你的 llms.txt 和 robots.txt 仍是只需放置一次的檔案。)

驗證

在 /app/api-keys 建立金鑰(僅顯示一次——請儲存為環境變數密鑰,切勿提交)。在任何請求中將其作為 Bearer token 傳送:

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 項訊號)

針對九項訊號(標題、meta 描述、結構化資料、標題、llms.txt、內容與標記比例、Open Graph、canonical、robots)評分頁面對 AI 引擎的可讀性。回傳各訊號的細項、可直接貼上的修正,以及一份產生的 starter 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 暴露的確定性檢查(用戶端 bundle 中的密鑰、後端設定、暴露的檔案、安全標頭、CORS、傳輸、source maps)。檢查通過表示我們未發現該特定問題——絕非應用程式安全或已認證。回傳檢查項目、修正、基準百分位、一份 /v 報告,以及「Checked by Advantage」徽章。

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

POST /api/v1/scan/combined

Combined — 三種引擎,一次呼叫

對單一 URL 執行全部三種引擎,並回傳單一 payload:三個獨立分數區塊(絕不平均)、一個交集摘要(指出最弱維度與單一最大的下一步行動),以及一個永久連結。這是透過單一請求取得全貌的最快方式。

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 完全相同。

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