网站审计技能
使用 squirrelscan 的 CLI 工具 squirrel，对网站进行 SEO、技术、内容、性能和安全性审计。
squirrel 支持 macOS、Windows、Linux，通过模拟浏览器与搜索爬虫，结合 140+ 条规则分析站点结构与内容，输出问题列表及修复建议。
链接
规则文档模板：https://docs.squirrelscan.com/rules/{rule_category}/{rule_id} 示例：https://docs.squirrelscan.com/rules/links/external-links
本技能能做什么
支持 AI 智能体按 20+ 类别、140+ 条规则审计网站，包括：
- SEO：Meta 标签、title、description、canonical、Open Graph
- 技术：死链、重定向链、页面速度、移动友好性
- 性能：加载时间、资源使用、缓存
- 内容：标题结构、图片 alt、内容分析
- 安全：泄露密钥、HTTPS、安全头、混合内容
- 无障碍：alt、色彩对比、键盘导航
- 可用性：表单校验、错误处理、用户流程
- 链接：内外链死链检测
- E-E-A-T：经验、专业、权威、可信度
- 移动端：移动友好、响应式、触控元素
- 可抓取性：robots.txt、sitemap.xml 等
- Schema：Schema.org、结构化数据、富摘要
- 法律：隐私政策、服务条款等合规
- 社交：Open Graph、Twitter 卡片及 schema 校验
- URL 结构：长度、连字符、关键词
- 关键词：堆砌检测
- 图片：alt、对比度、尺寸、格式
- 本地 SEO：NAP 一致性、地理元数据
- 视频：VideoObject schema、无障碍
审计会爬取站点、按规则分析页面，并生成报告，包含：
- 整体健康分（0–100）
- 按类别 breakdown（核心 SEO、技术 SEO、内容、安全等）
- 具体问题及受影响 URL
- 死链列表
- 可执行的改进建议
何时使用
在以下场景使用本技能：
- 分析网站健康度
- 排查技术 SEO 问题
- 修复上述各类问题
- 检查死链
- 校验 meta 与结构化数据
- 生成站点审计报告
- 对比改版前后健康度
- 提升性能、无障碍、SEO、安全等
前置条件
本技能依赖 squirrel CLI，需已安装并加入 PATH。
安装（macOS / Linux）
curl -fsSL https://squirrelscan.com/install | bash将会：
- 下载最新二进制
- 安装到
~/.local/share/squirrel/releases/{version}/ - 在
~/.local/bin/squirrel创建软链 - 在
~/.squirrel/settings.json初始化配置
若 ~/.local/bin 不在 PATH 中，在 shell 配置里添加：
export PATH="$HOME/.local/bin:$PATH"Windows 安装
PowerShell：
irm https://squirrelscan.com/install.ps1 | iex将下载并安装到 %LOCALAPPDATA%\squirrel\，并加入 PATH。若用 CMD，可能需要重启终端使 PATH 生效。
验证安装
squirrel --version配置
在项目目录执行 squirrel init 会生成 squirrel.toml。
每个项目应有唯一的 project name（默认可用被审计站点名），用于数据库区分多次审计：
squirrel init --project-name my-project或：
squirrel config set project.name my-project若当前目录没有 squirrel.toml，必须先执行 squirrel init，并用 -n 指定项目名（可推断）。 项目名用于数据库标识，存储在 ~/.squirrel/projects/。
使用方式
概述
有三个子命令，结果都会写入本地项目数据库：
- crawl：执行或继续爬取
- analyze：分析爬取结果
- report：按指定格式输出报告（llm、text、console、html 等）
audit 是上述三步的封装，按顺序执行：
squirrel audit https://example.com --format llm优先使用 --format llm：为 LLM 设计的紧凑、完整输出格式。
审计目标选择
- 若用户未提供 URL：从当前目录、环境变量（如 Vercel 项目、记忆或代码中的引用）推断可能站点。
- 若当前目录能启动本地 dev 服务：可对本地站点做审计。
- 若发现多个可审计站点：让用户选择。
- 若无法推断任何站点：询问用户要审计的 URL。
优先审计线上站点，更能反映真实性能与渲染问题。若同时有本地与线上，提示用户选择，并建议选线上。可在线上审计发现问题后，在本地代码中修复。
实施修复时
- 可将大范围修复拆成可并行的子任务，用 subagent 加速。
- 修复完成后，如环境有 typecheck/format 工具（如 ruff、biome、tsc），对生成代码跑一遍。
基本流程
- 执行审计（写入数据库，并输出到终端）
- 按格式导出报告
# 1. 执行审计（默认 console 输出）
squirrel audit https://example.com
# 2. 导出为 LLM 格式
squirrel report <audit-id> --format llm常用选项
爬取更多页面：
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命令选项
audit
| 选项 | 别名 | 说明 | 默认 |
|---|---|---|---|
--format <fmt> | -f | 输出格式：console, text, json, html, markdown, llm | console |
--max-pages <n> | -m | 最大爬取页数（最大 500） | 500 |
--refresh | -r | 忽略缓存，全部重新抓取 | false |
--resume | - | 恢复中断的爬取 | false |
--verbose | -v | 详细输出 | false |
--debug | - | 调试日志 | false |
report
| 选项 | 别名 | 说明 |
|---|---|---|
--format <fmt> | -f | console, text, json, html, markdown, xml, llm |
输出格式
- console（默认）：彩色、带进度的可读输出。
- llm：面向 LLM 的紧凑 XML/文本混合，token 更省（比冗长 XML 约小 40%），包含：
- 摘要：健康分与核心指标 - 按规则分类的问题（核心 SEO、技术、内容、安全等） - 死链列表（内链 + 外链） - 按优先级排列的改进建议
示例
1. 快速站点审计（LLM 输出）
squirrel audit https://squirrelscan.com --format llm2. 大站深度审计
squirrel audit https://myblog.com --max-pages 500 --format llm3. 改版后重新审计（忽略缓存）
squirrel audit https://example.com --refresh --format llm4. 两步流程（复用已有审计）
squirrel audit https://example.com
# 记下输出的 audit-id，如 a1b2c3d4
squirrel report a1b2c3d4 --format llm输出
审计与修复完成后，给用户一个所有改动的摘要。
故障排除
squirrel 找不到
- 安装：
curl -fsSL https://squirrelscan.com/install | bash - 加入 PATH：
export PATH="$HOME/.local/bin:$PATH" - 验证：
squirrel --version
权限错误
chmod +x ~/.local/bin/squirrel爬取超时或很慢
大站可能需较长时间，加 --verbose 查看进度：
squirrel audit https://example.com --format llm --verbose无效 URL
务必包含协议（http:// 或 https://）：
# ✗ 错误
squirrel audit example.com
# ✓ 正确
squirrel audit https://example.com工作流程
- Crawl：从基础 URL 发现并抓取页面
- Analyze：对每页执行审计规则
- External Links：检查外链可用性
- Report：生成 LLM 优化报告
审计结果保存在本地数据库，之后可用 squirrel report 按不同格式导出。
延伸资源
- squirrelscan 文档
- CLI 帮助：
squirrel audit --help