网站审计技能

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

squirrel 支持 macOS、Windows、Linux，通过模拟浏览器与搜索爬虫，结合 140+ 条规则分析站点结构与内容，输出问题列表及修复建议。

链接

官网：https://squirrelscan.com
文档（含规则说明）：https://docs.squirrelscan.com

规则文档模板：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 llm

2. 大站深度审计

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
# 记下输出的 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

audit-website