Claude Code + SEOMachine：AI 写 SEO 文章的正确姿势
343 stars，24+ 个营销技能，从研究到发布全自动化。
用 AI 写 SEO 文章，你遇到过这些问题吗？
写出来的文章太"AI 味"，一眼就被看穿。关键词密度把握不准，要么堆砌要么太少。不知道竞品写了什么，内容同质化严重。写完还要手动优化 meta、内链、可读性。
SEOMachine 解决这些问题：一个专为 Claude Code 设计的 SEO 工作空间。
从关键词研究到文章发布，全流程自动化。2000+ 字长文，SEO 评分 0-100，一条命令搞定。
它是什么
SEOMachine 是一个 Claude Code 工作空间，专门用来写 SEO 优化的长文。
核心功能：
- 15+ 自定义命令（/research、/write、/optimize 等）
- 10 个专业 Agent（SEO 优化、Meta 生成、内链建议等）
- 24+ 个营销技能（文案、CRO、A/B 测试等）
- 5 个 Python 分析模块（关键词密度、可读性评分等）
- 数据集成（Google Analytics、Search Console、DataForSEO）
工作流程：
-
/research- 关键词研究 + 竞品分析 -
/write- 生成 2000-3000 字文章 - 自动触发 4 个 Agent 分析
-
/optimize- 最终优化 -
/publish-draft- 发布到 WordPress
为什么选它
1. 专为 Claude Code 设计
不是通用的 AI 写作工具，而是 Claude Code 的专用工作空间。
优势：
- 自定义命令：
/research、/write、/optimize - 专业 Agent：自动分析 SEO、Meta、内链
- 上下文驱动：品牌语气、风格指南、SEO 规范
2. 全流程自动化
从研究到发布，一条龙服务。
完整工作流：
# 1. 研究
/research content marketing strategies
# 2. 写作（自动触发 4 个 Agent）
/write content marketing strategies
# 3. 优化
/optimize drafts/content-marketing-strategies-2026-03-08.md
# 4. 发布
/publish-draft drafts/content-marketing-strategies-2026-03-08.md
3. 数据驱动决策
不是拍脑袋写，而是基于真实数据。
数据来源：
- Google Analytics 4：流量、转化
- Google Search Console：排名、CTR
- DataForSEO：竞品数据、SERP 特征
应用场景：
- 找出排名 11-20 的"快速胜利"机会
- 识别流量下降的内容
- 发现低 CTR 的优化机会
核心命令
/research - 关键词研究
功能：
- 关键词研究（主关键词 + 次关键词）
- 竞品分析（Top 10）
- 内容差距识别
- 推荐大纲
- 内链策略
输出：
- 研究报告：
research/brief-[topic]-[date].md - 包含：关键词、竞品分析、内容机会、推荐大纲
示例：
/research content marketing strategies for B2B SaaS
/write - 生成文章
功能：
- 生成 2000-3000+ 字文章
- 保持品牌语气（从
context/brand-voice.md） - 自然整合关键词
- 添加内链和外链
- 生成 Meta 元素
自动触发 4 个 Agent：
- SEO Optimizer：页面 SEO 建议
- Meta Creator：多个 Meta 标题/描述选项
- Internal Linker：内链建议
- Keyword Mapper：关键词分布分析
输出：
- 文章：
drafts/[topic]-[date].md - 4 个 Agent 报告
示例：
/write content marketing strategies
/optimize - 最终优化
功能：
- 全面 SEO 审计
- 验证所有元素
- 最终润色建议
- 发布准备度评分
输出：
- 优化报告：
drafts/optimization-report-[topic]-[date].md - SEO 评分（0-100）
- 优先修复项
示例：
/optimize drafts/content-marketing-strategies-2026-03-08.md
/analyze-existing - 分析现有内容
功能：
- 抓取并分析现有内容
- 评估 SEO 表现
- 识别过时信息
- 内容健康评分（0-100）
输出：
- 分析报告：
research/analysis-[topic]-[date].md - 更新优先级和范围
示例：
/analyze-existing https://yoursite.com/blog/marketing-guide
/rewrite - 更新内容
功能：
- 基于分析结果更新内容
- 刷新统计数据和示例
- 改进 SEO 优化
- 添加新章节填补空白
输出：
- 更新文章：
rewrites/[topic]-rewrite-[date].md - 变更摘要
专业 Agent
Content Analyzer - 内容分析器
最强大的 Agent，使用 5 个 Python 模块进行数据驱动分析。
分析内容：
- 搜索意图分类：信息型/导航型/交易型/商业型
- 关键词密度和聚类：TF-IDF + K-means 主题检测
- 内容长度对比：vs Top 10 竞品
- 可读性评分：Flesch Reading Ease、Flesch-Kincaid Grade Level
- SEO 质量评分：0-100 分，分类细分
输出：
- 执行摘要 + 发布准备度评估
- 优先行动计划（关键/高优先级/优化）
- 竞争定位分析
- 详细建议
SEO Optimizer - SEO 优化器
功能：
- 关键词优化和密度
- 内容结构和标题
- 内链和外链
- Meta 元素
- 可读性和用户体验
- Featured Snippet 机会
输出：SEO 评分（0-100）+ 具体改进建议
Meta Creator - Meta 生成器
功能：
- 5 个 Meta 标题变体（50-60 字符）
- 5 个 Meta 描述变体（150-160 字符）
- 测试建议
- SERP 预览
- 转化优化文案
Internal Linker - 内链建议
功能：
- 3-5 个具体内链建议
- 精确放置位置
- 锚文本建议
- 用户旅程映射
- SEO 影响预测
参考：context/internal-links-map.md
Editor - 编辑器
将技术准确的内容转化为人性化、吸引人的文章。
分析：
- 语气和个性
- 示例的具体性
- 可读性和流畅度
- 机器人 vs 人类模式
- 参与度和故事性
输出：
- 人性化评分（0-100）
- 关键编辑（前后对比）
- 模式分析
- 具体改写建议
24+ 个营销技能
文案：/copywriting、/copy-editing
CRO：/page-cro、/form-cro、/signup-flow-cro、/onboarding-cro、/popup-cro、/paywall-upgrade-cro
策略：/content-strategy、/pricing-strategy、/launch-strategy、/marketing-ideas
渠道：/email-sequence、/social-content、/paid-ads
SEO：/seo-audit、/schema-markup、/programmatic-seo、/competitor-alternatives
分析：/analytics-tracking、/ab-test-setup
其他：/referral-program、/free-tool-strategy、/marketing-psychology
安装配置
1. 安装 Claude Code
访问 https://claude.com/claude-code
2. 克隆仓库
git clone https://github.com/TheCraigHewitt/seomachine.git
cd seomachine
3. 安装依赖
pip install -r data_sources/requirements.txt
安装内容：
- Google Analytics/Search Console 集成
- DataForSEO API 客户端
- NLP 库（nltk、textstat）
- 机器学习（scikit-learn）
- 网页抓取工具（beautifulsoup4）
4. 在 Claude Code 中打开
claude-code .
5. 配置上下文文件（重要！）
所有上下文文件都是模板，需要填写你公司的信息：
必填文件：
-
context/brand-voice.md- 品牌语气和消息传递 -
context/writing-examples.md- 3-5 篇优秀博客文章 -
context/features.md- 产品/服务特性和优势 -
context/internal-links-map.md- 关键页面内链映射 -
context/style-guide.md- 风格偏好 -
context/target-keywords.md- 关键词研究和主题集群 -
context/competitor-analysis.md- 竞品分析和洞察 -
context/seo-guidelines.md- SEO 要求
快速开始：查看 examples/castos/ 了解完整的真实案例（播客托管 SaaS 公司）。
使用示例
场景 1：写新文章
# 1. 研究主题
/research content marketing strategies
# 2. 查看研究报告
# 阅读 research/brief-content-marketing-strategies-[date].md
# 3. 写文章
/write content marketing strategies
# 4. 查看 Agent 反馈
# 阅读 drafts/ 中的所有 Agent 报告
# 5. 改进
# 根据 Agent 建议编辑文章
# 6. 最终优化
/optimize drafts/content-marketing-strategies-[date].md
# 7. 发布到 WordPress（可选）
/publish-draft drafts/content-marketing-strategies-[date].md
场景 2：更新现有内容
# 1. 分析现有文章
/analyze-existing https://yoursite.com/blog/product-comparison
# 2. 查看分析报告
# 阅读 research/analysis-product-comparison-2026-03-08.md
# 3. 重写内容
/rewrite product comparison
# 4. 查看变更
# 阅读 rewrites/product-comparison-rewrite-2026-03-08.md
# 5. 优化
/optimize rewrites/product-comparison-rewrite-2026-03-08.md
场景 3：批量内容审计
# 分析多篇现有文章以确定更新优先级
/analyze-existing https://yoursite.com/blog/post-1
/analyze-existing https://yoursite.com/blog/post-2
/analyze-existing https://yoursite.com/blog/post-3
# 根据内容健康评分确定重写优先级
SEO 要求
每篇文章必须满足：
内容质量：
- 最少 2000 字（2500-3000+ 更佳）
- 提供 vs 竞品的独特价值
- 事实准确且最新
- 为目标受众提供可操作建议
- 保持品牌语气
关键词优化：
- 主关键词密度 1-2%
- 关键词出现在 H1、前 100 字、2-3 个 H2
- 3-5 个内链，描述性锚文本
- 2-3 个外部权威链接
Meta 元素：
- Meta 标题 50-60 字符
- Meta 描述 150-160 字符
- 正确的 H1>H2>H3 层级
可读性：
- 8-10 年级阅读水平
- 平均句子长度 15-20 字
- 段落 2-4 句
- 每 300-400 字一个小标题
- 列表和格式化以提高可扫描性
结构：
- 引人入胜的引言（钩子、问题、承诺）
- 逻辑章节流程
- 清晰的结论和 CTA
- 包含示例和数据
最佳实践
写作前：
- 研究优先：写作前始终运行
/research - 查看上下文：阅读
brand-voice.md和相关writing-examples.md - 检查关键词：在
target-keywords.md中验证目标关键词 - 规划内链：查看
internal-links-map.md寻找链接机会
写作中：
- 遵循大纲：使用研究报告作为大纲
- 自然关键词：自然整合关键词，不要强行插入
- 增加价值：每个章节都应提供可操作的洞察
- 使用示例：包含你所在行业的真实场景和用例
- 引用来源：链接到统计数据和数据来源
写作后：
- 查看 Agent 输出：仔细阅读所有 Agent 建议
- 改进：在优化前解决高优先级问题
- 运行优化：使用
/optimize进行最终润色 - 自我编辑：以目标读者的身份阅读文章
- 检查质量：验证所有检查清单项
常见问题
Q: 文章听起来不像我的品牌？
A: 更新 context/brand-voice.md 提供更具体的指导，在 context/writing-examples.md 中添加更多样化的示例。
Q: 关键词密度太高或太低？
A: 查看 seo-guidelines.md 目标密度（1-2%），使用 /optimize 获取具体关键词放置建议，使用 Keyword Mapper agent 进行分布分析。
Q: Agent 找不到好的内链？
A: 更新 context/internal-links-map.md 包含当前页面，按主题集群组织以便 Agent 匹配，提供每个页面涵盖内容的更多上下文。
Q: 内容与竞品太相似？
A: 在 competitor-analysis.md 中更新差异化机会，在 brand-voice.md 和 features.md 中添加你的独特优势，在 /research 命令中引用具体差异化角度。
总结
SEOMachine 不是通用的 AI 写作工具，而是专为 Claude Code 设计的 SEO 工作空间。
核心优势：
- 全流程自动化（研究 → 写作 → 优化 → 发布）
- 数据驱动决策（GA4 + GSC + DataForSEO）
- 专业 Agent 分析（10 个 Agent 自动审查）
- 24+ 个营销技能（文案、CRO、策略等）
- 上下文驱动（品牌语气、风格指南、SEO 规范）
适合谁：
- 使用 Claude Code 的开发者
- SEO 内容创作者
- 营销团队
- SaaS 公司
开始使用：
git clone https://github.com/TheCraigHewitt/seomachine.git
cd seomachine
pip install -r data_sources/requirements.txt
claude-code .
配置上下文文件，运行 /research [主题]，开始创作！
开源：
- GitHub：https://github.com/TheCraigHewitt/seomachine
- Stars：343（截至 2026-03-08）
- 示例：
examples/castos/（播客托管 SaaS 公司完整案例）
Top comments (1)
ok