学习路径指南
难度等级
初级
预计时长
3-5小时
适合人群
对SEO内容创作感兴趣的初学者、市场团队成员、内容创作者、独立创业者,无需编程经验但需有基本电脑操作能力

学习目标:学会使用SEO Machine系统化地创建和优化SEO博客文章,包括市场调研、内容撰写、SEO分析和优化等全流程

前置知识

Claude Code安装 了解

SEO Machine是基于Claude Code构建的工作空间,必须安装Claude Code才能运行

Anthropic API账号 了解

需要API密钥来调用Claude AI进行内容生成和分析

Python基础环境 了解

需要安装Python来运行分析模块的依赖库

SEO基础知识 了解 (可选)

了解基本的SEO概念(如关键词、元标签、内部链接)能帮助你更好地使用工具

学习步骤

1

环境准备与安装

30-45分钟

安装Claude Code

前往Claude Code官网下载并安装Claude Code编辑器,这是运行SEO Machine的基础环境

确保下载的是最新版本,安装过程通常很简单,按照向导操作即可

获取Anthropic API密钥

注册Anthropic账号,在控制台中创建API密钥并复制保存

建议将API密钥保存在安全的地方,不要分享给他人

克隆项目仓库

在终端或命令行中运行:git clone https://github.com/TheCraigHewitt/seomachine.git

如果你不熟悉git,也可以直接下载ZIP压缩包并解压

安装Python依赖

进入项目目录,运行:pip install -r requirements.txt 安装所有必要的Python库

如果遇到权限问题,可以尝试使用:pip install --user -r requirements.txt

2

项目配置与个性化

1-2小时

打开项目并查看示例

在Claude Code中打开seomachine项目文件夹,首先查看examples/castos/目录下的完整示例

这个示例展示了播客SaaS公司的完整配置,是学习的最佳参考

配置品牌声音文件

编辑context/brand-voice.md,按照模板填写你的品牌声音、语气、价值观等信息

参考castos示例,尽量详细描述,AI会根据这个文件生成符合品牌调性的内容

添加写作示例

在context/writing-examples.md中添加3-5篇你网站上已有的优秀博客文章

选择最能代表你品牌风格和高质量标准的文章,AI会学习这些文章的写作风格

设置关键词和目标

填写context/target-keywords.md,列出你的核心关键词和主题集群

可以从Google Keyword Planner或其他关键词工具获取数据,按优先级排序

完善其他上下文文件

根据需要填写style-guide.md、features.md、seo-guidelines.md等文件

不必一次性全部完善,可以先填写最重要的几个,后续根据需要补充

3

快速上手体验

1-1.5小时

尝试第一个研究命令

在Claude Code中运行:/research [你的主题],例如:/research 如何开始播客

选择一个你熟悉的主题,这样你可以评估研究结果的质量

查看研究结果

在/research/目录下找到生成的研究简报,查看关键词分析、竞争对手分析和内容缺口

研究简报会保存为brief-[主题]-[日期].md格式

生成第一篇文章

运行:/write [你的主题],基于研究结果生成一篇完整的SEO文章

文章会自动保存到/drafts/目录,生成过程可能需要几分钟

观察自动代理分析

文章生成后,观察SEO优化器、元标签创建器等自动代理的分析结果

这些代理会自动运行并提供改进建议,注意查看它们的输出

进行最终优化

运行:/optimize [生成的文章文件],进行最后的SEO审计和优化

优化报告会提供具体的改进建议和发布准备度评分

4

掌握核心工作流

1小时

学习更新现有内容

使用/analyze-existing命令分析你网站上的一篇旧文章,查看内容健康评分

可以输入URL或本地文件路径,系统会分析SEO表现并提出更新建议

尝试内容重写

使用/rewrite命令基于分析结果更新旧内容,观察改进点

重写后的文章会保存到/rewrites/目录,包含变更摘要

探索研究命令

尝试/research-serp、/research-gaps等专门的研究命令,了解不同研究功能

每个研究命令针对不同的SEO需求,可以根据需要选择使用

了解内容分析器

查看Content Analyzer的详细输出,理解搜索意图分类、可读性评分等指标

内容分析器提供数据驱动的详细分析,是优化内容的重要参考

推荐资源

Claude Code官方文档 必看

学习Claude Code编辑器的基本操作和功能

Anthropic API使用指南 推荐

了解如何有效使用Claude API,包括提示工程和最佳实践

castos示例目录 必看

项目自带的完整配置示例,展示了所有上下文文件的正确填写方式

GitHub Issues和Discussions 可选

查看其他用户的问题和解决方案,遇到问题时可以在这里寻找帮助

学习路径常见错误

1

上下文文件填写不完整或过于简略

参考castos示例,尽可能详细地填写所有上下文文件,特别是brand-voice.md和writing-examples.md,这些文件直接影响内容质量

2

直接使用默认配置生成内容

一定要先个性化所有上下文文件,否则生成的内容会缺乏品牌特色和针对性

3

忽略自动代理的分析建议

认真查看SEO优化器、内容分析器等代理的输出,这些是基于数据的专业建议,能显著提升内容质量

4

一次性尝试所有复杂功能

先从简单的/research和/write命令开始,掌握基本工作流后再探索高级功能如数据集成和性能分析

5

未保存API密钥或配置错误

确保正确配置Anthropic API密钥,并检查Claude Code中的API设置是否正确

学习路径下一步步骤

掌握基础工作流后,可以进一步探索:1) 集成Google Analytics和Search Console获取实时数据反馈;2) 使用DataForSEO API进行更深入的关键词分析;3) 开发自定义命令和代理扩展功能;4) 将工作流与WordPress等CMS系统深度集成实现自动化发布;5) 基于性能数据优化内容策略,建立持续改进的闭环系统

助手