superaudit-mcp

MCP（模型上下文协议）服务器，将 SuperAudit 真实且免费的审计功能暴露为一个工具，任何兼容 MCP 的 AI 代理都可以调用。

这样，外部开发者可以让自己的代理（Claude 或其他 MCP 客户端）做诸如"用 SuperAudit 审计这个网站"的事情，而无需与 SuperAudit 团队中的任何人沟通——该工具直接调用公共生产端点。

功能

暴露一个单一工具：audit_website。

• 输入：

  • url（必填）：要审计的域名或 URL，例如 "minegocio.es" 或 "https://minegocio.es"。

  • raw_json（可选，boolean，默认 false）：如果为 true，除了可读摘要外，还返回 SuperAudit 提供的完整 JSON（所有模块、所有评分、所有方案）。

• 内部功能： 调用 POST https://superaudit.airpagents.pro/api/quick-audit，参数为 { "web": "<url>" }——与 SuperAudit 落地页目前用于免费扫描的公共端点相同。不需要任何密钥或令牌。

• 输出： 文本摘要，包含总体得分（0-100）、约 27 个模块中每个模块的评分（SEO、安全性、法律/RGPD、Core Web Vitals、WCAG 可访问性、生成式 AI 中的排名、WordPress/CVE、OWASP Top 10 等）、检测到的主要问题以及 SuperAudit 根据结果推荐的付费方案。

Related MCP server: foglift-mcp

已知限制（重要）

• 公共端点在 SuperAudit 服务器上设有每 IP 每分钟 10 次请求的限制。如果超出限制，该工具会返回错误提示——不会自动重试，以免使服务过载。

• 后端会将每个已审计的域名缓存 24 小时，因此在短时间内重新审计同一网站是即时的。

• "冷"审计（未缓存的域名）可能需要好几秒：客户端会等待最多 90 秒，然后才将尝试判定为失败。

• 后端会验证 URL 指向真实的公共域名（阻止私有 IP/localhost 作为 SSRF 防护措施）——如果网站不存在或不在线，该工具会返回可读的错误，而不是静默失败。

安装（适用于外部开发者）

要求：Node.js 18 或更高版本。

git clone <este repositorio>   # o simplemente copia esta carpeta
cd superaudit-mcp
npm install
npm run build

这会生成 dist/index.js，即 MCP 服务器的二进制文件（通过 stdio 通信，这是 MCP 的标准传输方式）。

单独测试（可选）

npm run build
node dist/index.js

进程会停留在 stdio 上等待——这是正常的，MCP 服务器就是这样工作的。它从 MCP 客户端连接，不作为交互式 CLI 使用。

如何连接到 MCP 客户端

Claude Code

claude mcp add superaudit -- node "/ruta/completa/a/superaudit-mcp/dist/index.js"

Claude Desktop

编辑 Claude Desktop 的配置文件（claude_desktop_config.json）并添加：

{
  "mcpServers": {
    "superaudit": {
      "command": "node",
      "args": ["/ruta/completa/a/superaudit-mcp/dist/index.js"]
    }
  }
}

重启 Claude Desktop。工具 audit_website 将变为可用，代理可以在对话需要时使用它（例如"用 SuperAudit 审计 minegocio.es"）。

任何其他 MCP 客户端

任何支持通过 stdio 运行 MCP 服务器的客户端都可以将 node dist/index.js 作为服务器命令启动——不需要额外配置或环境变量。

环境变量（可选）

• SUPERAUDIT_BASE_URL：默认值为 https://superaudit.airpagents.pro。只有在指向自己的测试环境时才有必要更改。

不需要任何 API 密钥：此工具使用的端点与 SuperAudit 公共落地页用于免费扫描的端点相同。

开发

npm install
npm run build   # compila TypeScript → dist/

这个初始交付物中没有自动化测试——已使用真实的 MCP 客户端手动验证（握手 initialize + tools/list

• tools/call）针对生产端点。