网站审计技能
使用 squirrelscan CLI 对网站进行 SEO、技术、内容、性能和安全性方面的审计。
squirrelscan 提供了一个 CLI 工具 squirrel - 适用于 macOS、Windows 和 Linux。它通过模拟浏览器、搜索爬虫,并对照 240 多条规则分析网站的结构和内容,来执行全面的网站审计。
它会为您提供问题列表以及如何修复这些问题的建议。
链接
- squirrelscan 网站:https://squirrelscan.com
- 文档(包括规则参考):docs.squirrelscan.com
您可以使用以下模板查询任何规则的文档:
https://docs.squirrelscan.com/rules/{类别}/{规则ID}
示例:
https://docs.squirrelscan.com/rules/links/external-links
此技能的功能
此技能使 AI 智能体能够根据 22 个类别的 240 多条规则对网站进行审计,包括:
- 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 的具体问题
- 失效链接检测
- 可操作的建议
- 规则有 error、warning 和 notice 级别,并且具有 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
您应始终优先选择格式选项 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)时,网站才被视为完成并已修复。
问题类别
| 类别 | 修复方法 | 可并行化 |
|---|---|---|
| Meta 标签/标题 | 编辑页面组件或元数据 | 否 |
| 结构化数据 | 向页面模板添加 JSON-LD | 否 |
| 缺少 H1/标题 | 编辑页面组件 + 内容文件 | 是(内容) |
| 图片 alt 文本 | 编辑内容文件 | 是 |
| 标题层级 | 编辑内容文件 | 是 |
| 短描述 | 编辑内容 frontmatter | 是 |
| HTTP→HTTPS 链接 | 在内容中查找并替换 | 是 |
| 失效链接 | 人工审查(标记给用户) | 否 |
对于可并行化的修复:派生子智能体并指定文件分配。
内容文件修复
许多问题需要编辑内容文件。这些与代码修复同等重要:
- 图片 alt 文本:为图片添加描述性 alt 文本
- 标题层级:修复跳过的标题级别
- Meta 描述:扩展 frontmatter 中的简短描述
- 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 技能 |
自身命令
squirrel 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、技术、内容、安全性)
- 失效链接:外部失效链接列表
…
[原文截断]
其他格式
其他格式可用于人类或程序化消费。
# Markdown 格式
squirrel report <audit-id> --format markdown
# JSON 格式
squirrel report <audit-id> --format json
# 文本格式
squirrel report <audit-id> --format text
# HTML 报告
squirrel report <audit-id> --format html
将报告导出到文件
squirrel report <audit-id> --format llm -o report.md
squirrel report <audit-id> --format json -o report.json
使用本地项目
如果您正在审计一个您有人为干预的网站,并且想要将审计结果与您的代码库关联起来,请使用项目名称初始化 squirrel。
这使您可以协调审计修复、跟踪变更并管理问题。
设置项目
# 初始化新项目
cd /path/to/your/project
squirrel init -n my-project
# 再次运行审计 - 现在与项目关联
squirrel audit https://example.com --format llm
最佳实践
- 始终使用
--format llm以获得针对 AI 智能体优化的输出 - 先进行表面扫描,然后再进行深度扫描
- 优先审计在线网站以获得真实结果
- 并行化内容修复以提高效率
- 迭代:修复 → 重新审计 → 展示进度
- 使用差异检测回归
- 达到 95+ 分且 覆盖范围 FULL 后才认为完成
- 应用修复后验证代码仍能构建
- 检查代码中引用的 URL 是否正确 - 不要让用户重构他们的 URL 模式,除非修复了 URL 问题。