BACKLNK

BACKLNK MCP 服务

为 AI Agent 提供免费的技术 SEO、AEO、LLMO 和 GEO 检查：检查页面、修复问题，然后验证修复结果。
每项发现均附带证据，并按重要性排序。远程 MCP 服务，提供免费 API 密钥。

获取免费 API 密钥 · 连接你的 Agent · 工具 · 检查项 · REST API

---

BACKLNK 是一个远程 Model Context Protocol 服务。它为 Claude Code、Cursor、 VS Code 和其他 MCP 客户端提供与 backlnk.com 相同的、基于证据的检查：元标签 和社交预览、页面结构、结构化数据、robots.txt 中的 AI 爬虫访问权限、重定向和标头、站点地图、 可索引性、hreflang、内部链接、重复内容、图片、llms.txt 和页面速度。

每项发现都附带证据（URL、准确摘录及其所在位置）和建议，并按重要性排序。你的 Agent 会修复代码；部署后，verify_fixes 会重新运行同一项检查，并告知你哪些问题已修复、哪些是新出现的、哪些仍未解决，以及哪些无法重新检查。

端点	https://backlnk.com/mcp（Streamable HTTP，无状态）
身份验证	免费 API 密钥：Authorization: Bearer bk_...（或 X-API-Key: bk_...）
价格	免费。每个密钥每 24 小时可进行 100 次检查，另有合理使用的每小时限额
官方 MCP 注册表	com.backlnk/backlnk
文档	backlnk.com/developers

此代码库包含文档、客户端配置示例和注册表条目。服务本身运行在 backlnk.com；无需安装任何内容。

获取密钥

1. 打开 backlnk.com/developers，然后输入你的电子邮箱地址。
2. 点击确认邮件中的链接，再点击打开页面上的按钮。
3. 系统会仅显示一次你的密钥（bk_...）。请复制并妥善保存。

之后申请新密钥会替换旧密钥。

连接你的 Agent

Claude Code

claude mcp add --transport http backlnk https://backlnk.com/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor

添加到 ~/.cursor/mcp.json（适用于所有项目）或 .cursor/mcp.json（适用于单个项目）。请参阅 examples/cursor-mcp.json。

{
  "mcpServers": {
    "backlnk": {
      "url": "https://backlnk.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

VS Code

添加到 .vscode/mcp.json。VS Code 会提示输入一次密钥并安全保存，因此可以将该文件提交到代码库。请参阅 examples/vscode-mcp.json。

{
  "inputs": [{ "type": "promptString", "id": "backlnk-api-key", "description": "BACKLNK API key", "password": true }],
  "servers": {
    "backlnk": {
      "type": "http",
      "url": "https://backlnk.com/mcp",
      "headers": { "Authorization": "Bearer ${input:backlnk-api-key}" }
    }
  }
}

其他客户端

任何支持通过 Streamable HTTP 连接远程服务的 MCP 客户端都可以使用：将其指向 https://backlnk.com/mcp，并在 Authorization 标头中发送密钥（Bearer bk_...）。如果客户端只能转发普通标头，也可以改用 X-API-Key: bk_...。

试用

向你的 Agent 提问：

使用 BACKLNK 检查 https://example.com/pricing。按重要性从高到低，修复它在此代码库中发现的问题。 部署完成后，验证这些修复。

流程：

1. **检查：**对页面的公开 URL 调用 run_checks。你会获得问题和警告，按重要性排序，每项都附带 证据和建议。
2. **修复：**Agent 会编辑你的模板、元数据、结构化数据或服务器配置。
3. **验证：**更改部署到该 URL 后，使用每个审核 ID 调用 verify_fixes。它会重新运行检查， 并比较结果：已修复、新出现、仍未解决、未重新检查。

只有重新检查评估了同一规则且未发现问题时，某项发现才会被视为已修复。如果重新检查无法进行评估，BACKLNK 会如实说明，而不会声称问题已修复。

工具

工具	功能	需要密钥
list_checks	列出所有检查项（ID、检查内容、范围和限制）。	是
run_checks	对一个公开 URL 运行检查，并等待最多约 40 秒。返回每项检查的状态、摘要、计数、需要修复的问题和警告，以及审计 ID。默认检查集：meta-tags、page-structure、ai-crawler-access、redirects-headers、entity-schema。	是
get_report	获取先前检查的精简报告。detail: "actions"（默认值）显示问题和警告，"all" 显示所有发现。	是
verify_fixes	使用相同的 URL 和选项重新运行检查，并返回与原始运行结果的对比。	是
ai_crawler_policy	根据 BACKLNK 审核过的爬虫列表，生成允许或屏蔽 AI 爬虫的 robots.txt 行，并说明每行的作用及相关警告。预设：block-training、block-ai、allow-all，也可按用途和爬虫分别决定。	是
usage	查看密钥今天和本小时已使用及剩余的检查次数。	是

列出工具（tools/list）无需密钥；调用工具则需要密钥。

参数

• run_checks：url（必需）、checks（检查项 ID，可选）、mode（Source、Rendered 或 Auto）、fresh （即使刚刚运行过相同的检查，也重新运行）。
• get_report：audit_id（必需）、detail（actions 或 all）。
• verify_fixes：audit_id（必需）。
• ai_crawler_policy：preset，或 purposes（按用途允许或屏蔽）和 crawlers（按令牌设置，例如 { "GPTBot": "allow" }）。

状态 NotAssessed 表示检查无法确定结果：这不代表通过。只有 Issue 和 Warning 类发现需要采取行动。

检查项

ID	检查项	范围
meta-tags	元数据和社交分享预览	一个页面及其分享图片。
page-structure	页面结构和可读性	一个页面。
entity-schema	Schema 和实体	一个页面；最多检查 15 个 sameAs 目标的可访问性。
ai-crawler-access	AI 爬虫访问权限	主机的 robots.txt，以及一个页面的 meta robots 和 X-Robots-Tag。
redirects-headers	重定向和响应头	你输入的 URL 及其 http:// 和 www / 非 www 变体。
image-seo	图片 SEO	一个页面；最多测量 60 个图片文件。
page-speed	页面速度	一个页面，进行两次实验室测试（移动端和桌面端）。
indexability	可索引性	一个网站上最多 50 个 URL，以及该网站的 robots.txt 和站点地图。
sitemap-hygiene	站点地图审计	最多 20 个站点地图文件和 50,000 个 URL；抽样检查最多 40 个目标。
internal-links	内部链接	同一主机，最多 40 个页面，深度为 4。
hreflang	Hreflang	同一网站中，通过 hreflang 替代项和链接访问的页面，最多 40 个。
duplicate-content	重复和单薄内容	同一网站，最多 40 个页面。
llms-txt-generate	llms.txt 草稿	最多读取 25 个页面。
llms-txt-validate	llms.txt 验证	最多检查 60 个已列出的链接。

实时列表始终可在 https://backlnk.com/api/v1/checks 查看。两项使用托管语言模型的网站检查（答案摘要、意图和重点）仅在 backlnk.com 上运行，不通过 API 或 MCP 服务运行。

REST API

无需 MCP 即可执行相同检查，适用于脚本和 CI。基础 URL：https://backlnk.com/api/v1。参见 examples/rest-api.sh。

# 1. Start a check (returns 202 with the audit id)
curl -X POST https://backlnk.com/api/v1/audits \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/","checks":["meta-tags","page-structure"]}'

# 2. Read the result (poll until "state" is Completed, Partial or Failed)
curl https://backlnk.com/api/v1/audits/AUDIT_ID -H "Authorization: Bearer YOUR_KEY"

# 3. After fixing the page: re-check and compare with the first run
curl -X POST https://backlnk.com/api/v1/audits/AUDIT_ID/verify -H "Authorization: Bearer YOUR_KEY"

方法	路径	是否需要密钥
GET	/checks	否	可运行的检查。
POST	/audits	是	对一个 URL 启动检查：{ "url", "checks": [ids], "mode"? , "options"? }。可选的 Idempotency-Key 标头可确保重试安全。
GET	/audits/{id}	是	状态、摘要、评分、覆盖范围和发现项，按重要性从高到低排列（仅查看问题和警告时使用 ?detail=actions）。
POST	/audits/{id}/verify	是	重新执行检查并与原结果进行比较。
GET	/audits/{id}/export?format=json|csv	是	完整报告（JSON）或发现项（CSV）。
GET	/usage	是	此密钥今日和本小时的用量。
POST	/ai-crawler-policy	否	根据预设或自选项生成适用于 AI 爬虫的 robots.txt 规则。

错误以 JSON 格式返回：{ "error": { "code", "message" } }，并附带相应的 HTTP 状态码：密钥缺失或已撤销时为 401，达到限制时为 429，并附带 Retry-After。

限制和公平使用

• 每个密钥在任意 24 小时内可执行 100 次检查；BACKLNK 复用近期完全相同的检查结果时不收费。
• 每个密钥设有公平使用的每小时限制，并对每个网站设有限制，以避免过度抓取。
• BACKLNK 仅检查公开页面。私有、本地和内部地址均会被拒绝。
• GET /api/v1/usage 和 usage 工具会显示剩余额度。

隐私

BACKLNK 会将你的电子邮件地址与密钥关联保存，并会在你提出请求时删除 （联系）。报告仅对执行检查的密钥可见，绝不会公开发布或编入索引。

支持

如有问题、错误反馈或想法：提交 issue，或通过 backlnk.com/contact 联系我们。

许可证

本仓库中的文档和示例采用 MIT License。BACKLNK 服务可在其限制范围内免费使用。