SiteVerdict — Website Audit Tools

SiteVerdict — 网站审计工具（MCP 服务）

面向 AI Agent 的网站审计工具。让 Claude、ChatGPT、Cursor 或任何 MCP 客户端执行 “审计我的网站，并告诉我应该先修复什么”。它会运行基于真实浏览器的检查，并返回按优先级排序的修复计划：

工具	检查内容
full_website_audit	并行运行以下所有检查，然后返回总体评分、执行摘要和一份按优先级排序的修复清单
audit_tracking_consent	Cookie 同意和 GDPR / UK GDPR / PECR：同意前或点击“拒绝”后触发的标签、跟踪 Cookie、Google Consent Mode v2、失效的 GA4/GTM 标签、重复的 page_views
scan_speed_and_revenue	Core Web Vitals（LCP、INP、CLS、TTFB）、页面体积和瓶颈；如果你提供流量和订单价值，还会估算页面缓慢造成的收入损失
audit_accessibility_wcag	WCAG 2.2 A/AA/AAA（axe-core），并映射到成功标准以及《欧洲无障碍法案》/ EN 301 549
check_domain_email_health	MX、SPF、DKIM、DMARC、BIMI、MTA-STS、DNSSEC、CAA、TLS 过期时间、仿冒风险，以及 Gmail/Yahoo 批量发件人的配置缺失
check_ai_search_readiness	ChatGPT、Perplexity 和 Google AI Overviews 能否读取并引用你的网站？涵盖 robots.txt 中的 AI 机器人、llms.txt、schema.org、渲染、规范标签和站点地图
get_audit_results	收集仍在运行的长时间扫描结果，不额外收费

提示词：website_fix_plan、cookie_consent_check、prelaunch_check。资源：siteverdict://checks、siteverdict://guide/scoring。

计费方式

每项检查都是一个 Apify Actor。服务会使用你的 APIFY_TOKEN 在你自己的 Apify 账户中运行该 Actor，Apify 会直接按每次事件的价格向你收费。本服务不处理付款、不设账户，也不存储数据。

• 每次运行都有费用上限（maxTotalChargeUsd，默认 $2；可在每次调用时通过 maxCostUsd 配置）。
• 如果你取消工具调用，Apify 运行会中止，因此你也会停止付费。
• 你可以在 Apify 控制台查看运行费用。

在 https://console.apify.com/settings/integrations 获取令牌。若要在没有令牌的情况下试用这些工具，请设置 SITEVERDICT_DRY_RUN=1。此时所有结果都使用内置的示例数据，并会明确标注。

安装

需要 Node.js 20+。请将 apify_api_xxx 替换为你的令牌。

Claude Code

claude mcp add --env APIFY_TOKEN=apify_api_xxx --transport stdio siteverdict -- npx -y @siteverdict/mcp

Claude Desktop

前往 Settings → Developer → Edit Config（claude_desktop_config.json）：

{
  "mcpServers": {
    "siteverdict": {
      "command": "npx",
      "args": ["-y", "@siteverdict/mcp"],
      "env": { "APIFY_TOKEN": "apify_api_xxx" }
    }
  }
}

你也可以从 Releases 页面安装一键式 .mcpb 安装包。Claude Desktop 会提示你输入令牌，并安全地保存。

Cursor

将以下内容添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）：

{
  "mcpServers": {
    "siteverdict": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@siteverdict/mcp"],
      "env": { "APIFY_TOKEN": "${env:APIFY_TOKEN}" }
    }
  }
}

VS Code（GitHub Copilot Agent 模式）

将以下内容添加到 .vscode/mcp.json。VS Code 会提示你输入一次令牌，并将其加密保存：

{
  "inputs": [
    { "type": "promptString", "id": "apify-token", "description": "Apify API token", "password": true }
  ],
  "servers": {
    "siteverdict": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@siteverdict/mcp"],
      "env": { "APIFY_TOKEN": "${input:apify-token}" }
    }
  }
}

或者运行：code --add-mcp '{"name":"siteverdict","command":"npx","args":["-y","@siteverdict/mcp"],"env":{"APIFY_TOKEN":"${input:apify-token}"}}'

Windsurf / Devin Desktop

将以下内容添加到 ~/.codeium/windsurf/mcp_config.json。较新的构建版本使用 ~/.config/devin/mcp_config.json，Windows 上则使用 %APPDATA%\devin\mcp_config.json：

{
  "mcpServers": {
    "siteverdict": {
      "command": "npx",
      "args": ["-y", "@siteverdict/mcp"],
      "env": { "APIFY_TOKEN": "${env:APIFY_TOKEN}" }
    }
  }
}

Cline

等 Cline MCP Marketplace 上架后，从中安装；或者将以下内容添加到 cline_mcp_settings.json：

{
  "mcpServers": {
    "siteverdict": {
      "command": "npx",
      "args": ["-y", "@siteverdict/mcp"],
      "env": { "APIFY_TOKEN": "apify_api_xxx" },
      "disabled": false,
      "autoApprove": []
    }
  }
}

OpenAI Codex CLI

codex mcp add siteverdict --env APIFY_TOKEN=apify_api_xxx -- npx -y @siteverdict/mcp

或者将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.siteverdict]
command = "npx"
args = ["-y", "@siteverdict/mcp"]
tool_timeout_sec = 600

[mcp_servers.siteverdict.env]
APIFY_TOKEN = "apify_api_xxx"

扫描可能需要几分钟，因此请将 tool_timeout_sec 调高至默认值 60 以上。

Gemini CLI

gemini mcp add -e APIFY_TOKEN=apify_api_xxx siteverdict npx -y @siteverdict/mcp

ChatGPT 和 Claude（带 OAuth 的远程连接器）

这些客户端需要远程 HTTPS URL。该服务以远程模式提供 OAuth 2.1：CIMD/DCR 客户端注册、PKCE，以及一个供你粘贴自己的 Apify 令牌的登录页面。它还提供 ChatGPT/MCP Apps 评分卡界面。所有者部署后，可将 https://mcp.webrevenuescan.com/mcp 添加为自定义连接器，也可以使用 /mcp/<toolsets>，例如 /mcp/web+compliance。设计和部署步骤：docs/REMOTE.md。尚未部署。

Docker

docker run -i --rm -e APIFY_TOKEN=apify_api_xxx mcp/siteverdict

远程 / Streamable HTTP（可自托管）

SITEVERDICT_HTTP_HOST=127.0.0.1 SITEVERDICT_HTTP_PORT=3333 npx -y @siteverdict/mcp --http
# endpoint: http://127.0.0.1:3333/mcp   health: /healthz
# each user sends their own token:  X-Apify-Token: apify_api_xxx   (or Authorization: Bearer apify_api_xxx)
claude mcp add --transport http siteverdict http://127.0.0.1:3333/mcp --header "X-Apify-Token: apify_api_xxx"

该服务默认绑定到 localhost，并验证 Host 和 Origin。要公开提供服务，请将其置于 TLS 后面，并设置 SITEVERDICT_ALLOWED_HOSTS 和 SITEVERDICT_ALLOWED_ORIGINS。

工具集（保持工具列表精简）

默认工具集为**web**：包含 7 个审计工具，以及 detect_tech_stack、monitor_website_changes、fetch_clean_markdown 和 get_run_results。要添加更多组：

npx -y @siteverdict/mcp --toolsets web,compliance        # or SITEVERDICT_TOOLSETS=all
npx -y @siteverdict/mcp --tools sanctions_screen,uk_property_data   # explicit allow-list

工具集	工具
web	full_website_audit、audit_tracking_consent、scan_speed_and_revenue、audit_accessibility_wcag、check_domain_email_health、check_ai_search_readiness、get_audit_results、detect_tech_stack、monitor_website_changes、fetch_clean_markdown
marketing	seo_rank_check、search_traffic_diagnose、google_ads_transparency、reviews_monitor
leads	find_local_businesses、company_registry_lookup、sec_filing_watch、sec_full_text_search、find_public_tenders、detect_tech_stack
compliance	sanctions_screen、validate_vat_or_company_number、extract_pdf_invoice、company_registry_lookup
travel	flight_fare_scan、flight_fare_estimate、flight_deal_alerts、check_flight_compensation、visa_entry_check
property	uk_property_data

部分数据工具可以使用你自己的第三方密钥：

• stdio：SITEVERDICT_SECRET_<NAME> 环境变量
• HTTP：X-SiteVerdict-Secret-<Name> 标头

例如：COMPANIES_HOUSE_API_KEY、HMRC_CLIENT_ID、GOOGLE_MAPS_API_KEY、SERPAPI_API_KEY 和 EPC_API_TOKEN。siteverdict://tools 资源会列出所有密钥。密钥不会作为工具参数，也不会出现在结果中。没有密钥时，工具会使用 Actor 明确标注的示例模式，或仅执行格式检查。

完整生成的表格：marketplace/tools.md。

示例提示词

• “审计 https://example.com，并为我制定本周的修复计划。”
• “我在 example.co.uk 上的 Cookie 横幅符合 GDPR 吗？用户同意前有没有任何跟踪行为？”
• “我的移动网站速度很慢，每月有 4 万次访问、2% 的转化率，平均订单金额为 £70，这会让我损失多少收入？”
• “检查 example.com 是否符合 WCAG 2.2 AA，并告诉我《欧洲无障碍法案》对我们意味着什么。”
• “有人能伪造来自我们域名的电子邮件吗？检查 example.com 的 SPF、DKIM 和 DMARC。”
• “ChatGPT 和 Perplexity 会引用我们的网站吗？检查网站的 AI 搜索就绪情况。”

配置

变量	默认值	用途
APIFY_TOKEN	—	你的 Apify 令牌（stdio 模式）
SITEVERDICT_DRY_RUN	0	设为 1 时返回示例数据，不调用 Apify
SITEVERDICT_DEFAULT_MAX_CHARGE_USD	2	每次 Actor 运行的支出上限
SITEVERDICT_DEFAULT_WAIT_SECS / SITEVERDICT_MAX_WAIT_SECS	240 / 900	调用返回 running 和 runId 前等待的时长
SITEVERDICT_RATE_LIMIT_PER_MINUTE	20	每个客户端每分钟的工具调用次数
SITEVERDICT_MAX_CONCURRENT_RUNS	6	每个客户端可并发运行的 Actor 数量
SITEVERDICT_APIFY_USERNAME	来自 brand.json	拥有这些 Actor 的 Apify 账户
SITEVERDICT_ACTOR_TRACKING_CONSENT、..._SPEED_REVENUE、..._ACCESSIBILITY、..._DOMAIN_EMAIL、..._AI_SEARCH	<username>/siteverdict-…	覆盖单个 Actor ID
SITEVERDICT_DNS_CHECK	1	解析主机名并拒绝私有地址（SSRF 防护）
SITEVERDICT_HTTP_HOST / _PORT / _PATH	127.0.0.1 / 3333 / /mcp	HTTP 模式
SITEVERDICT_ALLOWED_HOSTS / _ORIGINS	localhost	公共 HTTP 部署使用的逗号分隔列表

安全

• 只读。 所有工具都标注为 readOnlyHint: true, destructiveHint: false, openWorldHint: true，不会更改你的网站。
• 仅限公共目标。 私有、环回、链路本地、CGNAT、云元数据及保留 IP、内部主机名、非 http(s) 方案、URL 中的凭据和异常端口均会被拒绝。解析到私有地址的主机名也会被拒绝。
• 令牌仅发送给 Apify。 令牌只会通过 Authorization 标头发送至 api.apify.com，不会记录日志，也不会放入 URL。
• 限制。 调用受到速率限制，并且每个客户端的并发运行数设有上限。每次运行都有支出上限。取消调用会中止其运行。

开发

npm install
npm run typecheck && npm run lint && npm test   # unit + integration tests (mocked Apify, no network)
npm run smoke                                   # builds, then drives dist/cli.js over real stdio
npm run inspector                               # MCP Inspector UI against the dry-run server
SITEVERDICT_DRY_RUN=1 npm run dev               # stdio from source

要重命名品牌，请编辑 brand.json 并运行 npm run brand:sync。

基于官方 MCP TypeScript SDK v2（@modelcontextprotocol/server）构建。同时支持 2026-07-28 协议和 2025 年前后的客户端。

隐私与条款

请参阅 PRIVACY.md 和 TERMS.md。两者均为草案，尚待审核。支持：GitHub issues。