mcpField
A
audit-website

audit-website

github.com/squirrelscan测试与质量30188 次安装今天更新
代码仓库

关于 audit-website

audit-website 是一项使用 squirrel CLI 检查网站并协助修复问题的技能,面向处理网站代码和内容的 Agent。它指导从报告中定位问题、分批应用确认过的修复,并通过重新审计验证结果。

主要功能

  1. 01运行网站审计并读取报告
  2. 02按严重性整理问题
  3. 03将发现映射到代码或内容
  4. 04分批应用已确认的修复
  5. 05重新审计并比较分数

适用场景

  1. 01查找网站的 SEO 与可访问性问题
  2. 02部署后检查网站回归
  3. 03依据审计结果修复页面模板或内容
  4. 04通过完整扫描验证修复

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/squirrelscan/squirrelscan --skill audit-website

安装后在 Claude Code 中输入/audit-website确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
agents/
openai.yaml
assets/
icon-small.svg
references/
OUTPUT-FORMAT.md

详细介绍

审核网站并修复问题

针对网站运行 squirrelscan 审核,阅读 LLM 报告,将每个问题对应到导致问题的代码或内容,分批修复并重新审核,直到达到目标分数。

需要 squirrel CLI(squirrelscan.com/download;使用 squirrel --version 验证)。有关 CLI 设置、登录、发布、MCP 和 CLI 常规用法,请使用配套的 squirrelscan 技能。

规则文档

在 https://docs.squirrelscan.com/rules/{rule_category}/{rule_id} 查找任何规则,例如:

https://docs.squirrelscan.com/rules/links/external-links

运行审核

squirrel audit https://example.com --format llm
  • 使用 --format llm:它简洁、全面,专为 Agent 打造。
  • 如果用户没有提供 URL,请询问要审核哪个网站。
  • 优先审核线上网站:只有在线上网站才能看到真实的渲染效果、性能和重定向行为。如果同时有本地开发服务器和线上网站,建议审核线上网站;无论如何,都应在本地代码中应用修复。
  • 审核结果会在本地缓存。无需重新爬取即可稍后重新生成报告:squirrel report <audit-id> --format llm。
扫描进度
  1. 第一轮,快速覆盖(默认):快速、浅层扫描,了解网站结构、技术栈和主要问题,且不会影响网站。
  2. 第二轮,深入覆盖:使用 -C surface(每种 URL 模式扫描一个页面)覆盖模板级问题,或使用 -C full 在最终验收前进行全面爬取。
模式默认页面数用途
quick25初步检查、CI 检查
surface100模板级覆盖(每种模式采样一个页面,例如 /blog/{slug})
full500最终验证、深入分析

实用标志:--refresh(忽略缓存,完整重新抓取)、--resume(继续中断的爬取)、-m <n>(页面数上限)、--verbose(显示详细进度)。

如果网站屏蔽未知爬虫(Shopify / Cloudflare),请使用重复的 -H "Name: Value" 标志传入 Web Bot Auth 标头。标头值属于机密信息,会在输出中隐藏。请参阅 https://docs.squirrelscan.com/guides/web-bot-auth

修复流程

  1. 呈现报告:分数、等级、按严重程度排序的主要问题。
  2. 提出修复方案:列出可以修复的问题,并在进行任何更改前向用户确认。
  3. 将问题对应到源文件:找到每项发现对应的模板、组件或内容文件。
  4. 分批修复:应用已获批准的修复。
  5. 重新审核(部署或更改内容后使用 --refresh),并展示修复前后的分数。
  6. 重复执行,直到达到目标,或只剩下需要判断的问题(例如“是否应该移除此链接?”)。将这些问题标记出来供用户审核,不要自行猜测。

每批修复后,验证项目仍能成功构建,且现有检查均通过。

分数目标
起始分数目标预期工作
< 50 (F)75+ (C)大幅修复
50-70 (D)85+ (B)中等修复
70-85 (C)90+ (A)润色
> 85 (B+)95+微调

最终验收时应使用 -C full 完成爬取,因为快速扫描只会抽查部分网站页面。

规则包含级别(错误、警告、提示)和排名(1-10):优先修复错误,然后处理排名较高的警告。需要修改内容的发现,与需要修改代码的发现同等重要。失效链接通常需要人工决定(移除、替换或保留):请将其标记出来,不要自行猜测。

验证回归问题

与基线进行比较,以证明改进或发现回归:

squirrel report --diff <baseline-audit-id> --format llm
squirrel report --regression-since example.com --format llm

完成标准

完成意味着:所有错误均已修复;警告已修复,或已记录为需要人工审核;重新审核已确认有所改进;并且用户已看到修复前后的分数对比以及所有更改的摘要。定期重新审核,以保持网站健康。如果用户想分享结果,可提供已发布的报告(请参阅 squirrelscan 技能)。

报告格式

LLM 报告是一种紧凑的 XML/文本混合格式,经过优化以提高 token 效率:包含健康评分的摘要、按类别分组并附带受影响 URL 的问题、失效链接以及按优先级排序的建议。完整规范:OUTPUT-FORMAT.md

评论

支持 Markdown