名称： audit-website
描述： 使用 squirrelscan CLI，通过 230 多条规则对网站进行 SEO、性能、安全、技术、内容等 15 个以上类别的审计。返回包含健康评分、失效链接、元标签分析和可操作建议的 LLM 优化报告。用于发现和评估网站或 Web 应用的问题与健康状况。
许可证： 请参阅仓库根目录中的 LICENSE 文件
compatibility: 需要已安装 squirrel CLI 并可在 PATH 中访问
元数据：
author: squirrelscan
version: "1.22"
允许工具： Bash(squirrel:*) Read Edit Grep Glob

网站审计技能

使用 squirrelscan CLI 对网站进行 SEO、技术、内容、性能和安全性问题的审计。

squirrelscan 提供了一个名为 squirrel 的 CLI 工具，适用于 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 标签
• 技术问题：失效链接、重定向链、页面速度、移动端友好性
• 性能：页面加载时间、资源使用、缓存
• 内容质量：标题结构、图片替代文本、内容分析
• 安全性：泄露的密钥、HTTPS 使用、安全标头、混合内容
• 可访问性：替代文本、颜色对比度、键盘导航
• 可用性：表单验证、错误处理、用户流程
• 链接：检查失效的内部和外部链接
• E-E-A-T：专业性、经验、权威性、可信度
• 用户体验：用户流程、错误处理、表单验证
• 移动端：检查移动端友好性、响应式设计、触控友好元素
• 可爬取性：检查可爬取性、robots.txt、sitemap.xml 等
• 结构化数据：Schema.org 标记、结构化数据、富媒体摘要
• 法律合规：法律要求、隐私政策、服务条款的合规性
• 社交媒体：Open Graph、Twitter 卡片及验证模式、摘要等
• URL 结构：长度、连字符、关键词
• 关键词：关键词堆砌
• 内容：内容结构、标题
• 图片：替代文本、颜色对比度、图片大小、图片格式
• 本地 SEO：NAP（名称、地址、电话）一致性、地理元数据
• 视频：VideoObject 模式、可访问性

以及更多。

审计过程会爬取网站，根据审计规则分析每个页面，并返回一份包含以下内容的综合报告：
- 总体健康评分 (0-100)
- 类别细分（核心 SEO、技术 SEO、内容、安全）
- 具体问题及其影响的 URL
- 失效链接检测
- 可操作的建议
- 规则具有错误、警告和通知等级别，并且有 1 到 10 的排名

使用时机

在以下情况下使用此技能：

• 分析网站健康状况
• 调试技术性 SEO 问题
• 修复上述所有问题
• 检查失效链接
• 验证元标签和结构化数据
• 生成网站审计报告
• 比较变更前后的网站健康状况
• 改进网站性能、可访问性、SEO、安全性等。

您应尽可能频繁地重新审计，以确保您的网站保持健康并表现良好。

先决条件

此技能要求已安装 squirrel CLI 并可在 PATH 中访问。

安装： squirrelscan.com/download

验证：

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. 运行审计（保存到数据库，显示控制台输出）
2. 以所需格式导出报告

# 步骤 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。

运行审计

运行审计时：

1. 呈现报告 - 向用户展示审计结果和评分
2. 提出修复建议 - 列出您可以修复的问题，并在进行更改前请求用户确认
3. 并行化已批准的修复 - 使用子代理进行批量内容编辑（替代文本、标题、描述）
4. 迭代 - 修复批次 → 重新审计 → 呈现结果 → 提出下一批次
5. 暂停以待判断 - 失效链接、结构性更改以及任何不明确的事项应标记为用户审查
6. 展示前后对比 - 在每个修复批次后呈现评分对比

• 迭代循环：修复一批问题后，重新审计并继续修复，直到：
• 评分达到目标（通常为 85 分以上），或

• 只剩下需要人工判断的问题（例如，“这个链接应该被删除吗？”）

• 平等对待所有修复：代码更改和内容更改同等重要。

• 并行化内容修复：对于影响多个文件的问题：

• 生成子代理以并行修复
• 示例：7 个文件需要替代文本 → 生成 1-2 个代理来修复所有文件

• 示例：30 个文件存在标题问题 → 生成代理进行批量编辑

• 完成标准：

• ✅ 所有错误已修复
• ✅ 所有警告已修复（或记录为需要人工审查）
• ✅ 重新审计确认了改进
• ✅ 向用户展示了前后对比

应用修复后，询问用户是否要审查更改。

评分目标

只有当评分高于 95（A 级）且覆盖率设置为 FULL（--coverage full）时，网站才被视为已完成和已修复。

问题类别

对于可并行化的修复：生成具有特定文件分配的子代理。

内容文件修复

许多问题需要编辑内容文件。这些与代码修复同等重要：

• 图片替代文本：为图片添加描述性替代文本
• 标题层级：修复跳过的标题级别
• 元描述：扩展 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

常用选项

审计命令选项

覆盖模式

根据您的审计需求选择覆盖模式：

表面模式是智能的 - 它会检测 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：上线前、全面分析、深度挖掘

报告命令选项

配置子命令

其他命令

自我管理命令

self 下的自我管理命令：

输出格式

控制台输出（默认）

audit 命令默认显示人类可读的控制台输出，带有彩色输出和进度指示器。

LLM 格式

要获取 LLM 优化的输出，请使用带有 --format llm 的 report 命令：

squirrel report <audit-id> --format llm

LLM 格式是一种紧凑的 XML/文本混合格式，针对令牌效率进行了优化（比冗长的 XML 小 40%）：

• 摘要：总体健康评分和关键指标
• 按类别划分的问题：按审计规则类别（核心 SEO、技术、内容、安全）分组
• 失效链接：失效的外部链接和内部链接列表
• 建议：带有修复建议的优先行动项

有关详细格式规范，请参阅 OUTPUT-FORMAT.md。

示例

示例 1：使用 LLM 输出进行快速网站审计

# 用户询问："检查 squirrelscan.com 的 SEO 问题"
squirrel audit https://squirrelscan.com --format llm

示例 2：大型网站的深度审计

# 用户询问："对我的博客进行彻底审计，最多 500 页"
squirrel audit https://myblog.com --max-pages 500 --format llm

示例 3：变更后的全新审计

# 用户询问："重新审计网站并忽略缓存结果"
squirrel audit https://example.com --refresh --format llm

示例 4：两步工作流程（重用之前的审计）

# 首先运行审计
squirrel audit https://example.com
# 从输出中记下审计 ID（例如，"a1b2c3d4"）

# 稍后，以不同格式导出
squirrel report a1b2c3d4 --format llm

输出

完成后，向用户提供您所做的所有更改的摘要。

故障排除

未找到 squirrel 命令

如果看到此错误，说明 squirrel 未安装或不在您的 PATH 中。

解决方案：
1. 安装 squirrel：squirrelscan.com/download
2. 确保 ~/.local/bin 在 PATH 中
3. 验证：squirrel --version

权限被拒绝

如果 squirrel 不可执行，请确保二进制文件具有执行权限。从 squirrelscan.com/download 重新安装