open-seo

OpenSEO

Semrush 和 Ahrefs 的开源替代品

OpenSEO 是一款 面向大众 的 SEO 工具。如果 Semrush 或 Ahrefs 这类工具过于昂贵或臃肿，OpenSEO 是一种按需付费的替代方案，由你真正掌控。

为你和你的 AI 智能体（agent）打造的一站式 SEO 工具。

可与任何智能体（如 Claude Code、OpenClaw 或 Hermes）连接。我们内置了预构建的技能，但你可以自行构建，按需定制 OpenSEO。

目录

• 为什么使用 OpenSEO？
• 主要 SEO 工作流
• OpenSEO MCP
• OpenSEO 智能体技能
• 路线图
• 社区
• 定价 / 费用（免费 + API 费用）
• DataForSEO API 密钥设置
• Google Search Console
• 自托管
  • Docker 自托管
  • Cloudflare 自托管
• 本地开发
• 贡献
• SEO API 费用参考

托管版本

如果你不想自托管，或只是想支持该项目，我们也有一个托管版本：

openseo.so

为什么使用 OpenSEO？

• 业界领先的 MCP 和 AI 技能。
• 现代、简洁的 UI。
  • 专注的工作流，而非臃肿复杂的 SEO 套件。
• 无订阅。
  • 自带 DataForSEO API 密钥，按使用量付费。
• 可 Fork 并自行用 vibe coding 打造自定义工具。

主要 SEO 工作流

• 关键词研究
  • 寻找值得投入的主题，估算需求，优先确定下一步写什么。
• 排名跟踪
  • 监控关键词在桌面端和移动端随时间推移的排名位置，包含 SERP 特征检测。
• 域名洞察
  • 了解你的域名在哪些方面获得或失去可见性，从而专注于能带来收入的页面。
• 外链分析
  • 查看谁在链接到你的网站，哪些页面吸引链接，以及链接的新增或丢失情况。
• 网站审计
  • 尽早发现技术问题，让搜索引擎更容易抓取和排名你的网站。
• AI 品牌可见性
  • 查看你的品牌在 AI 回答中的呈现情况，包括竞争对手提及度和来源覆盖率。
• AI 搜索提示探索器
  • 追踪并探索用户可能在你的市场中向 AI 工具提问时使用的提示词。

OpenSEO MCP

OpenSEO 暴露了一个 MCP 服务器，让 AI 智能体可以直接使用你的 SEO 数据。

连接 Codex、Claude Code、Claude Desktop 或其他 MCP 客户端，即可：

• 进行关键词研究
• 检查 SERP
• 比较域名
• 审查外链
• 在编辑器或聊天中完成 SEO 决策

在应用中打开 AI & MCP 并复制你的 MCP 服务器 URL。将你的智能体指向你所使用的 OpenSEO 实例。

托管应用：

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

Cloudflare 自托管：

codex mcp add openseo --url https://your-openseo-domain.com/mcp
claude mcp add --transport http --scope user openseo https://your-openseo-domain.com/mcp

本地 Docker：

codex mcp add openseo --url http://localhost:3001/mcp
claude mcp add --transport http --scope user openseo http://localhost:3001/mcp

当你的智能体要求时，批准 OpenSEO 登录。

OpenSEO 智能体技能

OpenSEO 智能体技能是适用于 Codex 和 Claude Code 的可复用工作流。它们引导你的智能体完成 SEO 任务，并可利用 OpenSEO MCP 获取实时关键词、SERP、外链和域名数据。

安装选项

使用 skills add 安装：

npx skills add every-app/open-seo

自动接受每个 OpenSEO 技能：

npx skills add every-app/open-seo --skill '*'

仅安装到 Claude Code：

npx skills add every-app/open-seo --skill '*' --agent claude-code

仅安装到 OpenAI Codex：

npx skills add every-app/open-seo --skill '*' --agent codex

你也可以直接从 GitHub 仓库选择技能，并将其复制到智能体的技能文件夹中：

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/

从 /seo-project-setup 开始。它会询问你的项目情况并帮助配置工作区。

可用技能

• seo-project-setup
• seo-coach
• keyword-research
• keyword-clustering
• competitive-landscape
• competitor-analysis
• link-prospecting

路线图

首要任务：

• Google Search Console 集成 + MCP
• 本地 SEO
• 客户自定义报告
• 改进并定时执行网站审计
• 应用内 AI 智能体
• 支持多个项目

我们的首要任务始终是完善当前产品，并根据用户反馈改进现有功能。

如果缺少重要功能，请加入 Discord 或发送邮件至 ben@openseo.so 申请。

社区

发送邮件：ben@openseo.so

加入 Discord 聊天：Discord

关注更新：

• 在我们的网站上注册邮件列表：openseo.so
• 在 X（Twitter）上关注：https://x.com/bensenescu

定价 / 费用

OpenSEO 完全免费使用。它通过使用 DataForSEO 的 API 工作，DataForSEO 是一个付费的第三方服务，与 OpenSEO 无关。

这里有两部分：

1. OpenSEO 应用费用：$0，你自行托管。
2. DataForSEO API：按使用量付费。

关于费用估算，请参见 DataForSEO API 费用参考。

DataForSEO API 密钥设置

OpenSEO 使用 DataForSEO 获取 SEO 数据。你需要一个 API 密钥来将 OpenSEO 连接到该服务。

外链功能除了 API 密钥外，还需要额外一步：你需要在 DataForSEO 账户上启用 Backlinks（试用或付费订阅），然后在 OpenSEO 的外链页面中确认访问权限。

1. 前往 DataForSEO API Access。
2. 通过电子邮件请求 API 凭据（API key by email 或 API password by email）。
3. 使用你的 DataForSEO 登录名 + API 密码，然后对 login:password 进行 base64 编码：

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

1. 在环境文件中将其设置为 DATAFORSEO_API_KEY：

• Docker 自托管：.env
• Cloudflare：在 workers UI 中设置
• 本地开发：.env.local

Google Search Console

Search Console 是可选功能，在自托管部署中通过使用你自己的 Google OAuth 客户端工作。一次性设置大约需要 10 分钟 —— 参见 docs/SELF_HOSTING_GOOGLE_SEARCH_CONSOLE.md。

自托管

OpenSEO 支持两种自托管方式：

• Docker：用于个人使用和测试（推荐本地使用）。
• Cloudflare：用于面向互联网的自托管，支持多设备或团队使用。

Docker

Docker 是入门推荐的方式。安装 Docker 后，启动和运行非常简单。

Cloudflare

如果你喜欢 OpenSEO 并希望在多设备或团队中使用，可以将其托管在 Cloudflare 上，这会提供类似 SaaS 的体验。此外，它还会自动备份数据库并提供其他便利功能。只是如果你不熟悉 Cloudflare，启动时需要多花一点功夫。

Docker 自托管

[!WARNING] 默认情况下，Docker 版本仅适用于本地使用。它以单用户模式运行，无身份验证。如需面向互联网的自托管，请使用 Cloudflare（免费计划兼容）。或者，在暴露到互联网之前阅读 docs/SELF_HOSTING_DOCKER.md。

前提条件：

• 安装 Docker：https://www.docker.com/products/docker-desktop/

快速启动：

1. cp .env.example .env
2. 在 .env 中设置 DATAFORSEO_API_KEY
3. docker compose up -d
4. 打开 http://localhost:<PORT>（默认 3001）

默认情况下，compose.yaml 从 GHCR 拉取已发布的镜像：

• ghcr.io/every-app/open-seo:latest

要更新到最新的已发布镜像，先拉取再重启：

docker compose pull
docker compose up -d

或者使用单个命令：

docker compose up -d --pull always

更多信息，请参见 docs/SELF_HOSTING_DOCKER.md。

Cloudflare 自托管

部署 Worker

点击此按钮将打开一个页面，在你的 Cloudflare 账户中部署 OpenSEO。如果你还没有账户，它会先引导你创建账户（OpenSEO 在免费计划上运行良好）。

在部署时参考以下文档，因为 Cloudflare UI 不会提示你需要执行的步骤：docs/SELF_HOSTING_CLOUDFLARE.md。

本地开发

参见 docs/LOCAL_DEVELOPMENT.md。

贡献

非常欢迎贡献。

• 对于 Bug、UX 问题或功能请求，请提交 issue。
• 如果你想直接实现某个功能，请提交 PR。
• 社区驱动的改进是优先考虑的，高质量的 PR 备受鼓励。

如果你想贡献但不清楚从何入手，请提交 issue 并描述你想构建的内容。

SEO API 费用参考

使用此部分估算每种请求类型的 DataForSEO 花费。OpenSEO 本身保持免费；这些仅是 API 使用成本。

截至 2026 年 2 月 26 日，DataForSEO 的公开文档/定价页面显示：

• 新账户包含 $1 免费额度 用于测试 API。
• 最低充值/付款金额为 $50。

这意味着你可以先用启动额度免费试用 OpenSEO，然后再决定是否/何时充值。

定价来源

• DataForSEO SERP API 定价：https://dataforseo.com/apis/serp-api/pricing
• DataForSEO 关键词数据 API 定价：https://dataforseo.com/pricing/dataforseo-labs/dataforseo-google-api
• DataForSEO 外链定价：https://dataforseo.com/pricing/backlinks/backlinks
• DataForSEO Lighthouse API 文档：https://docs.dataforseo.com/v3/on_page/lighthouse/overview/

1) 排名跟踪

应用内对此有估算，因为它取决于你选择的设置。

$2/月的示例：

• 50 个关键词
• 1 个设备（移动端或桌面端）
• 搜索深度 5 页

搜索深度 10 页的成本是深度 1 页的 8 倍。同时跟踪两个设备的成本是 2 倍。

2) 网站审计

• 每次使用 Lighthouse 审计 20 页，费用 $0.01

3) 关键词研究（related 模式）

• 当前计费模式（来自账户使用日志）：
  • 0.02 + (0.0001 x 返回关键词数) 美元
• 默认应用设置：每次搜索返回 150 条结果（每条 $0.035）。
• 可用结果档位：
  • 150 条结果 = $0.035
  • 300 条结果 = $0.05
  • 500 条结果 = $0.07

4) 域名概览

• 标准域名概览请求（包含前 200 个排名关键词）：每个域名 $0.0401。
• 如需一般公式：
  • 0.0201 + (0.0001 x 返回的排名关键词数) 美元

5) 外链搜索

[!NOTE] 该 API 有 2 周免费试用期，之后 DataForSEO 要求每月最低承诺 $100。你可以通过 openseo.so 以每月仅 $20 的价格访问这些数据。很快，我们将允许你使用 OpenSEO API 密钥，以便从你的自托管实例中调用我们的 API。

• 外链搜索费用约为：域名搜索 $0.06，页面搜索 $0.04。
• 打开额外选项卡（如“引荐域名”或“热门页面”）每次增加约 +$0.02。
• 确切费用可能因返回行数和 DataForSEO 定价而略有差异。

6) AI 搜索 — 品牌查询

• 一次查询 = 6 次 DataForSEO AI Optimization 调用（aggregated_metrics + top_pages + mentions_search，针对 ChatGPT 和 Google AI Overview）：单次查询最高约 $0.85。
  • aggregated_metrics：每个平台 $0.101。
  • top_pages：每个平台按页面排名的引用来源。
  • mentions_search：按行数计费；应用默认采样 100 行时每个平台 $0.20（流量较低的品牌返回行数更少，费用也更低）。
• 添加竞争对手（声量占比）会增加 2 次 cross_aggregated_metrics 调用：每次约 $0.10，总计 $0.20。
• 结果缓存 24 小时，因此一天内重复相同的查询（相同目标 + 竞争对手集合）是免费的。
• 随时通过 pnpm billing:brand-lookup --target=example.com --competitors=a.com,b.com --confirmLive=true 重新测量。

规划示例

• 100 次关键词研究请求（默认 150 条结果）：$3.50
• 100 次关键词研究请求（每次 500 条结果）：$7.00
• 100 次域名概览（每次 200 个排名关键词）：$4.01
• 100 次外链域名搜索（使用默认设置，未打开额外选项卡）：约 $6.34
• 100 次外链页面搜索（使用默认设置，未打开额外选项卡）：约 $4.30
• 100 次完全展开的外链域名搜索：约 $10.94
• 100 次完全展开的外链页面搜索：约 $8.61