# SEO Check Skill

基于 Google 官方文档的 SEO 自动检测工具。

## 使用方法

在支持 skill 的 IDE 中，直接提问：

> "请使用 seo-analyzer 检查 https://example.com"

Agent 会自动完成：
1. 检查并安装 agent-browser（如需要）
2. 获取目标页面
3. 执行 SEO 检测
4. 输出详细报告

## 前置条件

**必须先安装 agent-browser skill**：

```bash
# 安装 agent-browser（用于抓取网页）
openskills read agent-browser

# 或从官网安装
# https://agent-browser.dev/
```

## 检查项目

| 类别 | 说明 |
|------|------|
| 技术要求 | HTTP 状态、HTTPS、noindex |
| 标题链接 | 存在性、唯一性、关键字堆砌 |
| Meta 描述 | 存在性、质量、长度 |
| 标题结构 | H1 存在和唯一性 |
| 链接可访问性 | 格式、锚文本 |
| 图片优化 | alt 属性 |
| 结构化数据 | JSON-LD/Microdata/RDFa |
| URL 结构 | 描述性、连字符 |
| Canonical URL | 规范链接 |
| 内容质量 | 内容长度 |
| 移动端友好性 | viewport |

## 命令行使用（可选）

```bash
# 自动模式（推荐）
python skills/seo-analyzer/scripts/seo_analyzer.py --auto <url>

# 从 HTML 文件分析
python skills/seo-analyzer/scripts/seo_analyzer.py page.html <url>
```

## 项目结构

```
seo-check-skill/
├── README.md
├── AGENTS.md
├── crawl_seo_docs.py          # Google 文档爬虫
├── crawl_google_seo_docs.py   # 备选爬虫
├── navigation-map.md         # 导航地图
├── seo-docs/                  # Google SEO 文档（中文）
└── skills/
    └── seo-analyzer/          # SEO 检测 skill
        ├── SKILL.md
        ├── references/
        │   └── seo-check-rules.md
        └── scripts/
            └── seo_analyzer.py
```

## 输出示例

```
============================================================
SEO 检测报告
============================================================

网址: https://example.com

概览:
  - 严重问题: 0
  - 警告: 3
  - 建议: 2

## 警告 (3)
1. [规范化] 缺少 canonical URL
2. [内容质量] 页面内容过少 (4 词)
3. [移动端友好性] 缺少 viewport meta 标签

## 已通过的检查 (6)
✓ 技术要求 - 无问题
✓ 标题链接 - 无问题
...
```
<img src="assets/images/SCR-20260121-ojda.png" width=1024 />


## 相关文档

- [agent-browser](https://agent-browser.dev/) - 网页抓取工具
- [seo-docs](https://github.com/loo-y/SEO-Analyzer-Skill/tree/main/seo-docs) - Google SEO 文档（中文）
- [Google Search 文档](https://developers.google.com/search/docs)