网站审计技能
使用 squirrelscan CLI 对网站进行 SEO、技术、内容、性能和安全性审计。
squirrelscan 提供了一个 CLI 工具 squirrel,适用于 macOS、Windows 和 Linux。它通过模拟浏览器、搜索引擎爬虫,并根据 230 多条规则分析网站的结构和内容,进行全面的网站审计。
它会提供一系列问题以及如何修复它们的建议。
链接
- squirrelscan 网站位于 https://squirrelscan.com
- 文档(包括规则参考)位于 docs.squirrelscan.com
您可以使用以下模板查找任何规则的文档:
https://docs.squirrelscan.com/rules/{rule_category}/{rule_id}
示例:
https://docs.squirrelscan.com/rules/links/external-links
此技能的功能
此技能使 AI 代理能够审核网站是否符合 21 个类别的 230 多条规则,包括:
- SEO 问题:元标签、标题、描述、规范 URL、Open Graph 标签
- 技术问题:断链、重定向链、页面速度、移动端友好性
- 性能:页面加载时间、资源使用、缓存
- 内容质量:标题结构、图片 alt 文本、内容分析
- 安全性:泄露的密钥、HTTPS 使用、安全标头、混合内容
- 可访问性:Alt 文本、颜色对比度、键盘导航
- 可用性:表单验证、错误处理、用户流程
- 链接:检查内部和外部断链
- E-E-A-T:专业知识、经验、权威性、可信度
- 用户体验:用户流程、错误处理、表单验证
- 移动端:检查移动端友好性、响应式设计、触摸友好元素
- 可爬行性:检查可爬行性、robots.txt、sitemap.xml 等
- Schema:Schema.org 标记、结构化数据、丰富摘要
- 法律:符合法律要求、隐私政策、服务条款
- 社交:Open Graph、Twitter 卡片以及验证架构、摘要等。
- URL 结构:长度、连字符、关键词
- 关键词:关键词堆砌
- 内容:内容结构、标题
- 图片:Alt 文本、颜色对比度、图片大小、图片格式
- 本地 SEO:NAP 一致性、地理元数据
- 视频:VideoObject 架构、可访问性
以及更多
审计会爬取网站,根据审计规则分析每个页面,并返回一份综合报告,内容包括:
- 总体健康评分(0-100)
- 类别细分(核心 SEO、技术 SEO、内容、安全性)
- 带有受影响 URL 的具体问题
- 断链检测
- 可操作的建议
- 规则分为错误、警告和通知级别,并具有 1 到 10 的等级
何时使用
在您需要以下情况时使用此技能:
- 分析网站健康状况
- 调试技术 SEO 问题
- 修复上面提到的所有问题
- 检查断链
- 验证元标签和结构化数据
- 生成站点审计报告
- 比较更改前后的站点健康度
- 改善网站性能、可访问性、SEO、安全性等。
您应尽可能频繁地重新审核,以确保网站保持健康并表现良好。
前提条件
此技能要求系统已安装 squirrel CLI 并且已添加到 PATH。
验证:
squirrel --version
设置
运行 squirrel init 在当前目录下创建 squirrel.toml 配置文件。如果不存在,则创建一个并指定项目名称:
squirrel init -n my-project
# 覆盖现有配置
squirrel init -n my-project --force
用法
简介
有三个可以运行的进程,它们都缓存在本地项目数据库中:
crawl- 子命令,用于运行爬取或刷新、继续爬取analyze- 子命令,用于分析爬取结果report- 子命令,用于以所需格式(llm、text、console、html 等)生成报告
audit 命令是这三个进程的封装,并依次运行它们:
squirrel audit https://example.com --format llm
您应始终首选 format 选项 llm - 它是专门为您设计的,提供详尽且紧凑的输出格式。
首次扫描 应为表面扫描,这是一种快速且浅层的网站扫描,用于收集网站的基本信息,如其结构、内容和技术栈。此扫描可以快速完成,不会影响网站性能。
第二次扫描 应为深度扫描,这是一种彻底且详细的网站扫描,用于收集网站的更多信息,如其安全性、性能和可访问性。此扫描可能需要更长时间,并可能影响网站性能。
如果用户未提供要审核的网站,请询问他们希望审核哪个 URL。
您应 首选 审核 实时网站 - 只有在那里我们才能获得网站、性能或渲染问题的真实表现。
如果您同时拥有要审核的本地和实时网站,请提示用户选择要审核的网站,并 建议 他们选择实时网站。
您可以将审计中的修复应用到实时网站,并同时应用到本地代码。
在规划任务范围时,请考虑让它们并发运行作为子代理,以加速修复。
在实施修复时,利用子代理来加快修复的实施速度。
应用修复后,验证代码仍然可以构建并通过项目中的任何现有检查。
基本工作流程
审计过程分为两步:
- 运行审计(保存到数据库,显示控制台输出)
- 以所需格式导出报告
# 步骤 1:运行审计(默认:控制台输出)
squirrel audit https://example.com
# 步骤 2:以 LLM 格式导出
squirrel report <audit-id> --format llm
回归差异
当您需要检测审计之间的回归时,请使用差异模式:
# 将当前报告与基线审计 ID 进行比较
squirrel report --diff <audit-id> --format llm
# 将最新的域名报告与基线域进行比较
squirrel report --regression-since example.com --format llm
差异模式支持 console、text、json、llm 和 markdown。不支持 html 和 xml。
运行审计
运行审计时:
- 呈现报告 - 向用户显示审计结果和分数
- 提出修复方案 - 列出您可以修复的问题,并在进行更改前请求用户确认
- 并行化已批准的修复 - 对批量内容编辑(alt 文本、标题、描述)使用子代理
- 迭代 - 修复一批 → 重新审计 → 呈现结果 → 提出下一批修复方案
- 暂停以进行判断 - 断链、结构性更改以及任何不明确的内容都应标记以供用户审查
- 显示前后对比 - 每次修复批次后呈现评分对比
-
迭代循环:修复一批问题后,重新审计并继续修复,直到:
- 分数达到目标(通常为 85+),或
- 只剩下需要人类判断的问题(例如,“是否应删除此链接?”)
-
同等对待所有修复:代码更改和内容更改同等重要。
-
并行化内容修复:对于影响多个文件的问题:
- 生成子代理以并行修复
- 示例:7 个文件需要 alt 文本 → 生成 1-2 个代理来修复所有文件
- 示例:30 个文件存在标题问题 → 生成代理以批量编辑
-
完成标准:
- ✅ 所有错误已修复
- ✅ 所有警告已修复(或记录为需要人工审查)
- ✅ 重新审计确认改进
- ✅ 向用户显示前后对比
应用修复后,询问用户是否要审查更改。
分数目标
| 起始分数 | 目标分数 | 预期工作量 |
|---|---|---|
| < 50(F 级) | 75+(C 级) | 重大修复 |
| 50-70(D 级) | 85+(B 级) | 中等修复 |
| 70-85(C 级) | 90+(A 级) | 打磨 |
| > 85(B+ 级) | 95+ | 微调 |
只有当分数高于 95(A 级)且覆盖率设置为 FULL(--coverage full)时,站点才算 完成并修复。
问题类别
| 类别 | 修复方法 | 可并行化 |
|---|---|---|
| 元标签/标题 | 编辑页面组件或元数据 | 否 |
| 结构化数据 | 向页面模板添加 JSON-LD | 否 |
| 缺少 H1/标题 | 编辑页面组件 + 内容文件 | 是(内容) |
| 图片 alt 文本 | 编辑内容文件 | 是 |
| 标题层级 | 编辑内容文件 | 是 |
| 简短描述 | 编辑内容前部变量 | 是 |
| HTTP→HTTPS 链接 | 在内容中查找并替换 | 是 |
| 断链 | 人工审查(标记给用户) | 否 |
对于可并行化的修复:使用特定的文件分配生成子代理。
内容文件修复
许多问题需要编辑内容文件。这些与代码修复同等重要:
- 图片 alt 文本:为图片添加描述性 alt 文本
- 标题层级:修复跳过的标题级别
- 元描述:扩展前部变量中的简短描述
- HTTP 链接:将不安全的链接更新为 HTTPS
使用子代理并行化修复
当用户批准一批修复时,您可以使用子代理并行应用它们:
- 先询问用户 — 在生成子代理之前,始终确认要应用哪些修复
- 对于相同修复类型,每 3-5 个文件分组到一个子代理
- 仅并行化独立的文件(没有共享组件或配置)
- 在一条消息中生成多个子代理以并发执行
高级选项
审核更多页面:
squirrel audit https://example.com --max-pages 200
强制全新爬取(忽略缓存):
squirrel audit https://example.com --refresh
恢复中断的爬取:
squirrel audit https://example.com --resume
用于调试的详细输出:
squirrel audit https://example.com --verbose
常用选项
审计命令选项
| 选项 | 别名 | 描述 | 默认值 |
|---|---|---|---|
--format <fmt> | -f <fmt> | 输出格式:console、text、json、html、markdown、llm | console |
--coverage <mode> | -C <mode> | 覆盖模式:quick、surface、full | surface |
--max-pages <n> | -m <n> | 要爬取的最大页面数(最大 5000) | 因覆盖模式而异 |
--output <path> | -o <path> | 输出文件路径 | - |
--refresh | -r | 忽略缓存,全新获取所有页面 | false |
--resume | - | 恢复中断的爬取 | false |
--verbose | -v | 详细输出 | false |
--debug | - | 调试日志记录 | false |
--trace | - | 启用性能跟踪 | false |
--project-name <name> | -n <name> | 覆盖项目名称 | 来自配置 |
覆盖模式
根据您的审计需求选择覆盖模式:
| 模式 | 默认页面数 | 行为 | 用例 |
|---|---|---|---|
quick | 25 | 仅种子和站点地图,无链接发现 | CI 检查、快速健康检查 |
surface | 100 | 每个 URL 模式一个样本 | 一般审计(默认) |
full | 500 | 爬取所有内容,直到达到限制 | 深入分析 |
表面模式很智能 - 它检测 URL 模式,如 /blog/{slug} 或 /products/{id},并且每个模式只爬取一个样本。这使得它对具有许多相似页面(博客、电子商务)的网站非常高效。
# 快速健康检查(25 个页面,无链接发现)
squirrel audit https://example.com -C quick --format llm
# 默认表面审计(100 个页面,模式采样)
squirrel audit https://example.com --format llm
# 全面综合审计(500 个页面)
squirrel audit https://example.com -C full --format llm
# 覆盖任意模式的页面限制
squirrel audit https://example.com -C surface -m 200 --format llm
何时使用每种模式:
quick:CI 管道、每日健康检查、监控surface:大多数审计 - 高效覆盖唯一模板full:发布前、综合分析、深度探究
报告命令选项
| 选项 | 别名 | 描述 |
|---|---|---|
--list | -l | 列出最近的审计 |
--severity <level> | - | 按严重性筛选:error、warning、all |
--category <cats> | - | 按类别筛选(逗号分隔) |
--format <fmt> | -f <fmt> | 输出格式:console、text、json、html、markdown、xml、llm |
--output <path> | -o <path> | 输出文件路径 |
--input <path> | -i <path> | 从 JSON 文件加载(回退模式) |
配置子命令
| 命令 | 描述 |
|---|---|
config show | 显示当前配置 |
config set <key> <value> | 设置配置值 |
config path | 显示配置文件路径 |
config validate | 验证配置文件 |
其他命令
| 命令 | 描述 |
|---|---|
squirrel feedback | 向 squirrelscan 团队发送反馈 |
squirrel skills install | 安装 Claude Code 技能 |
squirrel skills update | 更新 Claude Code 技能 |
自管理命令
self 下的自管理命令:
| 命令 | 描述 |
|---|---|
self install | 引导本地安装 |
self update | 检查并应用更新 |
self completion | 生成 shell 补全 |
self doctor | 运行健康检查 |
self version | 显示版本信息 |
self settings | 管理 CLI 设置 |
self uninstall | 从系统中移除 squirrel |
输出格式
控制台输出(默认)
audit 命令默认显示人类可读的控制台输出,带有彩色输出和进度指示器。
LLM 格式
要获得优化后的 LLM 输出,请使用 report 命令配合 --format llm:
squirrel report <audit-id> --format llm
LLM 格式是一种紧凑的 XML/文本混合格式,针对 token 效率进行了优化(比冗长的 XML 小 40%):
- 摘要:总体健康评分和关键指标
- 按类别列出问题:按审计规则类别分组(核心 SEO、技术、内容、安全性)
- 断链:断链列表
…[已截断用于翻译]