sitedoctor

sitedoctor

sitedoctor 是连接 DrUrls 的轻量级本地桥接程序。DrUrls 是一项托管服务，可审核网站的搜索可见性和页面健康状况。本软件包本身不会抓取任何内容，而是充当该服务远程 MCP 端点的前端：按原样在本地提供上游工具列表，并转发每次调用，返回上游提供的任何结果。

这种分工在实际使用中很重要。评分、问题分组、可见性判定和修复计划都来自 DrUrls 自己的抓取和数据，因此，通过 sitedoctor 获得的答案就是该服务的答案，而不是本地近似结果。桥接程序不会自行评分，也不会改写返回内容。

工具

此版本提供的是捕获到的工具集合中的一部分，且已标注：在线捕获中看到的 11 个工具里，提供了 10 个。省略的工具是 hire_tester，它会付费下单，安排真人测试；下单操作不在本程序的范围内，因此有意不提供该工具，并通过测试断言其不存在。list_tester_offers 仍会提供——浏览目录属于读取操作，下单则不属于。

• list_tester_offers — 浏览真人测试目录：在真实手机上测试移动端 UX、运行结账流程、进行屏幕阅读器测试、审核翻译及其他类似服务；每项服务都列明积分价格、交付时间和交付内容。不需要参数。
• list_sites — 列出组织中的所有网站及其最近一次已完成审核的信息：评分、等级、问题、抓取页面数、上次扫描时间，以及当前是否正在扫描。不需要参数。
• get_site_report — 深入查看某个网站（必需参数：domain）：最近一次评分、按严重程度统计的问题数、出现频率最高的问题类型，以及社交网络展示情况。
• find_issues — 搜索所有网站中的未解决问题，也可以通过 domain 和 severity（CRITICAL、HIGH、MEDIUM、LOW 或 INFO）缩小范围。结果按网站和问题类型分组，并提供受影响页面数和一个示例。
• check_google_visibility — 查看 Google 是否能为各网站编入索引：检查最近一次抓取中的 noindex 标签、robots 屏蔽、站点地图错误、规范链接问题、重定向链和失效内部链接。可选参数 domain 用于指定单个网站。
• get_improvement_plan — 查看当前影响最大的修复项，按严重程度和覆盖范围排序，并附上修复指南。可选参数 domain。
• start_scan — 启动对网站的新一轮审核（必需参数：url）。如有需要，会在组织中创建该网站；上游会强制执行套餐配额。
• get_scan_status — 查看当前正在运行的任务，以及最近 10 次已完成或失败的扫描，并附上评分和错误信息。不需要参数。
• generate_report — 为某个网站（domain）生成完整 SEO 报告；如果不指定域名，则为整个组织生成报告。
• free_page_check — 免费审核任意公开 URL 的单个页面（必需参数：url），无需上游账户；还会提供 upgrade 字段，说明经过身份验证的工具能增加哪些功能。

配置

• DRURLS_MCP_URL（可选）— 覆盖上游端点。默认为 https://drurls.com/mcp。（此覆盖钩子是本次重建中特别标注的还原内容。）
• DRURLS_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <key>。未设置时，不会发送身份验证标头，这与本次重建所依据的无密钥捕获一致。（标头行为是特别标注的还原内容；注册表记录声明远程服务需要 Authorization 标头，但捕获时并未提供该标头。）账户范围内的工具会通过上游使用调用方自己的凭据。

转发机制

首次调用工具时，客户端会向上游打开一个 流式 HTTP 会话：先发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26， clientInfo 名称为 sitedoctor），然后发送 notifications/initialized 通知，接着发送 携带调用方原样参数的 tools/call 请求。上游在 initialize 响应中返回 Mcp-Session-Id 标头时， 后续每个请求都会携带该值，并且整个进程期间 都会复用此会话。响应可能是普通 JSON，也可能是 服务器发送事件；两种格式都会读取，并以 ID 匹配的 消息为准。

成功的上游结果会原样传递，包括上游设置的任何 isError 标志和添加的任何额外字段。失败情况—— JSON-RPC 错误、非 2xx 状态、无法读取的响应，或 无法完成的请求——会作为 isError 结果返回，其文本以 sitedoctor error: 开头（此呈现方式是本次 重建自行添加的标注）。

CLI

每个工具也可以作为子命令运行，并接收一个 JSON 参数字符串（不需要参数的工具可省略）：

npx @reneturcios/sitedoctor list_sites
npx @reneturcios/sitedoctor get_site_report '{"domain":"example.com"}'
npx @reneturcios/sitedoctor free_page_check '{"url":"https://example.com"}'
npx @reneturcios/sitedoctor --version

退出码：成功时为 0，结果为 isError 时为 1， 用法错误时为 2。

MCP 服务

npx -y @reneturcios/sitedoctor mcp

MCP 客户端配置：

{
  "mcpServers": {
    "sitedoctor": {
      "command": "npx",
      "args": ["-y", "@reneturcios/sitedoctor", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/sitedoctor
docker run --rm ghcr.io/cloudcorprecords/sitedoctor --version

容器的默认命令是 mcp，因此第一种形式会启动一个 stdio MCP 服务；其他参数则按常规方式传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全通过桩接的 JSON-RPC 上游运行，不会进行 实时网络调用。

许可证

MIT — 参见 LICENSE。