难度：⭐⭐☆☆☆（入门） | 时长：10-15 分钟 | 收获：掌握 AI 自动生成 SEO 优化博客的完整流程
目标读者
本文面向 1-3 年开发经验的技术人员，你不需要是 SEO 专家，只需要：
- 熟悉命令行基本操作
- 对 AI 写作和 SEO 优化感兴趣
- 想了解如何用 AI 批量生产博客内容
TIP
SEO Machine 是一个开源的 Claude Code 工作空间，专门用于创建 SEO 优化的博客内容。它结合了自定义命令、专业 Agent 和 Python 分析模块，能够研究、写作、优化和发布文章。
核心依赖与环境
在开始之前，我们先准备好开发环境。你需要安装以下软件：
| 依赖 | 说明 |
|---|---|
| Python 3.x | 项目运行基础 |
| Claude Code CLI | AI 写作核心 |
| Anthropic API Key | 调用 Claude 大模型 |
TIP
如果你还没有安装 Claude Code，可以去 https://claude.ai/code 下载安装。
可选依赖（用于更高级的功能）：
- Google Analytics 4 (GA4) - 流量分析
- Google Search Console (GSC) - 搜索排名数据
- DataForSEO - 关键词和 SERP 数据
- WordPress - 文章发布
项目结构
克隆下来之后，你会发现项目结构非常清晰：
seomachine/
├── .claude/ # Claude Code 配置
│ ├── commands/ # 斜杠命令定义
│ │ ├── research.md # 研究命令
│ │ ├── write.md # 写作命令
│ │ ├── rewrite.md # 重写命令
│ │ └── optimize.md # 优化命令
│ └── agents/ # 专业 Agent
│ ├── seo-optimizer.md # SEO 优化 Agent
│ ├── meta-creator.md # 元标签创建 Agent
│ ├── internal-linker.md # 内链构建 Agent
│ └── keyword-mapper.md # 关键词映射 Agent
├── data_sources/ # 数据源和 Python 分析模块
│ ├── modules/ # 分析模块
│ │ ├── search_intent_analyzer.py # 搜索意图分析
│ │ ├── keyword_analyzer.py # 关键词分析
│ │ ├── content_length_comparator.py # 内容长度对比
│ │ ├── readability_scorer.py # 可读性评分
│ │ └── seo_quality_rater.py # SEO 质量评分
│ ├── google_analytics.py # GA4 集成
│ ├── google_search_console.py # GSC 集成
│ ├── dataforseo.py # DataForSEO 集成
│ └── wordpress_publisher.py # WordPress 发布
├── context/ # 品牌指南和上下文
│ ├── brand-voice.md # 品牌调性
│ ├── style-guide.md # 写作风格
│ ├── seo-guidelines.md # SEO 指南
│ ├── features.md # 产品特征
│ └── writing-examples.md # 写作示例
├── research/ # 研究简报输出目录
├── drafts/ # 草稿文章输出目录
├── published/ # 已发布文章目录
├── rewrites/ # 重写文章目录
├── topics/ # 主题Ideas
├── research_*.py # 分析脚本合集
└── README.md # 项目文档
手把手教程
接下来，我们一步步完成整个配置和写作流程。
步骤 1：安装依赖
首先把项目拉到本地，然后安装 Python 依赖：
# 克隆仓库
git clone https://github.com/your-repo/seo-machine.git
cd seo-machine
# 安装 Python 依赖
pip install -r data_sources/requirements.txt
WARNING
如果你用的是 macOS，系统自带的 Python 可能版本较老。建议用 Homebrew 安装新版 Python：
brew install python3
步骤 2：配置 Context 文件
这是最关键的一步！Context 文件决定了 AI 写作的风格和质量。你需要填写这几个核心文件：
2.1 品牌调性（brand-voice.md）
定义你的品牌声音和语气：
# Brand Voice
## Voice Pillars
1. Professional but approachable
2. Educational and informative
3. Trustworthy and authoritative
## Tone Guidelines
- 避免太学术，用通俗易懂的语言
- 多用短句，保持简洁
- 适当加入幽默感
## Do's and Don'ts
- ✅ 用"你"称呼读者
- ✅ 用具体案例说明
- ❌ 避免行业黑话
- ❌ 不要高高在上
TIP
项目里有个完整的例子可以参考：examples/castos/brand-voice.md
2.2 产品特征（features.md）
列出你的产品或服务特点：
# Features
## Core Features
- Feature 1: 自动化写作
- Feature 2: SEO 优化
- Feature 3: 一键发布
## Value Propositions
- 节省 80% 的内容创作时间
- 无需 SEO 专业知识也能写出好文章
2.3 写作示例（writing-examples.md）
这是最重要的！找 3-5 篇你最好的博客文章贴进去：
# Writing Examples
## Example 1: [文章标题]
[完整文章内容...]
## 为什么这篇好
- 结构清晰
- 语言生动
- 有实际案例
TIP
Context 文件越详细，AI 写出的文章质量越高！建议花 5 分钟认真填写。
步骤 3：启动 Claude Code
现在打开 Claude Code，进入项目目录：
claude-code .
或者在 VS Code 里打开项目，然后用 Cmd+Shift+P 调出命令面板，输入 "Claude Code: Start"。
步骤 4：执行研究命令
在 Claude Code 的对话框里，输入：
/research [你的主题]
比如：
/research Python 异步编程教程
这会：
- 分析你的主题
- 研究竞争对手
- 生成关键词建议
- 创建搜索意图分析
- 在
research/目录生成一份研究简报
步骤 5：生成文章
研究完成后，开始写文章：
/write Python 异步编程完全指南
这会：
- 基于研究简报写一篇完整的博客文章（2000+ 词）
- 自动触发 SEO 优化 Agent
- 生成元标签（Title、Description、Keywords）
- 创建内链建议
- 在
drafts/目录生成：- 完整的 Markdown 文章
- SEO 优化报告
- 内链建议报告
- 关键词分析报告
TIP
如果你想更快地写一篇简单的文章，可以用：
/article [主题]
这是简化版的写作命令。
步骤 6：查看优化报告
打开 drafts/ 目录，你会看到生成的文件。SEO 优化报告大概是这个样子的：
# SEO Optimization Report
## Keyword Density
- "Python 异步编程": 2.5% (✅ 达标)
- "async await": 1.8% (✅ 达标)
## Content Length
- 当前: 2400 字
- 竞争对手平均: 2100 字 (✅ 超过)
## Readability
- Flesch Reading Ease: 72 (良好)
- Grade Level: 8 (通俗易懂)
## SEO Score: 85/100
步骤 7：发布到 WordPress（可选）
如果你有 WordPress 网站，可以一键发布：
/publish-draft drafts/你的文章.md
需要先配置 WordPress API：
- 在
data_sources/config/.env添加 WordPress URL 和 API Key - 确保安装了 Yoast SEO 插件
步骤 8：其他常用命令
除了上面这些，SEO Machine 还有不少实用命令：
# 重写已有文章（更新内容）
/rewrite [主题]
# 最终 SEO 润色
/optimize [文件]
# 分析现有文章或 URL
/analyze-existing [URL]
# 性能回顾（基于 GA4/GSC 数据）
/performance-review
# 内容优先级矩阵
/priorities
# SERP 分析
/research-serp [关键词]
# 竞争对手差距分析
/research-gaps
# 热门话题研究
/research-trending
常见问题排查
问题 1：Python 依赖安装失败
症状：运行 pip install 报错。
解决方案：
- 升级 pip：
pip install --upgrade pip - 换成国内镜像：
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn
问题 2：Context 文件配置不完整
症状：写出的文章质量差，不符合预期。
解决方案：
- 补充
writing-examples.md，至少放 3 篇好文章 - 详细描述
brand-voice.md中的语气和风格 - 在
features.md中加入产品的独特卖点
问题 3：Claude Code 命令不生效
症状：输入 /research 没反应。
解决方案：
- 确保在 Claude Code 对话框里输入（不是终端）
- 检查命令是否正确拼写
- 尝试用英文斜杠：
/research
问题 4：文章质量不够好
症状：AI 写出的文章太平淡。
解决方案：
- 在 Context 文件中加入更多写作示例
- 用
/research先做研究，AI 会更有针对性 - 手动修改 prompt，在
/write时加入更多要求
问题 5：WordPress 发布失败
症状：提示无法连接 WordPress。
解决方案：
- 检查
.env里的 WordPress URL 和 API Key - 确认 WordPress REST API 是否启用
- 检查是否安装了 Yoast SEO 插件
问题 6：API 配额不足
症状：提示 API quota exceeded。
解决方案：
- 去 Anthropic 控制台查看配额使用情况
- 减少 Context 文件大小（精简写作示例）
- 考虑升级 API 套餐
核心功能解析
你可能会好奇，SEO Machine 到底是怎么工作的？核心在于它的命令系统和Agent 协作。
命令系统
┌─────────────────────────────────────────────────────────────┐
│ Claude Code │
├─────────────────────────────────────────────────────────────┤
│ │
│ /research → 生成研究简报 │
│ ↓ │
│ /write → 生成文章 + 触发优化 Agent │
│ ↓ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 自动触发的优化 Agent │ │
│ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │
│ │ │ SEO │ │ Meta │ │ Internal │ │ │
│ │ │ Optimizer │ │ Creator │ │ Linker │ │ │
│ │ └────────────┘ └────────────┘ └────────────┘ │ │
│ └─────────────────────────────────────────────────────┘ │
│ ↓ │
│ /optimize → 最终 SEO 润色 │
│ ↓ │
│ /publish → 发布到 WordPress │
│ │
└─────────────────────────────────────────────────────────────┘
Python 分析管道
项目还带了完整的 Python 分析模块：
| 模块 | 功能 |
|---|---|
search_intent_analyzer.py | 搜索意图分类（信息/导航/交易） |
keyword_analyzer.py | 关键词密度、分布、堆砌检测 |
content_length_comparator.py | 对比 SERP 前 10 名的内容长度 |
readability_scorer.py | 可读性评分（Flesch Reading Ease） |
seo_quality_rater.py | 综合 SEO 评分（0-100 分） |
直接运行这些脚本：
python3 seo_baseline_analysis.py
python3 seo_competitor_analysis.py
python3 research_serp_analysis.py
机会评分算法
项目内置了一个机会评分算法（opportunity_scorer.py），用 8 个加权因素评估关键词：
| 因素 | 权重 |
|---|---|
| 搜索 Volume（搜索量） | 25% |
| Position（当前排名） | 20% |
| Intent（搜索意图） | 20% |
| Competition（竞争度） | 15% |
| Cluster（主题聚类） | 10% |
| CTR（点击率） | 5% |
| Freshness（内容新鲜度） | 5% |
| Trend（趋势） | 5% |
进阶方向
搞定了基础用法之后，你可以探索这些更高级的功能：
1. 自定义 Agent
在 .claude/agents/ 目录下，按照现有模板添加新的 Agent。比如你可以创建一个专门写"对比评测"文章的 Agent。
2. 添加更多数据源
项目支持对接：
- Google Analytics 4 - 流量和参与度数据
- Google Search Console - 排名和展示数据
- DataForSEO - SERP 位置和关键词指标
在 data_sources/config/.env 中配置相应的 API Key。
3. SEO 分析脚本
项目带了多个分析脚本，可以单独运行：
# 快速见效分析
python3 research_quick_wins.py
# 竞争对手差距分析
python3 research_competitor_gaps.py
# SERP 分析
python3 research_serp_analysis.py
# 主题聚类
python3 research_topic_clusters.py
# 趋势分析
python3 research_trending.py
4. 批量内容生产
结合 cron 或 GitHub Actions，可以定时运行研究命令，自动生成内容。比如每周自动分析竞争对手差距，生成新的内容 ideas。
5. Landing Page 支持
项目还支持创建 Landing Page：
/landing-write [主题] # 创建 Landing Page
/landing-audit [文件] # 审计转化率问题
/landing-research [主题] # 研究定位
/landing-competitor # 竞争对手分析