网站审计技能

使用 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. 执行审计（写入数据库，并输出到终端）
2. 按格式导出报告

# 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

report

输出格式

• 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 找不到

1. 安装：curl -fsSL https://squirrelscan.com/install | bash
2. 加入 PATH：export PATH="$HOME/.local/bin:$PATH"
3. 验证：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

工作流程

1. Crawl：从基础 URL 发现并抓取页面
2. Analyze：对每页执行审计规则
3. External Links：检查外链可用性
4. Report：生成 LLM 优化报告

审计结果保存在本地数据库，之后可用 squirrel report 按不同格式导出。

延伸资源

• squirrelscan 文档
• CLI 帮助：squirrel audit --help