SEO 自动驾驶

将关键词研究报告自动转化为已部署的 SEO 页面，全程无需人工干预。

功能说明

当外部 Agent（例如 OpenClaw）定期生成关键词研究报告并推送至 Git 仓库时，本技能将自动完成其余全部工作：

1. 检测新报告（通过 git autofetch + fileCreated 钩子）
2. 从报告中解析出核心关键词及推荐操作项
3. 与现有页面进行语义去重
4. 判定页面类型（落地页 vs 博客文章）
5. 按项目风格生成匹配的页面代码
6. 执行 SEO 审计（含技术性检查 + EEAT 评估）
7. 推送至 Git（触发自动部署）

自动化流程

外部 Agent 生成报告 -> git push
  -> IDE 每 2 分钟自动拉取（autofetch）
  -> fileCreated 钩子触发 Agent
  -> Agent 执行 8 阶段处理流水线
  -> git push -> 自动部署至生产环境

配置步骤（由 Agent 执行）

步骤 1：识别项目结构

需识别以下内容：

• 框架类型（Next.js / Astro / Nuxt / 静态站点）
• 页面系统（页面如何创建）
• 博客系统（文章如何存储）
• 导航/站点地图注册方式
• 现有 SEO 模式（元数据、JSON-LD、canonical 标签等）
• 报告目录路径

步骤 2：配置 Git 自动拉取

更新 .vscode/settings.json：

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

仅合并上述键值，不得覆盖已有配置项。

步骤 3：创建 fileCreated 钩子

创建一个监听报告目录的 Kiro 钩子：

{
  "name": "SEO Autopilot",
  "version": "1.0.0",
  "when": {
    "type": "fileCreated",
    "patterns": ["{report_dir}/*.md"]
  },
  "then": {
    "type": "askAgent",
    "prompt": "检测到新的关键词报告。执行完整的 #seo-autopilot 流水线：解析报告 -> 去重 -> 判定页面类型 -> 生成页面（最多 3 篇） -> 注册导航与站点地图 -> SEO 审计 -> git commit 并 push -> 更新 processed.json。"
  }
}

步骤 4：创建引导文件（Steering File）

创建 .kiro/steering/seo-autopilot.md，其中包含完整的 8 阶段处理指令。

步骤 5：初始化状态追踪

创建 {report_dir}/processed.json：

{ "processed": [] }

步骤 6：验证配置

• settings.json 中已启用 autofetch + pullOnFetch
• 钩子文件已创建
• 引导文件已创建
• processed.json 已初始化
• 至少存在一份可用于测试的报告

步骤 7：执行测试运行

在一份现有报告上完整运行一次流水线，验证所有环节是否正常工作。

8 阶段处理流水线

阶段 0：发现新报告

读取 processed.json -> 扫描报告目录 -> 过滤未处理的报告

阶段 1：解析报告

提取核心关键词、搜索意图、竞争强度、推荐页面类型

阶段 2：去重处理

比对现有页面（导航栏 + 博客），跳过已被覆盖的关键词

阶段 3：判定页面类型

• 交易型 / 情感型关键词 -> 落地页
• 信息型关键词 -> 博客文章
• 每份报告最多生成 3 个页面

阶段 4：生成内容

按项目既定模式生成页面代码（含元数据、JSON-LD、FAQ 区块、站内链接、CTA 等）

阶段 5：注册页面

添加至导航系统 + 站点地图

阶段 6：SEO 审计

• 标题长度 < 60 字符，且含主关键词
• 描述长度 < 160 字符
• 设置 canonical URL
• 注入 JSON-LD WebPage + FAQ 结构化数据
• H1 标签唯一且含关键词
• 插入 3–5 个站内链接
• 添加指向核心转化页的 CTA

阶段 7：提交并推送

git add -> commit -> push

阶段 8：更新状态

在 processed.json 中记录该报告及所创建的页面

报告格式要求

报告为 Markdown 格式，至少满足以下任一条件：

• 包含名为 “Top N keywords” 或 “Recommended actions” 的章节，并列出关键词及优先级
• 包含关键词 / 意图 / 竞争强度 / 推荐操作 的表格

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" }
      ]
    }
  ]
}

框架适配表

限制条件

• IDE 必须保持开启状态（钩子仅在 IDE 活跃时触发）
• 每份报告最多生成 3 个页面（防止质量下降）
• 采用语义级去重，而非简单 URL 匹配
• 仅创建新页面，绝不会覆盖已有内容
• Git 操作依赖网络连接

前置依赖