下载 Codex
安装完成后打开 Codex,并使用自己的 OpenAI 账号登录。
打开 Codex 官方下载页面小白也能完成的使用教程
SEO Agent 是给 AI 使用的 SEO 助手。你不需要懂专业 SEO,只要在 Codex 里说清网站、市场和目标,它就能帮你查资料、找问题、做内容和整理下一步。
Codex 是你和 AI 对话、让 AI 执行任务的工具;CC Switch 用来保存模型服务设置。Windows 和 macOS 均可按此流程操作。
Windows 或 .msi 的文件,macOS 选择 .dmg。安装完成后打开 Codex,并使用自己的 OpenAI 账号登录。
打开 Codex 官方下载页面如果最新版没有对应系统的安装包,选择最近一个明确提供该系统安装包的正式版本。
打开 CC Switch GitHub 下载页中转站负责让 Codex 使用 AI 模型,SEO Agent 负责提供 SEO 数据和工作流,它们是两件不同的事。SEO Agent 不提供模型中转服务。
可参考 Sources Data 的服务与套餐。注册、余额、模型、网络和中转地址等问题,应直接联系该服务商客服处理。
打开 Sources Data在 CC Switch 中添加或导入 Codex 对应配置,按飞书说明填写第三方中转站提供的信息。
查看 CC Switch 配置说明
这一步才是把 Codex 接到 SEO Agent。登录 SEO Agent,进入个人资料创建 API Key,再把完整提示词发送给 Codex,它会在本机完成连接。
YOUR_SEO_AGENT_API_KEY 替换成刚创建的 SEO Agent Key。完整 Key 只显示一次,只发给你自己的 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 工具名称。
| 看到的情况 | 应该怎么做 |
|---|---|
| 没有发现 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。 |
不需要记关键词研究、SERP、GEO 等工具名称。把网站、市场和想要的结果说清楚,Codex 会判断该调用哪些 SEO Agent 能力。
例如分析网站、找客户会搜索的话题、写文章或检查页面。
给出网站和目标市场,例如“我的外贸网站”和“美国客户”。
例如获得询盘、提高流量,或者列出本周最该先做的事情。
我不懂 SEO。请用已连接的 SEO Agent,分析 example.com 在美国市场目前最值得先做的 3 件事。请用简单的话告诉我:为什么、先改哪一页、预计花多少时间。帮我写一篇“适合小企业的 CRM 软件”文章。先完成关键词和竞争对手研究,再生成文章并检查;完成后先停下来等我确认,我认可后再创建 WordPress 草稿。