audit-website

网站审计技能

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

squirrelscan 提供了一个名为 squirrel 的 cli 工具，可用于 macos、windows 和 linux。它通过模拟浏览器和搜索爬虫，并根据 140 多条规则分析网站结构和内容，对网站进行全面审计。

它会提供问题列表以及修复建议。

链接

• 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 agents 按照 20 个类别中的 140 多条规则审计网站，包括：

• SEO 问题：Meta 标签、标题、描述、规范 URL、Open Graph 标签
• 技术问题：失效链接、重定向链、页面速度、移动设备友好性
• 性能：页面加载时间、资源使用情况、缓存
• 内容质量：标题结构、图片替代文本、内容分析
• 安全性：泄露的机密信息、HTTPS 使用情况、安全标头、混合内容
• 无障碍性：替代文本、颜色对比度、键盘导航
• 易用性：表单验证、错误处理、用户流程
• 链接：检查失效的内部和外部链接
• E-E-A-T：专业性、经验、权威性、可信度
• 用户体验：用户流程、错误处理、表单验证
• 移动端：检查移动设备友好性、响应式设计、便于触控的元素
• 可抓取性：检查可抓取性、robots.txt、sitemap.xml 等
• Schema：Schema.org 标记、结构化数据、富媒体摘要
• 法律：遵守法律要求、隐私政策、服务条款
• 社交：Open Graph、Twitter Cards，以及 Schema、摘要等的验证
• URL 结构：长度、连字符、关键词
• 关键词：关键词堆砌
• 内容：内容结构、标题
• 图片：替代文本、颜色对比度、图片尺寸、图片格式
• 本地 SEO：NAP 一致性、地理元数据
• 视频：VideoObject Schema、无障碍性

等等！

审计会抓取网站，按照审计规则分析每个页面，并返回一份全面的报告，其中包括：

• 整体健康评分（0-100）
• 各类别细分（核心 SEO、技术 SEO、内容、安全）
• 标明受影响 URL 的具体问题
• 失效链接检测
• 可执行的建议

适用场景

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

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

前置条件

此技能要求安装 squirrel CLI，并确保其位于 PATH 中。

安装

如果尚未安装 squirrel，可以使用以下方式安装：

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\
• 将 squirrel 添加到 PATH

如果使用命令提示符，可能需要重启终端，PATH 更改才会生效。

验证安装

检查 squirrel 是否已安装且可正常使用：

squirrel --version

设置

运行 squirrel init 会在当前目录中创建 squirrel.toml 配置文件。

每个项目都应有一个用于数据库的 squirrel 项目名称。默认情况下，该名称是你要审计的网站名称，但你也可以自行设置，以便将某个项目的所有审计结果放在同一个数据库中。

你可以在初始化时通过以下方式设置：

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

你应始终优先选择 llm 格式选项；该格式专为你打造，能够提供详尽且精简的输出。

如果用户没有提供要审计的网站，请根据本地目录中的信息和环境变量推断可能的网站（例如，已关联的 vercel 项目、内存中的引用或代码中的引用）。

如果运行所在目录提供了运行或重启本地开发服务器的方法，请针对该服务器运行审计。

如果发现有多个可供审计的网站，请提示用户选择要审计的网站。

如果没有可供审计的网站（无论是本地网站还是网上可发现的网站），请询问用户想要审计哪个 URL。

你应优先审计线上网站——只有在那里，我们才能真实了解网站的性能或渲染问题。

如果本地网站和线上网站都可供审计，请提示用户选择，并建议他们选择线上网站。

你可以根据对线上网站进行审计的结果，在本地代码中应用修复。

规划任务范围时，应将任务拆分，以便通过多个子 Agent 并行执行，加快修复速度。

实施修复时，应利用子 Agent 加快修复过程。

完成后，如果环境中有可用工具，请对生成的代码运行类型检查和格式化（例如，Python 使用 ruff，TypeScript 使用 biome 和 tsc 等）。

基本工作流

审计分为两个步骤：

1. 运行审计（保存到数据库并显示控制台输出）
2. 导出报告（选择所需格式）

# Step 1: Run audit (default: console output)
squirrel audit https://example.com

# Step 2: Export as LLM format
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

常用选项

审计命令选项

选项	别名	说明	默认值
--format <fmt>	-f <fmt>	输出格式：console、text、json、html、markdown、llm	console
--max-pages <n>	-m <n>	最大爬取页面数（最多 500）	500
--refresh	-r	忽略缓存，重新获取所有页面	false
--resume	-	继续被中断的爬取	false
--verbose	-v	详细输出	false
--debug	-	调试日志	false

报告命令选项

选项	别名	说明
--format <fmt>	-f <fmt>	输出格式：console、text、json、html、markdown、xml、llm

输出格式

控制台输出（默认）

默认情况下，audit 命令会显示易于阅读的控制台输出，包含彩色输出和进度指示。

LLM 格式

若要获取针对大模型优化的输出，请使用带有 --format llm 的 report 命令：

squirrel report <audit-id> --format llm

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

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

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

示例

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

# User asks: "Check squirrelscan.com for SEO issues"
squirrel audit https://squirrelscan.com --format llm

示例 2：对大型网站进行深度审计

# User asks: "Do a thorough audit of my blog with up to 500 pages"
squirrel audit https://myblog.com --max-pages 500 --format llm

示例 3：更改后重新审计

# User asks: "Re-audit the site and ignore cached results"
squirrel audit https://example.com --refresh --format llm

示例 4：两步工作流（重复使用之前的审计结果）

# First run an audit
squirrel audit https://example.com
# Note the audit ID from output (e.g., "a1b2c3d4")

# Later, export in different format
squirrel report a1b2c3d4 --format llm

输出

完成后，向用户总结你所做的所有更改。

故障排除

找不到 squirrel 命令

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

解决方案：

1. 安装 squirrel：curl -fsSL https://squirrelscan.com/install | bash
2. 添加到 PATH：export PATH="$HOME/.local/bin:$PATH"
3. 验证：squirrel --version

权限被拒绝

如果 squirrel 不可执行：

chmod +x ~/.local/bin/squirrel

爬取超时或运行缓慢

对于非常庞大的网站，审计可能需要几分钟。使用 --verbose 查看进度：

squirrel audit https://example.com --format llm --verbose

URL 无效

确保 URL 包含协议（http:// 或 https://）：

# ✗ Wrong
squirrel audit example.com

# ✓ Correct
squirrel audit https://example.com

工作原理

1. 爬取：从基础 URL 开始发现并获取页面
2. 分析：对每个页面运行审计规则
3. 外部链接：检查外部链接是否可用
4. 报告：生成包含检查结果的 LLM 优化报告

审计结果会存储在本地数据库中，之后可以通过 squirrel report 命令检索。

其他资源

• 输出格式参考：OUTPUT-FORMAT.md
• squirrelscan 文档：https://docs.squirrelscan.com
• CLI 帮助：squirrel audit --help