小白也能完成的使用教程

先连接一次,之后用一句话做 SEO

SEO Agent 是给 AI 使用的 SEO 助手。你不需要懂专业 SEO,只要在 Codex 里说清网站、市场和目标,它就能帮你查资料、找问题、做内容和整理下一步。

简单理解Codex = 你和 AI 对话、执行任务的入口;SEO Agent = Codex 可以调用的 SEO 数据和工作流程;中转站 = 让 Codex 能正常使用 AI 模型的第三方服务。
你告诉 Codex 目标例如:帮我看看这个月网站先做什么。
SEO Agent 查资料查看搜索机会、竞争对手、页面问题和流量。
你确认后再执行可以继续修改页面、创建草稿、发布和监控。
1

下载 Codex 和 CC Switch

Codex 是你和 AI 对话、让 AI 执行任务的工具;CC Switch 用来保存模型服务设置。Windows 和 macOS 均可按此流程操作。

网络提醒访问 OpenAI 官网、GitHub 和部分模型服务通常需要稳定的 VPN 网络。请先确认 VPN 可正常使用,再进行下载安装与登录。
OpenAI Codex 官方页面中的 Windows 下载按钮
先安装 Codex打开官方页面后,Windows 用户点击“下载 Windows 版”;使用其他系统时,以官方页面当前显示的下载提示为准。
CC Switch GitHub Releases 页面中的最新正式版本
再安装 CC Switch进入标有“Latest”的正式版本,下滑到安装包列表。Windows 选择文件名含 Windows.msi 的文件,macOS 选择 .dmg
  1. 安装 Codex:双击下载文件,按安装向导完成安装,首次打开时登录你的账号。
  2. 安装 CC Switch:下载完成后安装并打开应用;如果系统弹出安全提示,请确认文件来自其 GitHub 官方发布页。
  3. 看到两个应用都能打开:说明这一步完成。Codex 用于提问和执行任务,CC Switch 只负责保存模型服务配置。
2

配置第三方中转站,让 Codex 能正常对话

中转站负责让 Codex 使用 AI 模型,SEO Agent 负责提供 SEO 数据和工作流,它们是两件不同的事。SEO Agent 不提供模型中转服务。

怎样算完成?打开 Codex,发送“你好,请简单介绍一下你自己”。如果 Codex 能正常回复,中转站就已经配置完成,可以继续下一步。

推荐的中转站

可参考 Sources Data 的服务与套餐。注册、余额、模型、网络和中转地址等问题,应直接联系该服务商客服处理。

打开 Sources Data

按图配置

在 CC Switch 中添加或导入 Codex 对应配置,按飞书说明填写第三方中转站提供的信息。

查看 CC Switch 配置说明
Sources Data 飞书文档中的 CC Switch 一键导入配置步骤
配置时找到“方式一:CC Switch(推荐)”中转站页面和 CC Switch 版本更新后,按钮位置可能略有变化;以飞书文档中的最新界面为准。
第三方服务声明:Sources Data 及其模型中转服务不是 SEO Agent 的业务,也不由 SEO Agent 运营或售后。本站仅提供使用建议;有关账号、付费、模型、网络或配置字段的疑问,请联系对应中转站客服。

先认识配置中的三个词

Base URL中转站的服务地址,直接从中转站后台复制,不需要自己编写。
中转站 API Key让 Codex 使用模型服务的密钥,只填写到 CC Switch。
模型名称Codex 要使用的模型,以中转站当前支持的名称为准。
  1. 在 CC Switch 里新增或导入配置:选择 Codex 对应的供应商配置。这里不要填写 SEO Agent 的 API Key。
  2. 按第三方说明填写:从中转站后台复制 Base URL、中转站 API Key 和模型名称,逐项粘贴或一键导入。密钥不要发到群聊或截图公开。
  3. 保存并验证:保存后打开 Codex,发送“你好,请简单介绍一下你自己”。Codex 能正常回复,就可以继续下一步。
3

创建 SEO Agent Key,连接 MCP

这一步才是把 Codex 接到 SEO Agent。登录 SEO Agent,进入个人资料创建 API Key,再把完整提示词发送给 Codex,它会在本机完成连接。

第 2 步使用中转站 API Key负责让 Codex 正常回答问题,只填写在 CC Switch 中。
第 3 步使用SEO Agent API Key负责让 Codex 调用 SEO 数据,只放进下方 MCP 提示词。
  1. 创建 SEO Agent API Key:点击下方按钮。未登录时会先进入登录页;登录成功后,点击右上角头像进入“个人资料”,在“API / MCP 使用”区域创建 Key。注册赠送、兑换券或正常充值到账后均可开通 API / MCP;实际调用仍需有足够余额和 Key 额度。
    打开登录 / 个人资料
  2. 替换占位符:将提示词中的 YOUR_SEO_AGENT_API_KEY 替换成刚创建的 SEO Agent Key。完整 Key 只显示一次,只发给你自己的 Codex,不要发到群聊或截图中。
  3. 复制并发送:点击“一键复制完整提示词”,粘贴到你自己的 Codex 对话,等待它确认配置完成。
整段提示词中,只需要替换这一处:YOUR_SEO_AGENT_API_KEY
请帮我在本机 Codex 中添加 SEO Agent 远程 MCP。

请只修改 ~/.codex/config.toml,不要删除或覆盖已有配置;
将以下配置追加到文件末尾,写入后检查 TOML 语法:

[mcp_servers.seoagent]
enabled = true
url = "https://www.seoagent.vip/mcp"

[mcp_servers.seoagent.http_headers]
Authorization = "Bearer YOUR_SEO_AGENT_API_KEY"

不要在回复中回显我的 API Key。完成后告诉我是否需要新开对话或重启 Codex 才能加载。

最后验证

让 Codex 完成配置后,先新开一个对话;如未出现工具,再重启 Codex。然后发送:检查 SEO Agent MCP 是否已连接,并只列出可调用的 SEO 工具名称。

看到什么才算成功?Codex 回复已经连接,并列出关键词、竞品、排名、GEO、站内审计等 SEO 工具名称,就表示连接完成。

没有连接成功时,按提示检查

看到的情况应该怎么做
没有发现 SEO Agent MCP先新开一个 Codex 对话;仍未出现时重启 Codex,再让 Codex 检查刚写入的配置。
提示 401 或 API Key 无效检查提示词中的 SEO Agent API Key 是否完整,前后不要多复制空格或引号。
提示余额或 Key 额度不足登录 SEO Agent,在个人资料中检查账户余额、Key 状态和该 Key 的消费额度。
Codex 自己也无法正常回复这通常不是 MCP 问题。先检查 VPN、中转站余额,以及 CC Switch 的 Base URL、模型名称和中转站 Key。
4

发送第一条 SEO 指令

不需要记关键词研究、SERP、GEO 等工具名称。把网站、市场和想要的结果说清楚,Codex 会判断该调用哪些 SEO Agent 能力。

1

告诉它做什么

例如分析网站、找客户会搜索的话题、写文章或检查页面。

2

告诉它服务谁

给出网站和目标市场,例如“我的外贸网站”和“美国客户”。

3

告诉它想要什么结果

例如获得询盘、提高流量,或者列出本周最该先做的事情。

第一次使用,可直接发送:
我不懂 SEO。请用已连接的 SEO Agent,分析 example.com 在美国市场目前最值得先做的 3 件事。请用简单的话告诉我:为什么、先改哪一页、预计花多少时间。
需要做内容并发布时,可直接发送:
帮我写一篇“适合小企业的 CRM 软件”文章。先完成关键词和竞争对手研究,再生成文章并检查;完成后先停下来等我确认,我认可后再创建 WordPress 草稿。