getAdvantage MCP Server
官方扫描ChatGPT和Claude如何读取你的应用,查看它们会提到谁而不是你,并获取可直接粘贴的修复方案(llms.txt、JSON-LD、FAQ、meta),从而让你的应用被找到。
文档
认证
在 /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次/天,采样输出
- 入门版: 60次/分钟 · 1,000次/天,实时输出
- 专业版: 120次/分钟 · 5,000次/天,实时输出
- 代理版: 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 也是一个模型上下文协议服务器,因此你可以将其一次性添加到 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