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 令牌发送:
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 引擎的可读性。返回逐信号细分、可直接粘贴的修复建议,以及生成的 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 完全一致。