SyteCheck

SyteCheck MCP Server

通过 Claude、Cursor 或任何其他 MCP 客户端运行网站审计，并获取可供采取行动的文本形式的检查结果。

SyteCheck 会从十个维度扫描页面——HTML 有效性、SEO、失效链接、无障碍性（通过 axe-core 实现 WCAG 2.2 AA）、性能（实际运行 Lighthouse）、安全标头、响应式布局、AI 可见性、内容新鲜度，以及对视觉设计的 AI 评价——并返回一份带评分、通俗易懂的报告。

免费账户即可使用。 无需信用卡，也没有试用期限：免费套餐每月可在三个类别中进行三次扫描，足以完成接入，并在决定是否付费获取更多扫描次数前查看一份真实报告。

快速开始

1. 创建账户：前往 sytecheck.app 并验证邮箱。
2. 生成密钥：前往 Account → API keys。如果只想让模型读取现有扫描结果，而不消耗配额，请仅选择 scans:read。密钥只会显示一次。
3. 添加服务：使用下方的一种配置方法将服务添加到客户端。

Claude Code

claude mcp add sytecheck --env SYTECHECK_API_KEY=sck_your_key_here \
  -- npx -y @ascentws/sytecheck-mcp

Claude Desktop

编辑 claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "sytecheck": {
      "command": "npx",
      "args": ["-y", "@ascentws/sytecheck-mcp"],
      "env": { "SYTECHECK_API_KEY": "sck_your_key_here" }
    }
  }
}

Cursor

将以下内容添加到项目中的 .cursor/mcp.json，或对应的全局配置文件中：

{
  "mcpServers": {
    "sytecheck": {
      "command": "npx",
      "args": ["-y", "@ascentws/sytecheck-mcp"],
      "env": { "SYTECHECK_API_KEY": "sck_your_key_here" }
    }
  }
}

Gemini CLI / Antigravity CLI

将以下内容添加到 ~/.gemini/settings.json（或 Antigravity 对应的配置文件）中：

{
  "mcpServers": {
    "sytecheck": {
      "command": "npx",
      "args": ["-y", "@ascentws/sytecheck-mcp"],
      "env": { "SYTECHECK_API_KEY": "sck_your_key_here" }
    }
  }
}

OpenAI Agents SDK

from agents import Agent
from agents.mcp import MCPServerStdio

sytecheck = MCPServerStdio(
    params={
        "command": "npx",
        "args": ["-y", "@ascentws/sytecheck-mcp"],
        "env": {"SYTECHECK_API_KEY": "sck_your_key_here"},
    }
)

agent = Agent(
    name="Site auditor",
    instructions="Audit sites with SyteCheck and explain what to fix.",
    mcp_servers=[sytecheck],
)

然后提问：“扫描 https://example.com，并告诉我最应该先修复什么。”

工具

工具	功能
run_scan	提交 URL 并等待报告。会消耗配额。
get_scan_report	获取扫描 ID 对应的完整检查结果——用于收集 run_scan 启动后仍在运行的扫描
list_scans	扫描历史记录，按时间从新到旧排列，并支持筛选
get_scan_trends	查看每个 URL 在重复扫描中的评分历史
list_categories	查看 SyteCheck 能检查的内容，以及你的套餐所包含的项目
get_account_usage	查看本月剩余扫描次数，以及配额重置时间

此外还有一个 scan-and-remediate 提示词，可扫描 URL，并将检查结果整理成按优先级排序的修复计划。

关于费用

run_scan 是唯一会产生费用的工具，而且会产生实际费用：一次扫描会打开浏览器、运行 Lighthouse 并调用视觉模型。它被标记为非只读工具，因此客户端会在运行前征求确认；其说明还会要求模型先检查剩余配额，并且不要重复扫描未更改的页面。免费账户每月可扫描三次——如果 Agent 循环调用 run_scan，一轮就会耗尽配额。

如果要将密钥交给无人值守运行的程序，请生成一个 scans:read 密钥。它完全无法创建扫描。

配置

变量	默认值	用途
SYTECHECK_API_KEY	(必填)	你的 sck_ API 密钥
SYTECHECK_API_URL	https://api.sytecheck.app	API 基础 URL
SYTECHECK_WAIT_TIMEOUT_MS	60000	run_scan 等待多久后返回扫描 ID
SYTECHECK_POLL_INTERVAL_MS	3000	等待期间两次状态检查之间的间隔

请注意，API 主机是 api.sytecheck.app，而不是 sytecheck.app——后者 提供 Web 应用，并会对 API 路径显示“找不到页面”。

直接使用 API

MCP 服务是基于纯 HTTP API 构建的轻量客户端，你也可以自行调用该 API。

• docs/API.md — 完整的开发者指南：身份验证、提交扫描、 轮询、Webhook 及其签名验证、速率限制和版本管理。
• public-openapi.json — OpenAPI 3.1 规范，可用于 生成客户端。
• examples/ — 可运行的 curl、Python、Node、Java 和 C# 客户端，以及一个可验证交付签名的 Webhook 接收器。
• 交互式文档：Swagger UI · ReDoc

开发

npm install
npm run build
npm test
npm run lint

要连接本地 SyteCheck 实例运行：

SYTECHECK_API_KEY=sck_… SYTECHECK_API_URL=http://localhost:8000 node dist/index.js

该服务通过标准输入和标准输出传输 JSON-RPC，因此标准输出中只能写入 协议消息——多余的一条 console.log 就会破坏数据流，导致客户端因解析错误而 断开连接，且错误信息并无帮助。诊断信息请写入标准错误。

安全

请参阅 SECURITY.md，了解密钥如何处理、泄露的密钥能做什么和 不能做什么，以及如何报告漏洞。

许可证

MIT — 详见 LICENSE。该许可证适用于此代码；SyteCheck 名称和标志 是 Ascent Web Solutions 的商标，服务的使用受其服务条款约束。完整条款请参阅 TRADEMARK.md。