squirrelscan/squirrelscan
GitHub: squirrelscan/squirrelscan
一款专为 AI 编程 Agent 设计的网站 QA 审计工具,提供覆盖 SEO、性能、安全和无障碍等维度的 249 条以上检测规则。
Stars: 242 | Forks: 9

# squirrelscan
**专为你的编程 AI Agent 打造的网站 QA 工具**
squirrelscan 会审计你网站的 SEO、性能、安全性、无障碍访问以及 agent 体验问题,并为你的编程 AI Agent 提供精确的修复方案。你可以在 CLI 中、编程 AI Agent 内部、云端或通过 MCP 运行它。本地审计始终免费。
## 功能特性
- **240+ 条规则,21 个类别** - 全面覆盖 SEO、无障碍访问、性能和安全
- **AI 原生设计** - 为 Claude Code、Cursor 及任何 AI 助手提供 LLM 优化的输出
- **智能增量爬取** - 支持 ETag、Last-Modified、内容哈希。可从检查点恢复。
- **开发者优先的 CLI** - 单一二进制文件,零依赖,支持 shell 补全和自更新
- **E-E-A-T 审计** - 专为 Experience(经验)、Expertise(专业知识)、Authority(权威性)、Trust(信任度)设计的规则
- **爬取历史与变更** - 追踪网站演变,对比爬取结果,发现性能衰退
- **多种输出格式** - Console、JSON、HTML、Markdown、Text、LLM、XML
## 三种使用方式
### 1. 面向人类的 CLI
直接在终端中运行审计:
```
squirrel audit example.com
```
### 2. AI 编程 Agent 技能
安装技能以启用自动化工作流:
```
npx skills install squirrelscan/skills
```
使用斜杠命令:
```
/audit-website
```
或者更具体地提示你的 AI agent:
```
Use the audit-website skill to audit this site and fix all issues but only crawl 10 pages
```
更多信息请查看[技能仓库](https://github.com/squirrelscan/skills)和我们的[AI Agent 入门](https://docs.squirrelscan.com/agents)文档。
### 3. 管道传输至 AI agent
将纯净的输出通过管道传输给任何 AI 助手:
```
squirrel audit example.com --format llm | claude
```
## 安装说明
**macOS / Linux:**
```
curl -fsSL https://install.squirrelscan.com | bash
```
**Windows:**
```
iwr -useb https://install.squirrelscan.com/install.ps1 | iex
```
**npm (所有平台):**
```
npm install -g squirrelscan
```
**npx (免安装运行):**
```
npx squirrelscan audit example.com
```
## 快速开始
```
# 审计网站
squirrel audit https://example.com
# 生成 HTML 报告
squirrel audit https://example.com -f html -o report.html
# 通过管道传递给 Claude 进行 AI 分析
squirrel audit https://example.com --format llm | claude
# 限制页面数量以加快获取结果
squirrel audit https://example.com -m 10
```
## 资源
- **网站:** [squirrelscan.com](https://squirrelscan.com)
- **文档:** [docs.squirrelscan.com](https://docs.squirrelscan.com)
- **AI Agent 技能:** [github.com/squirrelscan/skills](https://github.com/squirrelscan/skills)
## 规则类别
| 类别 | 规则数 | 关注点 |
|----------|-------|-------|
| 无障碍访问 | 56 | ARIA、按钮/输入框名称、landmark、列表、表格、焦点 |
| 性能 | 24 | Core Web Vitals、压缩、缓存、JS 优化 |
| 可爬取性 | 15 | Robots.txt、站点地图、可索引性 |
| 安全 | 15 | HTTPS、CSP、cookies、泄露的密钥(96 种模式) |
| 链接 | 15 | 失效链接、重定向、锚文本 |
| 图片 | 15 | Alt 文本、格式、懒加载、优化 |
| 内容 | 15 | 可读性、时效性、字数 |
| E-E-A-T | 14 | 权威性、信任度、专业知识信号 |
| 核心 | 13 | Meta 标签、canonical、doctype、charset |
| 结构化数据 | 11 | JSON-LD、schema 验证 |
| URL 结构 | 8 | 长度、格式、参数 |
| 移动端 | 6 | Viewport、点击目标、响应式 |
| 社交媒体 | 4 | Open Graph、Twitter Cards |
| SEO | 4 | Meta robots、可索引性 |
| 视频 | 3 | Schema、字幕、缩略图 |
| 本地 SEO | 3 | NAP、地理标签、服务区域 |
| 法律 | 3 | 隐私政策、Cookie 同意 |
| 国际化 | 2 | Hreflang、lang 属性 |
| 分析 | 2 | GTM、同意模式 |
| AI 检测 | 2 | AI 内容信号 |
| 广告拦截检测 | 2 | 被拦截的元素、跟踪 |
**总计:涵盖 21 个类别的 249+ 条规则**
请查看[规则参考](https://docs.squirrelscan.com/rules)了解完整详情。
## AI Agent 集成
squirrelscan 专为自动化 AI 工作流而设计:
```
# 为 Claude Code、Cursor 等安装该 skill
npx skills install squirrelscan/skills
```
AI 提示词示例:
- "审计 example.com 并修复所有严重问题"
- "检查我最近更改后是否出现了 SEO 衰退"
- "生成一份全面的审计报告,并进入计划模式以修复问题"
- "仅审计 /blog 板块,并重点关注 E-E-A-T 信号"
- "运行一项以安全为中心的审计,并检查是否存在泄露的密钥"
请查看 [AI Agent 集成文档](https://docs.squirrelscan.com/agents)了解进阶工作流。
## 输出格式
| 格式 | 标志 | 使用场景 |
|--------|------|----------|
| Console | (默认) | 人类可读的终端输出 |
| JSON | `-f json` | CI/CD、程序化处理 |
| HTML | `-f html` | 可视化报告,便于分享 |
| Markdown | `-f markdown` | 文档、GitHub |
| Text | `-f text` | 用于管道传输给 LLM 的纯净输出 |
| LLM | `-f llm` | LLM 优化输出 |
## 开发状态
squirrelscan 目前处于**活跃 Beta 阶段**。可能会有快速迭代和破坏性更新。欢迎提供反馈和问题报告!
## 链接
- [网站](https://squirrelscan.com)
- [文档](https://docs.squirrelscan.com)
- [AI Agent 技能](https://github.com/squirrelscan/skills)
- [分享反馈](https://squirrelscan.com/feedback)
- [Bug、问题与功能请求](https://github.com/squirrelscan/squirrelscan/issues)
- [Twitter/X](https://x.com/squirrelscan_)
标签:MITM代理, SEO优化, Syscall, Web开发, 代码质量审计, 开发辅助工具, 文档结构分析, 无障碍访问, 暗色界面