AI Website Auditor

Website Auditor MCP

一个用于 website-auditor.io 的 MCP 服务 — 提供 AI 可见度（GEO）和网站审计工具，可通过任何 MCP 客户端调用 （Claude Desktop、Claude Code、Cursor、Codex 和其他 Agent）。

向 Agent 提问 “ChatGPT 会推荐我的业务吗？”、“我的 AI 可见度 评分是多少？”、“审计 example.com” 或 “我和竞争对手相比表现如何？” 它就会用真实数据作答 — 包括 AI 可见度总评分（0–100）、按引擎细分的 数据（涵盖 ChatGPT、Perplexity、Claude 和 Gemini）、完整的网站审计（安全性、性能、可抓取性和标记）、竞争对手对比，以及持续监控。

该服务是 Website Auditor API 之上的轻量级认证封装 — 审计引擎、AI 可见度评分和监控功能都由该服务提供；此服务仅负责让 Agent 能够使用这些功能。

---

工具

工具	等级	功能
get_sample_audit	免费 — 无需密钥	提供一份完整的 example.com 示例报告，其格式与真实审计返回的报告完全一致。无需 API 密钥、订阅或网络连接。请先试用，看看你将购买的内容。
get_ai_visibility	Pro	当前 AI 可见度评分（0–100）+ 各引擎明细（ChatGPT、Perplexity、Claude、Gemini）+ 取代你出现的头号竞争对手。Pro 订阅用户还可获取 trend：根据存储的快照历史，显示该审计所询问问题的 7 天和 30 天评分变化；以该问题对应的快照为结束点，仅比较提出过该问题的测量快照；整体变化则仅比较由相同引擎作答的端点（如果窗口内各引擎不同，则会包含各引擎的变化，并在 overall_note 中说明每个引擎在哪个端点作答；如果审计未存储测量快照，则返回 null 并附带说明）。
run_audit	Pro，受速率限制	执行一次完整审计 → 类别评分（AI 可见度、可抓取性和标记为 seo 的结构化数据、安全性、性能）+ 主要问题 + 可分享的报告 URL。
get_changes	Pro	AI 可见度评分的变化——整体评分变化，以及在两次测量中都有评分的各引擎评分变化；只有相同引擎在两个快照中都作答时才显示整体变化（否则为 null，并在 overall_note 中列出各自作答的引擎，各引擎的变化则单独显示）；competitor_changes、new_issues 和 resolved_issues 始终为空。仅比较提出相同问题（相同的业务名称、市场和查询）的两个快照；数据来自该域名的序列：已测量的每周重新审计，以及提出了与最新记录相同问题的任何审计；前提是从最新一次记录了该问题的每周重新审计开始，至序列中每个后续快照（包括每周重新审计，无论是否记录），再到最新测量快照之间的间隔不超过四周零一天。如果没有符合条件的快照对，则会说明原因；如果序列已重新建立基线，也会显示日期。无需跟踪该域名：无论是否跟踪，对该域名的任何审计都会累积历史记录；track_site 会将每周重新审计加入序列，而非使用 get_changes 的前提。
compare_competitors	Pro	与指定竞争对手域名进行 AI 可见度排名正面对比，并指出每个竞争对手出现而你未出现的位置。会考虑配额：将审计扇出限制在你当天剩余的配额内，重复使用近期缓存的审计，并报告不得不跳过的竞争对手，不会悄悄将其省略。
track_site	Pro	开始（或停止）每周监控某个网站的 AI 可见度。该网站的每周重新审计会加入 get_changes 读取的历史记录；无论是否跟踪，审计都会累积历史记录——监控是为了观察网站，并不会启用 get_changes。
untrack_site	Pro	停止监控某个网站并释放一个监控名额。删除该网站的监控登记；保留过去的审计记录。
list_tracked_sites	Pro	列出你正在监控的网站，以及其频率、活跃状态和已用/剩余名额。
get_monitoring_status	Pro	一览所有已跟踪网站的仪表板——每个网站序列（get_changes 读取的序列）的最新评分、每个网站上次计划运行的日期和下次运行时间，以及最近一次同类变化（或说明，或摘要，指出没有变化的原因）；变化按各引擎分别显示，并在两个快照由不同引擎作答时附注列出引擎。与 get_changes 一样，其 change 中的 competitor_changes、new_issues 和 resolved_issues 始终为空。
check_upgrade_status	任意有效密钥	查看你自己的订阅状态——等级、状态、周期结束时间，以及升级后可解锁的内容（开始使用 Pro 需要提供付款方式并接受条款）。不消耗审计配额。

提示词

支持 MCP 提示词的客户端（Claude Desktop、claude.ai）会将它们显示为菜单中的可选项，因此你无需自己组织请求，也不必知道该询问哪个工具。对于不显示提示词的客户端（目前包括 Codex），你不会失去任何功能，只是没有菜单而已——用文字提出请求，同样会运行这些工具。

提示词	需要密钥？	功能说明
查看示例报告	否	演示 example.com 的完整报告。无需参数或设置——任何安装都可一键查看。
检查我的 AI 可见度	Pro	针对你指定的域名运行 get_ai_visibility，然后解释评分、哪些助手会提到该企业，以及哪些企业取而代之。
运行完整的网站审计	Pro	针对某个域名运行 run_audit，按类别汇总结果，并列出最重要的三项修复建议。
将我与竞争对手进行比较	Pro	针对你的域名和指定的竞争对手运行 compare_competitors，并说明对方在哪些情况下会被提及，而你不会。

未配置 API 密钥时，每个 Pro 提示词都会回退到 get_sample_audit，因此你始终能得到输出，而不是错误。

指定企业名称（可选）

get_ai_visibility 和 run_audit 都接受两个可选参数，用来决定 AI 可见度检查实际会询问什么问题。 compare_competitors 仅接受 business_location——下文会说明它为何不接受名称：

参数	省略时	提供时
business_name	从网站中检测；如果无法验证，则会通过 name_warning 标记	作为事实接受，并记录为由调用方提供——这会抑制警告
business_location	从网站中检测；如果没有找到任何信息，问题范围会扩大到国家/地区，或完全不指定地点	将问题范围限定在该地点

只有在你确实知道名称时才提供。 提供的名称会覆盖检测结果，并被视为已确认，因此猜测出的名称会像经过人工核实一样参与评分，也会让原本会提醒你的警告不再出现。省略名称是更稳妥的默认做法：检测过程会如实说明自身的不确定性。

地点参数的情况正好相反。对于全国性或全球性企业，省略地点是正确的；对于本地企业，省略地点则是错误的，因为不指定地点进行测量，会导致评估使用错误的查询。

关于 compare_competitors： 它接受 business_location，并将该地点应用于你的网站和每一家竞争对手，因为比较针对的是同一个市场——如果按本地范围为你评分，却按全球范围为竞争对手评分，得出的答案就对应两个不同的问题。它有意不接受 business_name：名称用于标识一家企业，而将你的名称传递给竞争对手，会导致系统把每一家竞争对手都当成你来评分。结果会注明所用市场，因此限定范围的比较不会被误认为是全球比较。

"Check AI visibility for hawaiibackroad.com,
 the business is Big Island Backroad Adventures in Hilo, HI"

---

安装和配置

服务器可直接通过 npx 运行——无需克隆或构建。

先试用，再决定是否购买。 无需 API 密钥即可安装，并让 Agent 执行一次示例审计——get_sample_audit 会以真实运行完全相同的格式，返回 example.com 的完整报告，让你先确认格式是否符合需求。

定价。 审计真实域名需要订阅 Website Auditor，费用为 $49/月——符合条件的新客户可享受 7 天免费试用（开始试用需要提供付款方式；试用结束前不会扣费；过去 12 个月内用过试用的客户将立即付费）。注册并在 api.website-auditor.io/admin_portal 创建 API 密钥，然后将其设为下方的 WA_API_KEY。没有免费的 API 方案——密钥只有在订阅有效时才能使用。

Claude Desktop（claude_desktop_config.json）、Cursor （~/.cursor/mcp.json）和大多数其他客户端使用相同的 mcpServers 结构：

{
  "mcpServers": {
    "website-auditor": {
      "command": "npx",
      "args": ["-y", "website-auditor-mcp"],
      "env": {
        "WA_API_KEY": "wa_your_key_here"
      }
    }
  }
}

Claude Code——通过命令行添加：

claude mcp add website-auditor -e WA_API_KEY=wa_your_key_here -- npx -y website-auditor-mcp

Codex——命令行、IDE 扩展和 ChatGPT 桌面应用都读取同一个 ~/.codex/config.toml，因此任选一种配置即可适用于三者：

codex mcp add website-auditor --env WA_API_KEY=wa_your_key_here -- npx -y website-auditor-mcp

[mcp_servers.website-auditor]
command = "npx"
args = ["-y", "website-auditor-mcp"]

[mcp_servers.website-auditor.env]
WA_API_KEY = "wa_your_key_here"

Codex 不会呈现 MCP 提示词，因此上方的提示词不会显示为菜单项——请直接用文字提出请求（“给我看看示例审计”）。

或者安装打包好的 Codex 插件，它包含相同的服务器，并将提示词作为技能提供（Codex 可以呈现这些技能）：

codex plugin marketplace add SpikeyCoder/website-auditor-mcp
codex plugin add website-auditor@spikeycoder

Cursor——一键安装，或将与上文相同的 mcpServers JSON 放入 ~/.cursor/mcp.json：

一键配置中的 WA_API_KEY 为空——示例报告可直接使用；如需审计真实域名，请在 Settings → MCP 中填写密钥。另有打包好的 Cursor 插件（此服务器以及作为技能提供的提示词），位于 cursor-plugin/；它在 Cursor Marketplace 上的上架申请尚待处理——状态请见 docs/CURSOR-PLUGIN.md。

重启客户端后，工具就会显示出来。

获取 API 密钥

WA_API_KEY 是每位用户专属的密钥（以 wa_ 开头），可在 Website Auditor 账户中生成，网址为 api.website-auditor.io/admin_portal ——这是用于订阅和管理密钥的管理门户。

生成密钥需要有效订阅（$49/月；符合条件的新客户可享受 7 天免费试用——需要提供付款方式，试用结束前不会扣费）：没有免费的 API 方案，因此除了 get_sample_audit、check_upgrade_status 和 get_recommendations 之外，每个工具都需要密钥。 get_sample_audit 完全无需密钥。get_recommendations 会为任何有效密钥提供已有审计记录中的后续步骤；Pro 方案还会说明在哪里提交信息以供收录、AI 助手对该企业有哪些错误认知，以及每项发现应使用哪个修复文件。

请像对待密码一样保护密钥——只将其设在 MCP 客户端的 env 中，切勿提交。

设置或更改密钥后，请重启客户端。 WA_API_KEY 只会在服务器启动时读取一次，因此客户端运行期间新增的密钥对它不可见——在 Claude Desktop 中，请退出并重新打开应用。如果不重启，工具会继续返回你刚处理过的同一个 AUTH_REQUIRED，看起来就像密钥无法使用一样。

配置（环境变量）

变量	默认值	用途
WA_API_KEY	(必填)	每位用户的 API 密钥（以 wa_ 开头）。
WA_API_BASE_URL	https://api.website-auditor.io	此服务封装的 Website Auditor API。
WA_SITE_URL	https://website-auditor.io	用于构建可分享的报告链接。
WA_UPGRADE_URL	https://api.website-auditor.io/admin_portal/	身份验证和订阅错误会指向此处。系统会追加 ?source=mcp，以便归因于从此处开始的注册；可设置自己的 source 来覆盖。对于接受域名的工具，还会添加 site=<hostname>（仅主机名，不含路径或查询参数），以便门户显示站点；但只有当链接指向门户（即 WA_API_BASE_URL 的主机）时才会添加，绝不会指向其他主机。配额错误不会显示此链接，因为每日上限并非促销机会。
WA_UPSELL_STYLE / WA_UPSELL_INFO_URL	link / WA_SITE_URL	info 样式（托管的 ChatGPT 服务）会将所有身份验证和套餐错误链接到信息性套餐页面 WA_UPSELL_INFO_URL，而不是 WA_UPGRADE_URL，且文本中不包含价格或试用信息。除非设置了 source，否则会追加 ?source=mcp；对于接受域名的工具，只有当此 URL 指向门户（即 WA_API_BASE_URL 的主机）时才会添加 site=<hostname>，不会添加到主页默认地址或其他主机。
WA_TOOL_COPY	full	neutral（托管的 Claude 连接器）会从工具描述中删去价格、试用信息以及“先调用 get_sample_audit”的提示，从服务指令的计费段落中删去条款，并将指令中主动推荐和“改为调用它”的段落改为描述。Anthropic 目录审核会将这些内容视为促销，或视为指示 Claude 调用工具。付费墙答复仍会说明条款（参见 WA_UPSELL_STYLE）。
WA_AUTH_CHALLENGE	result	仅适用于启用 Mixed Auth 的托管服务。http（托管的 Claude 连接器）会在工具运行前，以 HTTP 401 和 WWW-Authenticate 响应：包括在未提供任何凭据时调用仅限账户的工具，以及使用授权服务器拒绝的令牌调用任何工具。Claude 只有在收到此信号时才会启动登录。无法检查的令牌（因内省服务不可用）不会被拒绝。result 会将质询放入工具结果的 _meta 中，这是 ChatGPT 读取的位置。
WA_REQUEST_TIMEOUT_MS	120000	API 调用超时时间。
WA_AUDIT_CACHE_TTL_MS	86400000	在此时间窗口内复用某个域名的审计结果，而非消耗配额（由 compare_competitors 使用）。默认值为 24 小时。
WA_SUBSCRIPTION_CACHE_TTL_MS	60000	每个密钥解析出的 Pro/免费套餐缓存时长，超过后会重新检查订阅。
WA_METRICS_DISABLED	(未设置 → 启用指标)	设置为 1/true 可停用匿名使用情况遥测。

通常只需设置 WA_API_KEY；其余变量均有合理的默认值。完整列表请参见 .env.example。

---

身份验证与套餐

每次调用都会验证你的密钥。Pro/免费套餐会从 API 实时解析并短暂缓存，因此升级和降级会在约一分钟内生效：

• 没有密钥 → get_sample_audit 仍可正常使用（这正是它的用途）；其他所有工具都会返回 AUTH_REQUIRED，并附上价格和注册链接。
• 已撤销或无法识别的密钥 → INVALID_KEY，并附上 API 提供的解决方法（“生成新密钥”）。这与 PRO_REQUIRED 不同：解决方法是换用新密钥，而不是购买套餐。
• 没有有效订阅（密钥有效，但订阅已过期、已取消或从未订阅）→ PRO_REQUIRED，并附上价格和升级链接；没有免费 API 套餐。check_upgrade_status 仍会返回结果，让调用方了解原因；get_recommendations 仍会返回免费列表（"tier": "free"）。
• 已订阅（状态为 active 或试用正在进行）→ 可使用所有工具。

错误会规范化为稳定的代码，供 Agent 据此进行分支处理，例如 AUTH_REQUIRED、INVALID_KEY、PRO_REQUIRED、OVER_QUOTA、UNREACHABLE_DOMAIN、INVALID_INPUT、TIMEOUT。如果域名能解析，但页面始终无法加载（网站宕机、拒绝连接、超时，或每个页面都返回 404/5xx），则返回 UNREACHABLE_DOMAIN；如果域名无法解析，则会在审计开始前拒绝处理，并返回 INVALID_INPUT。这两种情况都不会生成虚构的评分。

---

开发

npm install
npm run build      # compile TypeScript → dist/
npm start          # serve over stdio
npm run dev        # run from source without building
npm test           # vitest
npm run typecheck

该测试套件完全隔离：API 客户端、订阅提供方和计量器均通过注入提供，HTTP 请求则在 fetch 边界处进行模拟，因此不会访问网络。

---

隐私政策

匿名安装 ID。 启用遥测后，服务器会在首次运行时生成一个随机 UUID，并将其存储在 ~/.config/website-auditor-mcp/install-id（或 $XDG_CONFIG_HOME）中，之后随每个事件一并发送。它的唯一用途是区分同一安装的多次重启与多个独立安装；否则，安装次数就只能按重启次数计算。该 ID 是随机生成的，不会根据你的设备、用户名或网络信息推导，也不是指纹。设置 WA_METRICS_DISABLED 即可完全停用遥测：不会生成 ID，也不会向磁盘写入任何内容。

此连接器只会连接一个外部服务：website-auditor.io 上的 Website Auditor API。调用工具时，它只会向该 API 发送两项内容：

• 你要求审计或监控的目标域名；以及
• 你的 API 密钥（WA_API_KEY），用于验证请求并确定你的套餐。

服务器会在启动时查询 Pro 当前价格，并在工具使用期间每小时最多查询一次（GET /pricing.json），确保显示的价格始终是最新的。此请求不会携带密钥、安装 ID，也不会包含有关你或你的网站的任何数据。

以上就是离开你设备的数据。连接器不会收集、存储或传输你的文件、提示词、对话内容或任何其他个人数据，也不会向 Website Auditor API 以外的任何第三方发送数据。你的 API 密钥仅保存在 MCP 客户端的配置中（在 Claude Desktop 中，它存储于操作系统密钥链，并作为环境变量注入）；该密钥绝不会写入软件包或记录到日志中。

为改进服务，系统可能会发送匿名汇总使用遥测数据（运行的工具、成功/失败状态、延迟时间——不包含域名、密钥或个人数据）。设置 WA_METRICS_DISABLED=1 即可完全停用遥测。如果将其作为桌面扩展安装，也可以在扩展设置中勾选 “停用匿名使用遥测”。

完整隐私政策：https://website-auditor.io/privacy

---

许可证

MIT — © 2026 Kevin Armstrong / SpikeyCoder。

本许可证涵盖此仓库中的 MCP 服务：即与 Website Auditor API 通信的客户端。审计引擎及其背后的 API 属于独立产品，不受本许可证涵盖；要运行实际审计，仍需拥有 Website Auditor 账户。

了解详情，请访问 website-auditor.io。