SEO Autopilot Agent Skill

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

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

核心价值

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

• 自动检测新报告（通过 git autofetch + fileCreated hook）
• 自动解析报告中的 Top 关键词和推荐动作
• 自动去重（跳过已有页面覆盖的关键词）
• 自动决策页面类型（落地页 vs 博客文章）
• 自动生成符合项目风格的页面代码
• 自动审计（Technical SEO + EEAT 双门检查）
• 自动推送（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） | ✅ |

安装方式

# 方式 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：

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

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

Step 3: 创建 fileCreated Hook

创建 Kiro hook 监听报告目录：

{
  "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：

{
  "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 会自适应解析不同格式的报告。

状态追踪格式

{
  "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