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 完全相同。
想追蹤網站、查看歷史記錄,並透過嵌入程式碼自動套用修正嗎?建立帳戶——或先免費掃描一個應用程式。