Web Scan

Web Scan

你的编码 Agent 已完成交付。Web Scan 来做检查。

一次调用即可在约 5 秒内审计任意在线 URL：涵盖 SEO、AI 搜索（GEO）、安全标头、泄露的 API 密钥、Core Web Vitals 和无障碍，共 85 项检查。每项检查结果都附带具体修复方法，并按可获得的分数排名。随后，你的 Agent 会进行修复，并在在线网站上验证修复结果，无需你重新运行任何操作。

免费。无需注册。无需 API 密钥。可作为 MCP 服务、GitHub Action、CLI 使用，也可在网页上使用。

scan_url  →  fix  →  deploy  →  verify_fixes  →  allFixed: true

---

Agent 为什么使用它

• 专为 Agent 工作循环打造。 scan_url 可找出问题，verify_fixes 则按检查 ID 验证每项修复是否已部署到生产环境。无需查看截图，也无需点击仪表板。
• 提供修复方案，而不只是检查结果。 每项未通过的检查都会返回其 ID、页面上的问题以及具体修复方法。检查结果按实际得分增幅排序（模拟应用单项修复后重新评分），因此 Agent 会按重要程度处理。
• 能发现 AI 构建的应用会泄露的信息。 它会读取网站提供给每位访客的 JavaScript，查找有效的密钥（OpenAI、Anthropic、Stripe、AWS、GitHub、Slack、SendGrid、数据库 URL、私钥）和 Supabase service_role 密钥。每处匹配都会经过二次检查，排除占位符和文档示例，因此红色结果代表真实泄露。
• 以 AI 搜索的方式查看页面。 它会展示 ChatGPT、Claude 和 Perplexity 爬虫实际收到的内容（不执行 JavaScript）、robots.txt 允许哪些 AI 机器人访问，以及页面是否回答了买家会提出的问题。
• 评分真实可靠。 总分由三部分构成（搜索与分享、安全、速度）；关键检查未通过时会限制总分，并与 25 个知名网站的基准分对照。缺少安全标头会标记为加固建议，而非安全漏洞。不确定的结果会标注“需要检查”。
• 可安全用于任何公开网站。 仅进行被动检查：读取网站已提供的内容，绝不探测隐藏路径。扫描页面中的文本只会作为数据返回，绝不会作为指令。

MCP 服务

远程、无状态、Streamable HTTP。无需密钥。

https://preflight-api.agentmarket.lol/api/mcp

Claude Code

claude mcp add --transport http web-scan https://preflight-api.agentmarket.lol/api/mcp

Cursor（~/.cursor/mcp.json）、Windsurf、VS Code（.vscode/mcp.json，键名 servers）

{
  "mcpServers": {
    "web-scan": { "url": "https://preflight-api.agentmarket.lol/api/mcp" }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.web-scan]
url = "https://preflight-api.agentmarket.lol/api/mcp"

工具

工具	功能
scan_url	对公开 URL 进行全新审计：返回 0-100 分的评分、等级，以及每项未通过或警告检查的 ID、详情和修复方法，并提供完整交互式报告的 fullReportUrl。耗时 5-15 秒。
verify_fixes	部署后重新扫描，并按检查 ID 报告当前是否通过、新旧评分、仍未通过的项目，以及 allFixed。
get_report	读取共享报告（web-scan.agentmarket.lol/r/<slug>），无需重新扫描。

在你的 Agent 中试试：

使用 Web Scan 扫描 https://my-app.com，按得分从高到低修复此仓库中的所有问题，并在我部署后验证修复结果。

GitHub Action

如果部署导致网站变差，就让构建失败。

- uses: ankitkumarjha515/web-scan@v1
  with:
    url: https://my-app.com
    min-score: 85        # fail below this score
    fail-on: score       # score | failures | any | never

它会在任务页面写入摘要表格，并附上完整交互式报告的链接。搭配预览部署使用，可在问题影响生产环境前将其发现。

CLI

无需依赖，Node 18+。

node bin/web-scan.mjs https://my-app.com --min-score 90
node bin/web-scan.mjs https://my-app.com --fail-on failures --json

退出代码 0 表示通过，1 表示门禁未通过，2 表示扫描无法运行。每次运行结束时都会提供网站上的完整报告链接，其中包含图表、AI 搜索视图、链接预览和实时速度测试。

检查内容

类别	示例
搜索基础	标题、描述、canonical、标题层级、语言、结构化数据有效性、hreflang
AI 搜索（GEO）	无 JavaScript 的文本、GPTBot / ClaudeBot / PerplexityBot 访问权限、llms.txt、适合直接作答的版块、可引用性
可抓取性	状态、noindex、robots.txt（包括会屏蔽此特定页面的规则）、站点地图、软 404、重定向
分享	实际可加载的 og:image、用于 X、LinkedIn、Slack 和 WhatsApp 预览的标题与描述
安全	HTTPS、HSTS、CSP 强度、Cookie、CORS、混合内容、框架嵌入
泄露的机密	已提供的 JavaScript 中的服务商密钥和数据库 URL、Supabase service_role、源映射、调试构建
速度	服务器响应、页面体积、阻塞渲染的文件、字体、缓存，以及按需检测的 Core Web Vitals
图像与无障碍	替代文本、尺寸、延迟加载、格式、缩放、标签、地标

每份报告还会说明网站属于哪种类型（商店、本地商家、软件、出版商、代理机构）、该类型网站所需的基础要素，以及扫描涵盖了哪些内容、无法查看哪些内容。

整站审计、竞品对比、每小时监控和 README 徽章请访问网站。

限制

• 仅支持公开 URL：不支持 localhost 或私有网络。请使用预览部署。
• 按 IP 执行合理使用速率限制；登录网站可提高限额。
• 每次 scan_url 调用仅扫描一个页面；整站抓取请使用网站。

许可证

本仓库（Action、CLI、注册表元数据）采用 MIT 许可证。扫描器本身以托管服务的形式运行。