linkrescue-mcp

LinkRescue MCP 服务

快速查找失效的联盟链接，按影响优先级排序，并生成 AI Agent 可执行的修复建议。

一次调用。检查 38+ 个联盟网络。捕获隐蔽的跟踪故障。

一键安装： 在 MCPize 上安装 | pip install linkrescue-mcp

LinkRescue MCP 通过模型上下文协议（MCP）提供失效链接扫描、监控和修复工作流，让 Claude 和 Cursor 等工具能够直接执行链接健康检查操作。

你将获得什么

• check_broken_links：扫描 URL（或站点地图）并返回结构化的失效链接报告
• monitor_links：为网站设置定期监控
• get_fix_suggestions：生成按优先级排序的修复建议
• health_check：验证 MCP 服务和后端 API 的连接情况

如果无法访问 LinkRescue 后端 API，工具会报错并指出无法访问的端点。它们绝不会返回编造的检查结果。用于本地测试时，设置 LINKRESCUE_DEMO_MODE=1 即可获取示例数据——每个模拟数据负载都会包含 "simulated": true 和明确的警告。

托管端点（无需安装）

LinkRescue 在 https://www.linkrescue.io/api/mcp 提供远程 MCP 服务（可流式传输的 HTTP）。 在 linkrescue.io/signup 获取免费 API 密钥，然后将任何 支持远程连接的 MCP 客户端指向该端点：

{
  "mcpServers": {
    "linkrescue": {
      "url": "https://www.linkrescue.io/api/mcp",
      "headers": { "Authorization": "Bearer lr_your_api_key" }
    }
  }
}

托管服务提供 check_links、start_site_scan、get_scan 和 get_fix_suggestions。 它绝不会返回模拟数据。下面的 stdio 包用于本地和离线场景。

快速开始

{
  "mcpServers": {
    "linkrescue": {
      "command": "linkrescue-mcp"
    }
  }
}

然后向你的 AI Agent 提问：

“扫描 example.com，查找失效的联盟链接”

免费版与 Pro 版

工具	免费版	Pro	Agency
health_check	是	是	是
check_broken_links（最多 50 个页面）	是	是	是
check_broken_links（最多 2,000 个页面）	-	是	是
check_broken_links（无限页面 + 站点地图爬取）	-	-	是
get_fix_suggestions	-	是	是
monitor_links（每日）	-	是	是
monitor_links（每小时 + Webhook）	-	-	是
多站点监控	-	5 个站点	25 个站点

免费版支持单页失效链接检查。Pro 解锁完整爬虫、修复建议和定期监控。Agency 则增加每小时检查、Webhook 和不限站点数量。

当前定价请见 linkrescue.io/pricing——该页面是唯一准确的信息来源。在 MCPize 上安装。

安装

MCPize（推荐）

一键安装并使用托管服务：在 MCPize 上安装

PyPI

pip install linkrescue-mcp
linkrescue-mcp

从源代码安装

git clone https://github.com/carsonroell-debug/linkrescue-mcp.git
cd linkrescue-mcp
pip install -r requirements.txt
python main.py

MCP 端点：

• http://localhost:8000/mcp

配置

变量	描述	默认值
LINKRESCUE_API_BASE_URL	LinkRescue API 的基础 URL	https://www.linkrescue.io/api/v1
LINKRESCUE_API_KEY	用于身份验证请求的 API 密钥	空
LINKRESCUE_DEMO_MODE	API 无法访问时返回带标签的示例数据，而不是报错。默认关闭——切勿在真实网站上启用。	空（关闭）

示例：

export LINKRESCUE_API_BASE_URL="https://www.linkrescue.io/api/v1"
export LINKRESCUE_API_KEY="your-api-key"
linkrescue-mcp

在 linkrescue.io/settings/api 获取 API 密钥（仅限 Pro 和 Agency 套餐）。

运行方式

通过已安装的入口点运行：

linkrescue-mcp

直接从源代码运行：

python main.py

通过 FastMCP CLI 运行：

fastmcp run main.py --transport streamable-http --port 8000

连接 MCP 客户端

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "linkrescue": {
      "command": "linkrescue-mcp"
    }
  }
}

Claude Code

claude mcp add linkrescue --transport http http://localhost:8000/mcp

试用

fastmcp list-tools main.py
fastmcp call-tool main.py health_check '{}'
fastmcp call-tool main.py check_broken_links '{"url":"https://example.com"}'

工具输入和输出

check_broken_links

输入：

• url（必填）：要扫描的网站 URL
• sitemap_url（可选，Agency 套餐）：从站点地图开始爬取
• max_depth（可选，默认值为 3）：爬取深度

返回扫描元数据、失效链接详情和汇总统计信息。可访问但已丢失跟踪参数的联盟链接会作为曝光量报告，即点击后无法产生收益的链接数量。LinkRescue 不会估算收入损失；请乘以你自己的 RPM。

monitor_links

输入：

• url（必填）
• frequency_hours（可选，默认值为 24；Agency 套餐支持 1）

返回监控 ID、计划详情和状态。免费套餐会返回模拟监控（不持久化）。

get_fix_suggestions

输入：

• check_broken_links 返回的完整报告，或
• 原始 broken_links 数组，或
• 上述任一格式的 JSON 字符串

返回按优先级排序的操作和建议的修复步骤。仅限 Pro 和 Agency 套餐。

health_check

无需输入。返回服务状态和后端 API 的可访问性。

部署

Smithery

此仓库包含 smithery.yaml 和 smithery.json。

1. 将仓库推送到 GitHub
2. 在 Smithery 中创建/添加服务
3. 将 Smithery 指向此仓库

Docker / 托管平台

此项目包含一个 Dockerfile，可用于 Railway、Fly.io 和其他容器托管平台。

# Railway
railway up

# Fly.io
fly launch
fly deploy

在托管环境中设置 LINKRESCUE_API_BASE_URL 和 LINKRESCUE_API_KEY。

架构

Agent (Claude, Cursor, etc.)
  -> MCP
LinkRescue MCP Server (this repo)
  -> HTTP API
LinkRescue Backend API (linkrescue.io)

此服务是 MCP 工具调用与 LinkRescue API 操作之间的转换层。

许可证

MIT — 由 Freedom Engineers 构建

相关项目

• SelfHeal MCP — MCP 服务的自愈代理
• SiteHealth MCP — 全面的网站健康审计
• LeadEnrich MCP — 阶梯式潜在客户信息丰富

其他 README 版本

• 面向开发者的版本：README.dev.md
• 面向市场平台的版本：README.marketplace.md