用 Codex 开发一个 SEO 文章生成器：适合站长的 AI 项目教程

很多站长已经开始用 AI 辅助写文章，但真正能提升效率的不是零散提问，而是把选题、关键词、大纲、正文、FAQ、SEO 字段和 WordPress 草稿发布串成一个稳定流程。本文以“SEO 文章生成器”为例，讲清楚如何用 Codex 从需求到源码搭建一个适合站长使用的小型 AI 项目。

如果你正在评估 AI 工具，可以先看站内 AI工具最新动态；如果你更关注落地流程，可以继续浏览 实战工作流 和 使用技巧教程。

项目目标：站长真正需要的 SEO 文章生成器

这个项目不是简单生成一段文章，而是围绕站长的发布工作流设计：输入主题和关键词，自动生成文章摘要、别名、正文结构、FAQ、标签建议、内链建议、SEO 标题、SEO 描述和 Focus Keyword，最后形成 WordPress 兼容 HTML 草稿。

适合哪些站长使用

它适合有固定内容栏目、长期更新需求、希望规范 SEO 字段的站长。例如工具导航站、教程站、测评站、资源站、垂直博客和企业内容站。项目重点不是替代编辑，而是减少重复劳动，让编辑把时间用在判断选题、补充经验和审核质量上。

第一版不要做得太复杂

建议第一版只做本地 JSON 生成和 WordPress 草稿发布。不要一开始就加入复杂账号系统、定时队列、多模型路由和大型数据库。先把“输入到草稿”的链路跑通，后续再补可视化界面和批量任务。

需求拆解：把内容生产流程拆成模块

给 Codex 写需求时，需要明确每个模块的输入和输出。SEO 文章生成器至少包含五个模块：关键词模块、大纲模块、正文模块、SEO 模块、发布模块。每个模块都应该能单独检查，避免生成结果失控。

关键词模块

关键词模块负责接收主关键词、长尾关键词、目标读者、搜索意图和栏目分类。它不一定要连接第三方 SEO 数据源，第一版可以手动输入。后续如果要接入数据平台，也应把密钥放在环境变量里，不能写进源码。

大纲模块

大纲模块把关键词转成文章结构。正文一级标题使用 H2，二级标题使用 H3，正文中不要出现 H1。对 WordPress 来说，文章标题本身已经承担 H1 语义，正文继续使用 H1 会影响结构清晰度。

SEO 模块

SEO 模块负责输出 SEO Title、SEO Description 和 Focus Keyword。Focus Keyword 建议不超过 5 个核心词，使用英文逗号或中文逗号分隔。对于使用 Rank Math 的站点，发布脚本应把这些字段写入文章 meta。

设计数据结构：用 JSON 固定生成结果

为了让 Codex 生成内容可控，推荐让结果落成结构化 JSON，而不是直接让模型返回一大段混合文本。JSON 能让发布脚本稳定读取标题、别名、摘要、正文、分类、标签、图片和 SEO 字段。

推荐字段

{
  "title": "文章标题",
  "slug": "article-slug",
  "excerpt": "文章摘要",
  "content": "WordPress 兼容 HTML",
  "category_ids": [16, 64],
  "tags": ["Codex", "SEO文章生成器"],
  "cover_image": "images/cover.jpg",
  "seo": {
    "title": "SEO 标题",
    "description": "SEO 描述",
    "focus_keyword": "Codex,SEO文章生成器,AI写作"
  }
}

这个结构对站长很友好：内容编辑可以看懂，脚本可以读取，后续也方便加入正文插图、内链列表、参考资料和质量检查结果。

让 Codex 生成项目源码

项目可以先用 Node.js 实现，因为处理 JSON、调用接口和发布 WordPress REST API 都比较直接。基础目录可以包含 articles/、images/、scripts/ 和 .env。其中密钥只从 .env 读取，不写入源码。

核心脚本职责

发布脚本应该完成这些工作：读取文章 JSON，上传特色图和正文插图，创建或复用标签，使用已有分类 ID，写入草稿状态，写入 Rank Math SEO meta，最后输出文章 ID、草稿链接和后台编辑链接。如果接口失败，只输出状态码和错误信息，不输出密钥。

给 Codex 的实现提示词

可以这样要求 Codex：请创建一个 WordPress 自动发布脚本，所有密钥从 .env 读取，默认状态必须是 draft，不允许直接 publish，分类只能使用已有 ID，标签可复用或创建，图片必须设置 alt_text，发布后输出 post_id、post_status、front_link、edit_link。

内容生成策略：不要只追求字数

SEO 内容的核心不是越长越好，而是能否解决搜索者的问题。生成器应该让 Codex 按搜索意图组织内容：信息型问题给解释和步骤，导航型问题给入口和路径，交易型问题给对比和决策因素，排查型问题给原因和解决方案。

正文结构建议

一篇教程文章可以采用“问题背景、适用场景、准备工作、操作步骤、源码示例、测试验证、常见问题”的结构。每个 H2 下面用 H3 拆分细节，段落不要过长，并用列表、代码块和图片降低阅读压力。

内链建议

生成器应该根据栏目自动给出内链。例如项目教程可以链接到实战工作流，工具更新可以链接到 AI 工具最新动态，配置问题可以链接到环境配置教程。内链不应堆砌，正文里自然出现 2 到 4 个即可。

质量检查：发布前必须做的校验

自动生成文章最怕“看起来完整，但字段缺失”。因此发布前要做硬性检查：是否有摘要、正文、FAQ、SEO 信息、分类 ID、图片 alt_text；正文是否没有 H1；Focus Keyword 是否不超过 5 个；状态是否为 draft。

建议的校验清单

• 标题、别名、摘要不能为空。
• 正文必须是 WordPress 兼容 HTML。
• 正文使用 H2 和 H3，不使用 H1。
• 必须包含 FAQ。
• 图片必须设置 alt_text。
• 分类必须使用已有分类 ID。
• 默认文章状态必须是 draft。
• Rank Math SEO Title、Description、Focus Keyword 必须存在。

发布到 WordPress 草稿

当 JSON、图片和脚本都准备好后，就可以运行发布命令。发布成功后，站长应该先打开后台编辑链接进行人工审核，检查段落、图片、内链、SEO 字段和分类标签，再决定是否手动发布。

发布命令

node scripts/wp-publish.js articles/article.json

如果接口返回 401，通常是 WordPress 用户没有创建文章、上传媒体或创建标签的权限。应在后台检查用户角色和应用程序密码。不要通过修改管理员密码来解决，也不要把密码写进脚本。

后续增强方向

第一版跑通后，可以加入更多功能：批量生成选题、自动检查重复标题、接入站内文章列表生成内链建议、根据栏目模板生成不同文章结构、保存发布日志、为每篇文章生成独立封面图。每次只增加一个模块，项目会更稳。

站长工作流建议

建议把流程固定为：人工确定选题，生成器产出草稿，脚本发布到 WordPress，编辑人工审核，再手动发布。这样既能利用 AI 提速，也能保留站长对内容质量和发布节奏的控制。

常见问题

SEO 文章生成器能完全替代编辑吗？

不建议完全替代。它适合承担结构化生成、字段整理和草稿创建，最终判断、事实核查和经验补充仍应由人工完成。

为什么正文不要使用 H1？

WordPress 文章标题通常已经是页面 H1。正文继续使用 H1 会让页面结构混乱，教程正文建议使用 H2 和 H3。

Focus Keyword 应该写多少个？

建议不超过 5 个核心词，围绕主关键词、项目类型和目标场景展开，避免堆砌无关词。

能不能让脚本直接发布 publish？

默认不建议。自动化脚本应先发布为 draft，人工审核后再手动发布。只有用户明确要求时，才应考虑 publish。