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 完全一致。

想跟踪网站、查看历史记录,并通过嵌入代码自动应用修复?创建账户——或先免费扫描一个应用。