SEO Machine：基于Claude Code自动生成或优化长篇博客文章

SEO Machine 是一个基于 Claude Code 构建的专业开源 AI 工作区，旨在为各种规模的企业自动研究、创建、分析并优化符合搜索引擎优化（SEO）标准的长篇博客与着陆页。该系统通过提供结构化的工作流和多样的命令行交互，能够自动执行搜索意图研判、竞品差距分析、万字长文撰写、SEO 评分打磨等全套营销任务。它不仅能稳定输出2000字以上的高质量文章，还内置了内容分析器、元数据生成器、内部链接规划器等多个 AI 智能体。同时，它可无缝集成 Google Analytics 4、Search Console 和 DataForSEO 等实时数据源，帮助用户做出数据驱动的内容决策。凭借26种专门的营销技能模块，SEO Machine 能在严格保持企业品牌基调的前提下，极大地提升内容产出效率和搜索引擎可见度。

功能列表

• 自动化SEO长文撰写：根据提供的关键词或话题，自动生成2000-3000字以上的SEO优化长篇文章，并支持深度模仿设定的品牌语调。
• 竞品分析与深度内容研究：支持一键自动执行目标关键词研究、排名前10竞品分析以及内容差距识别，并生成详细研究简报指导写作。
• 智能SEO分析器与自动评分：内置高级SEO评估模型（0-100分），多维度分析搜索意图分类、关键词密度、LSI相关词覆盖率及可读性（Flesch指标）。
• 自动内外链与元数据构建：在正文撰写过程中，系统会自动提供多个高转化率的Meta标题和描述选项，并依据自定义站点地图自动规划内链锚文本。
• 现存老旧内容审计与翻新：通过抓取现有文章的URL，系统可自动评估内容健康度，识别过时信息并重写扩充内容，以重新抢占排名。
• 基于真实数据的内容优先级排期：深度集成GA4与Search Console，精准识别排名在第11-20位的高潜力页面，自动生成高影响力的优化排期路线图。
• 自动化着陆页（CRO）转化优化：针对产品转化页面执行首屏视觉评估、CTA按钮检查、信任信号检测，并提供专业的A/B测试方向建议。
• AI痕迹智能擦除（Scrub）：独具特色的自动审查机制，能自动识别并移除内容中的破折号滥用、废话填充词及机械化语言模式，提升文章“人味”。
• WordPress API 一键发布集成：提供定制插件环境，撰写或优化完成后，通过 REST API 将排版好的文章连带 Yoast SEO 字段数据直接无缝推送到网站。

使用帮助

SEO Machine 是一款专业级的自动化内容营销利器，依托于强大的 Claude Code 运行。为了让您能够顺利上手并充分发挥该系统的极大潜力，请仔细阅读以下详细的安装配置流程及核心功能操作指南。

一、 环境准备与详细安装流程

在开始使用之前，您需要完成基础运行环境的配置工作：

1. 前置条件准备：
   • 确保您的计算机上已全局成功安装 Claude Code。
   • 注册并获取 Anthropic API 账户及访问密钥（API Key），这是驱动 AI 进行内容研究和逻辑生成的底层引擎。
   • 确保本地已安装 Python 环境，以支持项目中内置的大量复杂数据分析和打分模块。
2. 克隆项目并安装依赖：
   打开终端（Terminal）或命令行工具，输入以下指令将仓库代码克隆到本地机器：

   git clone https://github.com/TheCraigHewitt/seomachine.git
   cd seomachine
   

   随后，安装项目进行深度分析所需的所有 Python 依赖包。这些包包含了 Google 分析平台集成工具、自然语言处理（NLP）库、以及网页抓取工具：

   pip install -r data_sources/requirements.txt
   

3. 启动工作区：
   安装完成后，在项目的根目录下输入以下命令，即可立即唤醒并进入 Claude Code 专属工作区：

   claude-code .
   

二、 核心上下文文件配置（至关重要）

SEO Machine 能够源源不断输出高质量、具有真人情感内容的秘诀，在于其极度细致的上下文控制。在首次撰写文章前，必须前往 context/ 文件夹中，将预设模板修改为贵公司的专属信息：

• brand-voice.md（品牌语调指南）：明确定义你们的品牌人设、沟通基调以及行文禁忌。
• writing-examples.md（优质范文库）：放入3-5篇网站上历史表现最优异的博客文章，AI 会通过机器学习深度模仿你们的文笔特色。
• features.md（核心产品功能）：列出您的业务优势与核心卖点，方便 AI 在行业文章中为您做自然软性的产品植入。
• internal-links-map.md（内部链接拓扑表）：罗列出网站重点转化页面（如定价页、功能页）及对应的目标关键词。撰写文章时，智能体将自动匹配并在合适位置挂载这些内部链接。
• target-keywords.md（目标关键词库）：归纳您未来一段时间内的内容主战场及长尾关键词集群。

三、 核心功能与操作指令详解

配置一旦完成，您只需使用简短的命令，即可使唤背后的多个 AI 智能体为您奔波效劳：

业务流一：从零策划并自动撰写一篇高质量 SEO 长文

1. 深度研究竞争对手：
   在命令行输入 /research [您的主题/关键词]（例如：/research B2B SaaS的内容营销策略）。
   系统动作：调研智能体将自动全网搜索，分析当前排名前10的竞品文章，精准挖掘他们的内容弱点与涵盖盲区，并在 /research/ 目录下生成一份包含完整大纲和关键词策略的研究简报。
2. 一键生成长篇草稿：
   输入 /write [您的主题]。
   系统动作：文案生成智能体会读取您的品牌语调及前一步简报，自动撰写一篇结构严谨、字数高达 2000-3000 字的深度文章。在此期间，SEO优化器和内链智能体会自动执行多轮交叉验证，顺滑嵌入 H2/H3 标签与内链，并编写高点击率预期的 Meta 描述。文章生成后自动存入 /drafts/ 目录。
3. 最终体检与优化打分：
   输入 /optimize drafts/[您的文章文件名].md。
   系统动作：系统会对文章进行发布前的终极把关，根据复杂的 SEO 规则生成 0-100 的质量评分。若发现缺失相关LSI词汇或可读性偏低，会直接列出整改建议以供一键应用。

业务流二：自动诊断与翻新现有历史内容
面对网站上流量下滑的旧文章，这套流程能帮您省下巨大的翻新精力：

1. 自动诊断旧网页：
   输入 /analyze-existing [现有文章的网页URL]。
   系统动作：抓取工具将一秒通读该页面，识别出过时的数据和相较于现行竞争对手的模块缺失，并生成健康度报告。
2. 自动重写与内容升级：
   输入 /rewrite [话题名称或报告文件]。
   系统动作：系统会完美保留原文章的高价值核心思想，利用最新数据填补空白，让文章焕发新生，重新取得冲击搜索引擎首页的竞争力。更新版本将保存在 /rewrites/ 文件夹中。

业务流三：消除 AI 生成痕迹的专属魔法
如果您担心文章的机器感太重，使用独家去痕迹功能：
输入 /scrub [文章文件路径]。
系统动作：内容编辑智能体会逐句扫描全文，精准擦除大量重复使用的破折号、冗长的过渡废话以及典型的“大语言模型结构模板”，全面提升文字的真实度和人类表达习惯评分（Humanity Score）。

四、 高阶进阶功能

• 数据驱动的优化排期：结合 GA4 和 Search Console 的真实数据运行 /priorities 命令，系统将帮您找出当前处于搜索排名第 11 名至 20 名的页面。由于这些页面极具冲刺潜力，系统会自动为您生成一张最具投入产出比的内容工作周报表。
• 一键静默发布：支持深度对接 WordPress。在项目 wordpress/ 内完成插件配置并设定 API 环境后，一句 /publish-draft [文件路径] 就能将排版精致、SEO元素拉满的文章瞬间静默推送到您的网站后台，彻底告别繁琐的手动复制。

应用场景

1. 内容营销团队批量生产深度博客
   企业需要保持优质内容的高频更新以获取源源不断的自然搜索流量。利用 SEO Machine，团队只需输入主题词，即可自动串联从竞品调研、框架搭建到含内链的数千字长文撰写过程，大幅缩短创作时间并确保内容符合严格的 SEO 标准。
2. 现有SEO历史内容的复盘与搜索排名夺回
   企业网站拥有大量有沉淀的历史文章，但随着竞争加剧排名出现停滞或下滑。营销人员可利用系统的一键抓取诊断与改写功能，找出当前页面相比竞争对手存在的内容空白，快速利用最新语料和数据翻新旧文章，重新抢占搜索首页红利。
3. 着陆页（Landing Page）高转化率设计评估
   投放人员与站长需要提高商业转化页面的效率。通过调用内置的 CRO（转化率优化）分析模块，系统能对现有页面结构进行客观评定，精准定位首屏价值主张是否清晰、信任背书是否足够以及行动呼吁（CTA）的位置是否合理，并为 A/B 测试提供科学的方向指引。

QA

1. 运行 SEO Machine 本身需要支付高昂的订阅费吗？
   不需要，SEO Machine 是在 GitHub 上开源免费的工具包。但由于其运行核心依赖于 Anthropic 的模型生态，您需要配置自己的 API Key，并依据调用大模型产生的 Token 消耗量向 Anthropic 支付常规的 API 使用费用。
2. 系统自动生成的长文如何保证符合我们公司的独有调性？
   系统专门设计了基于文件的上下文强制约束框架。在正式创作前，您会在专属文件夹下设定详细的“品牌基调字典”并提供3-5篇过往发布的优秀真实范文，AI在输出时会深度检索并模仿这些语言习惯，保障品牌心智的一致表达。
3. 该工具是否支持中文内容生产和优化？
   完全支持。其底层大语言模型具备极强的多语言能力。您只需在 brand-voice.md 等预设文件中用中文下达品牌要求，同时输入中文的调研或撰写指令，系统即能流利地输出符合中文阅读习惯和中文搜索引擎规则的高质量文章。
4. 我完全不懂编程，可以顺利操作这个工具吗？
   虽然系统采取命令行操作方式，这要求使用者能够打开电脑终端并输入文本指令，但项目本身配有极其详细的傻瓜式启动文档。只要按照步骤复制并粘贴配置命令，无需编写任何代码即可享受全套自动化内容生成带来的生产力飞跃。