Communitygithub.com

网站审计

使用 squirrelscan CLI 对网站进行 SEO、性能、安全、技术、内容等 22 个类别、240 余条规则的审计。返回针对 LLM 优化的报告,包含健康评分、失效链接、元标签分析和可操作的建议。用于发现和评估网站或 Web 应用的问题与健康状况。

网站审计 是什么?

网站审计技能使 AI 智能体能够利用 squirrelscan CLI 对网站进行全面审计,覆盖从 SEO 到安全的 22 个类别、240 余条规则。它通过模拟浏览器和爬虫行为,分析网站结构与内容,返回包含健康评分(0-100)、各分类问题清单及可操作修复建议的 LLM 优化报告。该技能支持 macOS、Windows 和 Linux 平台,并提供了增量扫描(快速/表面/深度)模式,以适应从持续集成检查到发布前全量审计的不同场景。审计结果以紧凑的 XML/文本混合格式(LLM 格式)呈现,比传统 XML 节省约 40% 的 Token,并能通过差异模式(diff)跟踪网站健康度的回归变化。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/eli-ovops/skill-audit-website/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

网站审计技能

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

squirrelscan 提供了一个 CLI 工具 squirrel - 适用于 macOS、Windows 和 Linux。它通过模拟浏览器、搜索爬虫,并对照 240 多条规则分析网站的结构和内容,来执行全面的网站审计。

它会为您提供问题列表以及如何修复这些问题的建议。

链接

您可以使用以下模板查询任何规则的文档:

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 环境变量。

安装: 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. 并行化已批准的修复 - 将批量内容编辑(alt 文本、标题、描述)分配给子智能体
  4. 迭代 - 修复批次 → 重新审计 → 展示结果 → 提出下一批次
  5. 暂停以寻求判断 - 失效链接、结构性更改以及任何模棱两可的问题都应标记给用户审查
  6. 展示前后对比 - 在每个修复批次后展示分数比较
  • 迭代循环:在修复一批问题后,重新审计并继续修复,直到:

    • 分数达到目标(通常为 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、llmconsole
--coverage <mode>-C <mode>覆盖模式:quick、surface、fullsurface
--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>覆盖项目名称来自配置

覆盖模式

根据审计需求选择覆盖模式:

模式默认页面数行为适用场景
quick25仅种子 + 站点地图,无链接发现CI 检查、快速健康检查
surface100每个 URL 模式一个样本常规审计(默认)
full500爬取所有内容直至上限深度分析

表面模式很智能 - 它会检测 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

最佳实践

  1. 始终使用 --format llm 以获得针对 AI 智能体优化的输出
  2. 先进行表面扫描,然后再进行深度扫描
  3. 优先审计在线网站以获得真实结果
  4. 并行化内容修复以提高效率
  5. 迭代:修复 → 重新审计 → 展示进度
  6. 使用差异检测回归
  7. 达到 95+ 分且 覆盖范围 FULL 后才认为完成
  8. 应用修复后验证代码仍能构建
  9. 检查代码中引用的 URL 是否正确 - 不要让用户重构他们的 URL 模式,除非修复了 URL 问题。

相关技能