OpenSEO：把 Semrush/Ahrefs 装进 MCP 里的开源平替

学习目标

读完本文你将能够：

• 说清 OpenSEO 和 Semrush / Ahrefs 的本质差异——它的产物首先是给 AI 代理消费的
• 讲清楚它的三层结构（数据采集层 / 应用层 / AI 消费层）各自负责什么
• 按文章给的 Docker 或 Cloudflare Workers 路径，在 5 分钟内把 OpenSEO 自托管起来
• 算清「按量付费」的真实成本，判断它对你是不是比 SaaS（软件即服务）订阅更划算
• 知道它在哪些场景不该用（团队无云原生经验、大规模批量域名分析等）

适合读者：已经在用 Claude Code / Codex 写 SEO（搜索引擎优化）内容、想把「代理直接调真实 SEO（搜索引擎优化）数据做决策」跑通，且愿意花一两天自托管的工程师或增长团队。

范围说明：OpenSEO 是一个 MIT 协议、TypeScript 写的开源 SEO（搜索引擎优化）工具，把关键词研究、排名跟踪、外链分析、站点审计、AI 品牌可见度等 7 套工作流打包成自带 MCP 服务器的 Web 应用，并配套 8 个面向 Codex / Claude Code 的 Agent（智能体）Skills。本文不教你 SEO 理论，只帮你判断「它值不值得上、怎么最快跑起来、成本是多少」。

目录

• 先给判断
• 系统地图：三层结构
• 7 套工作流覆盖的 SEO 主场景
• MCP 服务器：让代理直接读你的 SEO 数据
• Agent Skills：把 SEO 方法论灌进代理
• 5 分钟自托管：Docker 路径
• 5 分钟自托管：Cloudflare Workers 路径
• DataForSEO API（应用程序接口）key 生成
• 真实成本参考（按 2026-02-26 DataForSEO 公开定价）
• 适用边界与何时不要用
• 路线图（README 2026-06 公开）
• 一句话总结

先给判断

OpenSEO 和 Semrush、Ahrefs 最大的差别不在功能列表，而在一个分水岭：它的产物首先是给 AI 代理消费的——MCP（Model Context Protocol，模型上下文协议）服务器是 7 套工作流的一等公民，Web UI 反而是它的"皮肤"。配套的 8 个 Agent Skills（seo-project-setup / keyword-research / link-prospecting 等）直接让 Claude Code 或 Codex 调起实时数据做出 SEO 决策，而不是让你在一个 SaaS 后台里点按钮。

如果你的工作流是"让 AI 代理自己查关键词、对比域名、规划外链"，OpenSEO 是目前 GitHub 上少数把这件事端到端做齐的开源项目。它不便宜地"卷"功能全度，而是把"按量付费 + 自托管 + AI 原生"这三件事钉死。

仓库地址：https://github.com/every-app/open-seo（MIT 协议，TypeScript，2.8k+ stars，最近一次推送 2026-06-24）。

系统地图：三层结构

数据所有权和应用控制在用户侧：DataForSEO 用你自己的 API key，Google Search Console 走你自己的 OAuth，应用跑在你自己 Docker 容器或你自己的 Cloudflare Worker 上。官方托管版 https://openseo.so 只是给"不想自托管"的人一个备选。

7 套工作流覆盖的 SEO 主场景

从 README 整理的工作流清单（每条都是 MCP 暴露的独立工具集）：

1. 关键词研究（Keyword research）——找值得写的选题、估算搜索量、决定写哪个
2. 排名跟踪（Rank tracking）——桌面/移动 SERP 位置 + SERP feature（精选摘要、知识面板等）检测
3. 域名洞察（Domain insights）——看哪些页在涨/跌权重，把精力集中在直接影响收入的页
4. 外链分析（Backlinks）——谁链了你、哪些页吸链、新链/丢链的差分
5. 站点审计（Site audits）——抓技术问题，别让搜索引擎爬不动
6. AI 品牌可见度（AI brand visibility）——品牌在 ChatGPT/Google AI Overview 答案里被怎么提、竞争对手被怎么提、引用源覆盖
7. AI 搜索提示词探索（AI search prompt explorer）——在 AI 推荐场景里，用户可能用哪些提示词找到你

第 6、7 条是相对新的"AI 时代 SEO"维度——传统 Semrush 还在补这块，开源平替里专门做成工作流的不多。

MCP 服务器：让代理直接读你的 SEO 数据

OpenSEO 的 MCP 端点不需要任何额外配置，启动应用后从 AI & MCP 面板复制 URL 即可。

Codex：

codex mcp add openseo --url https://app.openseo.so/mcp

Claude Code：

claude mcp add --transport http --scope user openseo https://app.openseo.so/mcp

MCP 客户端连上后，你的代理就能直接在对话里调用：

• 跑关键词研究、看 SERP、对比域名、查外链
• 在编辑器或聊天里把 SEO 决策端到端做完
• 走 OAuth 登录授权后，操作会自动记到你的账户

重要：MCP URL 携带身份凭据，不要贴到公开 issue 或截图里；自托管时务必放在反代后的 HTTPS 域名下。

Agent Skills：把 SEO 方法论灌进代理

光有 MCP 工具还不够——AI 代理需要知道"什么时候该用哪个工具、按什么顺序出结论"。OpenSEO 用 Skills（/Users/<你>/.codex/skills 或 ~/.claude/skills 下的可复用指令集）解决了这个。

安装命令：

# 全部安装
npx skills add every-app/open-seo

# 全部安装并自动接受
npx skills add every-app/open-seo --skill '*'

# 只给 Claude Code
npx skills add every-app/open-seo --skill '*' --agent claude-code

# 只给 Codex
npx skills add every-app/open-seo --skill '*' --agent codex

也可以手动 clone（克隆）后拷到对应目录：

git clone https://github.com/every-app/open-seo.git

# Codex
mkdir -p ~/.codex/skills
cp -R open-seo/.agents/skills/* ~/.codex/skills/

# Claude Code
mkdir -p ~/.claude/skills
cp -R open-seo/.agents/skills/* ~/.claude/skills/

内置 8 个 Skill（截至 README 当前版本）：

新人建议从 /seo-project-setup 启动——它会问项目类型、目标市场、关心的关键词，让代理把工作空间先准备好，再去跑其他 skill。

5 分钟自托管：Docker 路径

Docker 版本默认是单用户本地模式，没有认证，不要直接暴露公网。要给团队用、跨设备用，走 Cloudflare Workers 路径（免费 plan 兼容）。

前置：安装 Docker Desktop。

git clone https://github.com/every-app/open-seo.git
cd open-seo
cp .env.example .env
# 编辑 .env，填 DATAFORSEO_API_KEY（生成方式见下节）
docker compose up -d

打开 http://localhost:3001。更新：

docker compose up -d --pull always

镜像从 GHCR 拉：ghcr.io/every-app/open-seo:latest。

5 分钟自托管：Cloudflare Workers 路径

点 README 里的 Deploy to Cloudflare 按钮，会跳到 Cloudflare 部署页（没账号先注册，免费 plan 即可）。具体步骤 UI 不一定明示，按 docs/SELF_HOSTING_CLOUDFLARE.md 对照配置。

部署时唯一必填的运行时变量就是 DATAFORSEO_API_KEY（Workers UI 里配 Secrets）。

DataForSEO API key 生成

OpenSEO 不直接对外做关键词/SERP/外链数据采集，所有 SEO 数据都来自 DataForSEO 第三方付费服务——OpenSEO 本身完全免费，你只为 DataForSEO 实际调用付费。

1. 申请：https://app.dataforseo.com/api-access，用邮箱请求 API key by email 或 API password by email

2. 拿到 login + password 后 base64 编码：

   printf '%s' 'YOUR_LOGIN:YOUR_PASSWORD' | base64

3. 把结果填到：

   • Docker：.env 的 DATAFORSEO_API_KEY
   • Cloudflare：Workers UI 的 Secrets
   • 本地开发：.env.local

外链功能额外要求：DataForSEO Backlinks 需要在你的账户上开通（有 2 周免费试用，但试用后是 $100/月承诺）。如果只想要外链数据不想签月度，官方托管版 https://openseo.so 一个月 $20 提供相同数据访问。

真实成本参考（按 2026-02-26 DataForSEO 公开定价）

新账户有 $1 免费信用测试，最低充值 $50。

实测规划示例（README 直接给）：

• 100 次关键词研究（150 结果/次）：$3.50
• 100 次域名概览（200 排名词/次）：$4.01
• 100 次完整外链域名搜索：~$10.94

按需使用、不是订阅，是这个项目"反 SaaS"的核心点——只为你实际跑的查询付费。

适用边界与何时不要用

适合：

• 已经在用 Claude Code 或 Codex 写 SEO 内容、希望代理直接调真实数据做决策
• 对 Semrush $139+/月或 Ahrefs $129+/月订阅敏感，想按量付费
• 能接受"自托管 + 自维护 DataForSEO 账户 + 自己装 Skill"的工程化上手过程
• 想 fork（派生）改一套自己的内部 SEO 工具（MIT 协议允许）

不适合：

• 团队里没有"懂 Docker / Cloudflare Workers / DataForSEO API"的人——首次部署 + DataForSEO 凭据生成 + 镜像更新链路都需要基础的云原生经验
• 需要"零配置打开网页就能查排名"的非技术用户——SaaS 后台可能更顺手
• 需要大规模批量域名分析（1000+ 域名/天）——DataForSEO 按量计费会快速放大成本
• 想要 Semrush 那种"内容模板 + 营销日历 + 社交媒体管理"全套营销功能——OpenSEO 纯 SEO 工具，没有这部分

路线图（README 2026-06 公开）

官方给出的下一阶段重点：

• Google Search Console 集成 + MCP
• 本地 SEO
• 客户定制报表
• 改进并支持定时站点审计
• 内嵌 AI 代理
• 多项目支持

Roadmap 的优先级会跟用户反馈动态调整，作者在 Discord 和邮箱 ben@openseo.so 直接接需求。

一句话总结

OpenSEO 是 2026 年 GitHub 上少数把"按量付费 + 自托管 + MCP + Agent Skills"四件事钉在一起的开源 SEO 工具。如果你的 SEO 工作流是"AI 代理驱动 + 想从订阅里逃出来 + 愿意花一两天自托管"，它是最直接的 Semrush/Ahrefs 替代路径；如果不是，这个项目对你可能就只是一份 README 而已。

自测题（附参考答案）

1. OpenSEO 和 Semrush / Ahrefs 最大的差别是什么？

   参考答案

   差别不在功能列表，而在分水岭：OpenSEO 的产物首先是给 AI 代理消费的。MCP 服务器是 7 套工作流的一等公民，Web UI 只是「皮肤」；配套的 8 个 Agent Skills 让 Claude Code / Codex 直接调起实时数据做 SEO 决策，而不是让你在 SaaS 后台点按钮。

2. OpenSEO 的三层结构各自负责什么？

   参考答案

   数据采集层用 DataForSEO API + Google Search Console OAuth 拿关键词、SERP、外链、域名数据；应用层是 Next.js Web App + MCP Server，把数据封装成 7 套工作流和 MCP 端点；AI 消费层是 8 个 Agent Skills 加 Codex / Claude Code 客户端，引导代理按规范消费工具。数据所有权和控制权都在用户侧。

3. 怎么把 OpenSEO 接进 Claude Code？

   参考答案

   启动应用后从「AI & MCP」面板复制 URL，执行 claude mcp add --transport http --scope user openseo https://app.openseo.so/mcp（自托管则换成你自己的地址）。Codex 对应的是 codex mcp add openseo --url ...。

4. OpenSEO 本身收费吗？真实 SEO 数据的成本来自哪里？

   参考答案

   OpenSEO 本身是 MIT 协议、完全免费。所有 SEO 数据来自第三方付费服务 DataForSEO，你只为实际调用付费，例如 150 结果的关键词研究约 $0.035。它是「反 SaaS」的按量付费，不是订阅。

5. 自托管有哪两条路径？

   参考答案

   Docker 路径：单用户本地模式、无认证，不要直接暴露公网；Cloudflare Workers 路径：免费 plan 兼容，适合团队或跨设备使用，部署时唯一必填运行时变量是 DATAFORSEO_API_KEY。

6. 哪些场景其实不适合 OpenSEO？

   参考答案

   团队里没人懂 Docker / Cloudflare Workers / DataForSEO API；需要零配置打开网页就查排名的非技术用户；需要大规模批量域名分析（1000+ 域名/天，按量成本快速放大）；以及想要 Semrush 那种内容模板 + 营销日历全套功能的团队。

练习

练习 1：用 Docker 把 OpenSEO 跑起来

git clone 后 cp .env.example .env、填好 DATAFORSEO_API_KEY，执行 docker compose up -d，打开 http://localhost:3001 验证能查到关键词数据。注意 Docker 版是单用户无认证，不要暴露公网。

练习 2：把 MCP 接进 Claude Code 跑一次对比

按文章命令把 OpenSEO 的 MCP 加进 Claude Code，让代理对两个竞争域名各跑一次域名洞察，把「哪些页在涨权重」的结论整理出来。

练习 3：安装 8 个 Agent Skills 并启动项目

用 npx skills add every-app/open-seo 安装，从 /seo-project-setup 启动，让代理问清项目类型、目标市场、关心的关键词，把工作空间配置好。

练习 4：用 Cloudflare Workers 部署团队实例

走 Deploy to Cloudflare 路径，在 Workers Secrets 里配好 DATAFORSEO_API_KEY，验证一个跨设备账号能访问同一份 SEO 数据。

练习 5：算清你的月度成本

按文章的成本表，估算你团队一个月的真实查询量（关键词研究 / 域名概览 / 外链 / AI 品牌查询）对应多少 DataForSEO 费用，再和 Semrush $139+/月、Ahrefs $129+/月对比，写下结论。

进阶方向

1. 深入 MCP 与 Agent Skills：读 open-seo 仓库里的 .agents/skills，理解每个 Skill 的触发条件、输入规范和输出格式，搞清楚「代理什么时候该用哪个工具」。
2. 自建内部 SEO 工具：利用 MIT 协议 fork 一套符合你们工作流的 Skill，接内部数据源，把方法论固化进代理。
3. 成本治理：用 DataForSEO 的缓存与批量接口压低单位成本，给账户设月度预算告警，避免大规模查询时费用失控。
4. 跟进 Roadmap：GSC 集成、本地 SEO、定时站点审计、内嵌 AI 代理会随反馈调整优先级，按需提前验证哪些对你最关键。

常见问题 FAQ

Q1：OpenSEO 真的免费吗？ A：软件本身 MIT 免费，但 SEO 数据来自 DataForSEO 按量付费。外链功能需在账户开通（2 周免费试用，之后 $100/月承诺）；不想签月度，可用官方托管版 https://openseo.so 的 $20/月拿到相同数据访问。

Q2：MCP URL 能直接分享给同事吗？ A：不能。MCP URL 携带身份凭据，不要贴到公开 issue 或截图里；自托管时务必放在反代后的 HTTPS 域名下。

Q3：Docker 版能直接给团队用吗？ A：默认是单用户本地模式、没有认证，不要直接暴露公网。要给团队或跨设备用，走 Cloudflare Workers 路径。

Q4：DATAFORSEO_API_KEY 怎么生成？ A：在 https://app.dataforseo.com/api-access 申请，拿到 login + password 后用 printf '%s' 'YOUR_LOGIN:YOUR_PASSWORD' | base64 编码，填到 Docker 的 .env、Cloudflare 的 Secrets 或本地开发的 .env.local。

Q5：没有 Claude Code / Codex 能用 OpenSEO 吗？ A：可以用 Web UI 手动查，但「代理直接消费 MCP 工具」才是它的核心价值。纯手动使用，它就只是另一个 SEO 后台，没必要折腾自托管。

Q6：外链分析成本太高怎么办？ A：只在需要时开通 DataForSEO Backlinks，或用官方托管 $20/月替代月度承诺；大规模批量域名分析（1000+ 域名/天）的按量成本会快速放大，需要先评估量纲再决定。

项目信息：

• 仓库：https://github.com/every-app/open-seo
• 协议：MIT
• 语言：TypeScript
• 主页：https://openseo.so
• 镜像：ghcr.io/every-app/open-seo:latest
• Discord：https://discord.gg/c9uGs3cFXr