---
name: seo-autopilot
description: 全自动 SEO 内容新鲜度引擎。监听关键词研究报告目录，自动生成落地页和博客文章，运行 SEO 审计后推送更新。适用于任何需要定期更新内容以保持 Google 排名新鲜度的网站项目。支持 Next.js / Astro / Nuxt 等主流框架。
metadata:
  keywords: seo automation, keyword report, content freshness, landing page generation, blog generation, google rankings, automated deployment, git autopull
---

# SEO Autopilot — 全自动内容新鲜度引擎

> 把关键词研究报告变成已部署的 SEO 页面，零人工干预。

## 核心价值

当你有一个外部 Agent（如 OpenClaw）定期生成关键词研究报告并推送到 Git 仓库时，这个 skill 会：

1. **自动检测**新报告（通过 git autofetch + fileCreated hook）
2. **自动解析**报告中的 Top 关键词和推荐动作
3. **自动去重**（跳过已有页面覆盖的关键词）
4. **自动决策**页面类型（落地页 vs 博客文章）
5. **自动生成**符合项目风格的页面代码
6. **自动审计**（Technical SEO + EEAT 双门检查）
7. **自动推送**（git commit + push → 触发自动部署）

**时间节省**: 从报告到页面上线，传统方式需要 2-4 小时/页，自动化后 < 5 分钟/页。

## 完整自动化链路

```
┌─────────────────────────────────────────┐
│  外部 Agent（OpenClaw 等）              │
│  生成关键词报告 → git push              │
└──────────────┬──────────────────────────┘
               │ (git push to main)
               ▼
┌─────────────────────────────────────────┐
│  IDE（Kiro / Claude Code / Cursor）     │
│  git.autofetch: true (每 2 分钟)        │
│  git.pullOnFetch: true                  │
│  → 自动拉取新 commit                    │
└──────────────┬──────────────────────────┘
               │ (检测到新 .md 文件)
               ▼
┌─────────────────────────────────────────┐
│  fileCreated Hook 触发                  │
│  Pattern: {report_dir}/*.md             │
│  → 启动 Agent 执行流水线                │
└──────────────┬──────────────────────────┘
               │
               ▼
┌─────────────────────────────────────────┐
│  Agent 执行 8 阶段流水线               │
│  解析 → 去重 → 决策 → 生成 → 审计      │
│  → git commit + push                    │
└──────────────┬──────────────────────────┘
               │ (git push to main)
               ▼
┌─────────────────────────────────────────┐
│  自动部署（Vercel / Cloudflare / etc）  │
│  新页面上线生产环境                      │
└─────────────────────────────────────────┘
```

## 使用场景

- 独立站 SEO 内容持续更新（保持 Google 排名新鲜度）
- 多站点批量内容生产
- 关键词研究 → 页面上线的全链路自动化
- 任何需要定期发布新 SEO 内容的项目

## 前置依赖

| 依赖 | 说明 | 必须？ |
|------|------|--------|
| Git 仓库 | GitHub / GitLab / Bitbucket | ✅ |
| 外部关键词报告源 | 定期推送 .md 报告到仓库的 Agent 或脚本 | ✅ |
| Web 框架 | Next.js / Astro / Nuxt / 静态站 | ✅ |
| 自动部署 | Vercel / Cloudflare Pages / Netlify | ✅ |
| IDE 保持打开 | Kiro / Claude Code / Cursor（需要运行 hook） | ✅ |

## 安装方式

```bash
# 方式 1: 只复制这个 skill
cp -r 7deer_skills/seo-autopilot .agent/skills/seo-autopilot

# 方式 2: 克隆整个技能库
git clone https://github.com/kennyzir/7deer_skills.git .agent/skills
```

## 启动命令

安装后，对 Agent 说：

```
启动 SEO autopilot，报告目录是 keyword-research/
```

或英文：

```
Set up SEO autopilot, report directory is keyword-research/
```

Agent 会自动执行 7 步 setup 流程。

---

## Setup 流程（Agent 自动执行）

### Step 1: 发现项目结构

Agent 需要识别：
- 框架类型（Next.js / Astro / Nuxt / 静态）
- 页面系统（如何创建页面）
- 博客系统（如何存储博客文章）
- 导航/Sitemap 注册方式
- 现有 SEO 模式（metadata、JSON-LD、canonical）
- 关键词报告目录位置

### Step 2: 配置 Git 自动拉取

创建或更新 `.vscode/settings.json`：

```json
{
  "git.autofetch": true,
  "git.autofetchPeriod": 120,
  "git.autoStash": true,
  "git.pullOnFetch": true
}
```

> ⚠️ 不要覆盖已有设置，只合并这些 key。

### Step 3: 创建 fileCreated Hook

创建 Kiro hook 监听报告目录：

```json
{
  "name": "SEO Autopilot",
  "version": "1.0.0",
  "when": {
    "type": "fileCreated",
    "patterns": ["{report_dir}/*.md"]
  },
  "then": {
    "type": "askAgent",
    "prompt": "新的关键词研究报告已检测到。按照 #seo-autopilot steering 执行完整流水线：解析报告 → 去重 → 决策页面类型 → 生成页面(最多3个) → 注册 navigation + sitemap → SEO 审计 → git commit and push → 更新 processed.json。"
  }
}
```

### Step 4: 创建 Steering 文件

创建 `.kiro/steering/seo-autopilot.md`，包含完整的 8 阶段处理指令（见 references/steering-template.md）。

### Step 5: 初始化状态追踪

创建 `{report_dir}/processed.json`：

```json
{
  "processed": []
}
```

### Step 6: 验证

- [ ] `.vscode/settings.json` 已配置 autofetch + pullOnFetch
- [ ] Hook 文件已创建
- [ ] Steering 文件已创建
- [ ] processed.json 已初始化
- [ ] 至少有一份报告可用于测试

### Step 7: 测试运行

用现有报告执行一次完整流水线，验证所有环节正常。

---

## 8 阶段处理流水线

### Phase 0: 发现新报告
读取 processed.json → 扫描报告目录 → 过滤未处理的报告

### Phase 1: 解析报告
提取 Top 关键词、搜索意图、竞争度、推荐页面类型

### Phase 2: 去重
对比现有页面（navigation + blog），跳过已覆盖的关键词

### Phase 3: 页面类型决策
- Transactional / Emotional → 落地页
- Informational → 博客文章
- 每次报告最多生成 3 个页面

### Phase 4: 内容生成
按项目现有模式生成页面代码（metadata、JSON-LD、FAQ、内链、CTA）

### Phase 5: 注册
添加到 navigation 系统 + sitemap

### Phase 6: SEO 审计
- Title < 60 chars，含主关键词
- Description < 160 chars
- Canonical URL
- JSON-LD WebPage + FAQ schema
- H1 唯一且含关键词
- 3-5 个内链
- CTA 到主转化页面

### Phase 7: 提交推送
git add → commit → push

### Phase 8: 更新状态
更新 processed.json，记录已处理报告和生成的页面

---

## 关键词报告格式要求

报告为 Markdown 格式，需包含以下内容之一：

- "Top N 关键词" 或 "推荐动作" 章节，列出关键词和优先级
- 包含 keyword / intent / competition / action 列的表格

Agent 会自适应解析不同格式的报告。

## 状态追踪格式

```json
{
  "processed": [
    {
      "report": "2026-04-10-keyword-research.md",
      "processedAt": "2026-04-10",
      "pagesCreated": [
        { "type": "landing", "slug": "/personalized-tarot", "keyword": "personalized tarot card generator" }
      ],
      "skipped": [
        { "keyword": "oracle card generator AI", "reason": "Already covered by /ai-oracle-card-generator" }
      ]
    }
  ]
}
```

---

## 适配不同框架

| 框架 | 页面位置 | 博客位置 | Sitemap |
|------|---------|---------|---------|
| Next.js (App Router) | `app/{slug}/page.tsx` | `lib/blog.ts` 或 `content/blog/*.mdx` | `app/sitemap.ts` |
| Next.js (Pages Router) | `pages/{slug}.tsx` | `pages/blog/[slug].tsx` | `next-sitemap.config.js` |
| Astro | `src/pages/{slug}.astro` | `src/content/blog/*.md` | `astro.config.mjs` |
| Nuxt | `pages/{slug}.vue` | `content/blog/*.md` | `nuxt.config.ts` |
| 静态 HTML | `{slug}/index.html` | `blog/{slug}/index.html` | `sitemap.xml` |

---

## 限制与注意事项

- **IDE 必须保持打开**: Hook 只在 IDE 运行时生效
- **每次最多 3 页**: 避免内容质量下降
- **语义去重**: 不只是 URL 匹配，还要判断语义重叠
- **不覆盖已有页面**: 只创建新页面，不修改现有内容
- **需要网络连接**: git pull/push 需要网络

## 常见问题

| 问题 | 解决方案 |
|------|---------|
| Hook 没触发 | 检查 filePatterns 是否匹配报告文件名 |
| 自动 pull 不工作 | 重启 IDE，确认 settings.json 已加载 |
| 页面风格不匹配 | 更新 steering 文件中的示例页面引用 |
| 重复生成页面 | 检查 processed.json 是否正确更新 |
| git push 失败 | 检查 git 凭证 / SSH key 配置 |
| Build 失败 | 确保引用的 mock 数据 / 组件在远端存在 |

---

## 实战案例

CardMuse.com 使用此 skill 实现了：
- OpenClaw Agent 每 2 天生成关键词报告
- Kiro 自动拉取 + 处理报告
- 每次报告生成 2-3 个新 SEO 页面
- Vercel 自动部署
- 从报告推送到页面上线 < 5 分钟

---

## License

MIT