every-app/open-seo
GitHub: every-app/open-seo
一款开源的 SEO 工具，提供关键词研究、排名追踪与站点审计等核心功能，是 Semrush 和 Ahrefs 的轻量化、按量付费替代方案。
Stars: 2408 | Forks: 292
# OpenSEO
OpenSEO 是一款专为大众打造的 SEO 工具。如果 Semrush 或 Ahrefs 之类的工具太贵或太臃肿，OpenSEO 是一个你可以完全掌控、按需付费的替代方案。
连接任何你喜欢的 agent，例如 Claude Code、OpenClaw 或 Hermes。我们提供了预构建的 skills，你也可以构建自己的 skills，根据自身需求定制 OpenSEO。
## 目录
- [为什么使用 OpenSEO？](#why-use-openseo)
- [主要 SEO 工作流](#main-seo-workflows)
- [OpenSEO MCP](#openseo-mcp)
- [OpenSEO Agent Skills](#openseo-agent-skills)
- [路线图](#roadmap)
- [社区](#community)
- [定价 / 成本（免费 + API 费用）](#pricing--costs)
- [DataForSEO API Key 配置](#dataforseo-api-key-setup)
- [Google Search Console](#google-search-console)
- [自托管](#self-hosting)
- [Docker 自托管](#docker-self-hosting)
- [Cloudflare 自托管](#cloudflare-self-hosting)
- [本地开发](#local-development)
- [贡献指南](#contributing)
- [SEO API 成本参考](#seo-api-cost-reference)
## 托管版本
如果你对自托管不感兴趣，或者仅仅是想支持本项目，我们也提供了一个托管版本：
[openseo.so](https://openseo.so)
## 为什么使用 OpenSEO？
- 同类最佳的 MCP 和 AI Skills。
- 现代、简洁的 UI。
- 专注于核心工作流，拒绝臃肿、复杂的 SEO 套件。
- 无需订阅。
- 自带 DataForSEO API key，只需为实际使用量付费。
- Fork 并通过 vibe code 打造你的专属定制工具。
## 主要 SEO 工作流
- 关键词研究
- 发掘值得优化的主题，评估需求，并确定下一步撰写内容的优先级。
- 排名追踪
- 随时间推移监控桌面端和移动端的关键词排名，并支持 SERP 特性检测。
- 域名洞察
- 了解你的域名在哪些地方获得了可见性或在流失，从而将精力集中在能带来营收的页面上。
- 外链
- 查看谁链接到了你的网站、哪些页面吸引了链接，以及哪些链接是新增或流失的。
- 站点审计
- 及早发现技术问题，使你的网站更容易被搜索引擎抓取和排名。
- AI 品牌可见性
- 查看你的品牌在 AI 回答中的呈现方式，包括竞争对手的提及和来源覆盖情况。
- AI 搜索提示词探索器
- 追踪并探索人们在使用 AI 工具获取你所在市场的建议时，可能会用到的提示词。
## OpenSEO MCP
OpenSEO 提供了一个 MCP server，让 AI agent 能够直接使用你的 SEO 数据。
连接 Codex、Claude Code、Claude Desktop 或其他 MCP 客户端来：
- 执行关键词研究
- 检查 SERP
- 对比域名
- 审查外链
- 在你的编辑器或聊天工具中处理 SEO 决策
在应用中，打开 **AI & MCP** 并复制你的 MCP server URL。将你的 agent 指向你所使用的任意 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
```
当你的 agent 发出请求时，批准 OpenSEO 登录。
## OpenSEO Agent Skills
OpenSEO Agent Skills 是适用于 Codex 和 Claude Code 的可复用工作流。它们能引导你的 agent 执行 SEO 任务，并可以利用 OpenSEO MCP 获取实时的关键词、SERP、外链和域名数据。
### 安装选项
使用 `skills add` 安装：
```
npx skills add every-app/open-seo
```
自动接受每一个 OpenSEO skill：
```
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 仓库中挑选 skills，并将它们复制到你 agent 的 skills 文件夹中：
```
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` 开始。它会询问你的项目情况，并协助你配置工作区。
### 可用的 Skills
- `seo-project-setup`
- `seo-coach`
- `keyword-research`
- `keyword-clustering`
- `competitive-landscape`
- `competitor-analysis`
- `link-prospecting`
## 路线图
首要任务：
- Google Search Console 集成 + MCP
- 本地 SEO
- 针对客户的定制报告
- 改进及定时站点审计
- 应用内 AI Agent
- 支持多项目管理
我们的首要任务始终是完善当前产品，并根据用户反馈优化现有功能。
如果缺少任何重要功能，请加入 [Discord](https://discord.gg/c9uGs3cFXr) 或发送邮件至 ben@openseo.so 提出需求。
## 定价 / 成本
OpenSEO 完全免费使用。它通过调用 DataForSEO 的 API 来实现功能，这是一项付费的第三方服务，与 OpenSEO 没有关联。
这里包含两项独立的费用：
1. OpenSEO 应用费用：$0，由你自己托管。
2. DataForSEO API：根据使用量按需付费。
有关成本估算，请参阅 [DataForSEO API 成本参考](#seo-api-cost-reference)。
## DataForSEO API Key 配置
OpenSEO 使用 DataForSEO 获取 SEO 数据。你需要一个 API key 才能将 OpenSEO 连接到该服务。
外链功能在 API key 之外还需要一个额外步骤：你必须在你的 DataForSEO 账户中启用 Backlinks 功能（试用或付费订阅均可），然后在 OpenSEO 的 Backlinks 页面确认访问权限。
1. 前往 [DataForSEO API Access](https://app.dataforseo.com/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
```
4. 在你的环境变量文件中将此设为 `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`](./docs/SELF_HOSTING_GOOGLE_SEARCH_CONSOLE.md)。
## 自托管
OpenSEO 支持两种自托管途径：
- Docker（推荐用于本地使用和测试）。
- Cloudflare（用于跨多设备或团队协作的面向互联网的自托管）。
_Docker_
推荐使用 Docker 作为入门方式。安装 Docker 后，启动并运行非常简单。
_Cloudflare_
如果你喜欢 OpenSEO 并希望在多台设备上或与团队一起使用，你可以将它托管在 Cloudflare 上，这将带来类似 SaaS 的体验。此外，它还具备自动数据库备份和其他便利功能。如果你对 Cloudflare 不熟悉，入门设置可能会稍微多花一点精力。
## Docker 自托管
前置条件：
- 安装 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:`（默认端口为 `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`](./docs/SELF_HOSTING_DOCKER.md)。
## Cloudflare 自托管
### 部署 Worker
点击此按钮将打开一个页面，在你的 Cloudflare 账户中部署 OpenSEO。如果你还没有账户，系统会先引导你创建账户（OpenSEO 在免费计划下就能很好地运行）。
在部署过程中请参考这些文档，因为 Cloudflare UI 不会明确提示你需要执行哪些步骤：[`docs/SELF_HOSTING_CLOUDFLARE.md`](./docs/SELF_HOSTING_CLOUDFLARE.md)。
[](https://deploy.workers.cloudflare.com/?url=https://github.com/every-app/open-seo)
## 本地开发
请参阅 [`docs/LOCAL_DEVELOPMENT.md`](./docs/LOCAL_DEVELOPMENT.md)。
## SEO API 成本参考
使用本节内容来估算每种请求类型的 DataForSEO 花费。OpenSEO 本身保持免费；这些仅为 API 使用成本。
截至 2026 年 2 月 26 日，DataForSEO 的公开文档/定价页面显示：
- 新账户包含 **$1 的免费额度** 用于测试 API。
- 最低充值/付款金额为 **$50**。
这意味着你可以使用初始免费额度免费试用 OpenSEO，然后再决定是否/何时进行充值。
### 定价来源
- DataForSEO SERP API 定价：https://dataforseo.com/apis/serp-api/pricing
- DataForSEO Keywords Data API 定价：https://dataforseo.com/pricing/dataforseo-labs/dataforseo-google-api
- DataForSEO Backlinks 定价：https://dataforseo.com/pricing/backlinks/backlinks
- DataForSEO Lighthouse API 文档：https://docs.dataforseo.com/v3/on_page/lighthouse/overview/
### 1) 排名追踪
由于它取决于你选择的设置，因此应用内会提供针对此项的估算。
$2/月 示例：
- 50 个关键词
- 1 个设备（移动端或桌面端）
- 深度搜索 5 页。
搜索十页的深度成本是搜索一页的 8 倍。同时追踪两种设备的成本则是 2 倍。
### 2) 站点审计
- 使用 Lighthouse 审计每 20 个页面的成本为 $0.01
### 3) 关键词研究（`related` 模式）
- 当前计费成本模式（来源于账户使用日志）：
- `0.02 + (0.0001 x 返回的关键词数量)` USD
- 应用默认设置：每次搜索返回 `150` 个结果（每次 `$0.035`）。
- 可用的结果层级：
- 150 个结果 = `$0.035`
- 300 个结果 = `$0.05`
- 500 个结果 = `$0.07`
### 4) 域名概览
- 标准域名概览请求（包含前 200 个排名关键词）：每个域名 `$0.0401`。
- 如有需要，通用计算公式为：
- `0.0201 + (0.0001 x 返回的排名关键词数量)` USD
### 5) 外链搜索
- 域名外链搜索费用约为 `$0.06`，页面外链搜索费用约为 `$0.04`。
- 打开额外的标签页（如 `Referring Domains` 或 `Top Pages`）每次大约增加 `+$0.02`。
- 具体费用可能会因返回的行数和 DataForSEO 定价而略有不同。
### 6) AI 搜索 — 品牌查询
- 一次查询 = 6 次 DataForSEO AI Optimization 调用（跨 ChatGPT 和 Google AI Overview 的 `aggregated_metrics` + `top_pages` + `mentions_search`）：每次查询费用最高约 `$0.85`。
- `aggregated_metrics`：每个平台 `$0.101`。
- `top_pages`：按页面排名的每个平台的引用来源。
- `mentions_search`：按行计费；在应用完整的 100 行样本下，每个平台 `$0.20`（搜索量较小的品牌返回的行数较少，费用也更低）。
- 添加竞争对手（Share of Voice）会增加 2 次 `cross_aggregated_metrics` 调用：每次约 `$0.10`，共计 `$0.20`。
- 结果将缓存 24 小时，因此在一天内重复执行相同的查询（相同目标 + 竞争对手集）是免费的。
- 随时可以使用 `pnpm billing:brand-lookup --target=example.com --competitors=a.com,b.com --confirmLive=true` 重新测量。
### 规划示例
- 按默认的 150 个结果执行 100 次关键词研究请求：`$3.50`
- 按每次 500 个结果执行 100 次关键词研究请求：`$7.00`
- 100 次域名概览（每次包含 200 个排名关键词）：`$4.01`
- 按当前默认设置执行 100 次外链域名搜索（未打开额外标签页）：约 `$6.34`
- 按当前默认设置执行 100 次外链页面搜索（未打开额外标签页）：约 `$4.30`
- 100 次全面展开的外链域名搜索：约 `$10.94`
- 100 次全面展开的外链页面搜索：约 `$8.61`
## 目录
- [为什么使用 OpenSEO？](#why-use-openseo)
- [主要 SEO 工作流](#main-seo-workflows)
- [OpenSEO MCP](#openseo-mcp)
- [OpenSEO Agent Skills](#openseo-agent-skills)
- [路线图](#roadmap)
- [社区](#community)
- [定价 / 成本（免费 + API 费用）](#pricing--costs)
- [DataForSEO API Key 配置](#dataforseo-api-key-setup)
- [Google Search Console](#google-search-console)
- [自托管](#self-hosting)
- [Docker 自托管](#docker-self-hosting)
- [Cloudflare 自托管](#cloudflare-self-hosting)
- [本地开发](#local-development)
- [贡献指南](#contributing)
- [SEO API 成本参考](#seo-api-cost-reference)
## 托管版本
如果你对自托管不感兴趣，或者仅仅是想支持本项目，我们也提供了一个托管版本：
[openseo.so](https://openseo.so)
## 为什么使用 OpenSEO？
- 同类最佳的 MCP 和 AI Skills。
- 现代、简洁的 UI。
- 专注于核心工作流，拒绝臃肿、复杂的 SEO 套件。
- 无需订阅。
- 自带 DataForSEO API key，只需为实际使用量付费。
- Fork 并通过 vibe code 打造你的专属定制工具。
## 主要 SEO 工作流
- 关键词研究
- 发掘值得优化的主题，评估需求，并确定下一步撰写内容的优先级。
- 排名追踪
- 随时间推移监控桌面端和移动端的关键词排名，并支持 SERP 特性检测。
- 域名洞察
- 了解你的域名在哪些地方获得了可见性或在流失，从而将精力集中在能带来营收的页面上。
- 外链
- 查看谁链接到了你的网站、哪些页面吸引了链接，以及哪些链接是新增或流失的。
- 站点审计
- 及早发现技术问题，使你的网站更容易被搜索引擎抓取和排名。
- AI 品牌可见性
- 查看你的品牌在 AI 回答中的呈现方式，包括竞争对手的提及和来源覆盖情况。
- AI 搜索提示词探索器
- 追踪并探索人们在使用 AI 工具获取你所在市场的建议时，可能会用到的提示词。
## OpenSEO MCP
OpenSEO 提供了一个 MCP server，让 AI agent 能够直接使用你的 SEO 数据。
连接 Codex、Claude Code、Claude Desktop 或其他 MCP 客户端来：
- 执行关键词研究
- 检查 SERP
- 对比域名
- 审查外链
- 在你的编辑器或聊天工具中处理 SEO 决策
在应用中，打开 **AI & MCP** 并复制你的 MCP server URL。将你的 agent 指向你所使用的任意 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
```
当你的 agent 发出请求时，批准 OpenSEO 登录。
## OpenSEO Agent Skills
OpenSEO Agent Skills 是适用于 Codex 和 Claude Code 的可复用工作流。它们能引导你的 agent 执行 SEO 任务，并可以利用 OpenSEO MCP 获取实时的关键词、SERP、外链和域名数据。
### 安装选项
使用 `skills add` 安装：
```
npx skills add every-app/open-seo
```
自动接受每一个 OpenSEO skill：
```
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 仓库中挑选 skills，并将它们复制到你 agent 的 skills 文件夹中：
```
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` 开始。它会询问你的项目情况，并协助你配置工作区。
### 可用的 Skills
- `seo-project-setup`
- `seo-coach`
- `keyword-research`
- `keyword-clustering`
- `competitive-landscape`
- `competitor-analysis`
- `link-prospecting`
## 路线图
首要任务：
- Google Search Console 集成 + MCP
- 本地 SEO
- 针对客户的定制报告
- 改进及定时站点审计
- 应用内 AI Agent
- 支持多项目管理
我们的首要任务始终是完善当前产品，并根据用户反馈优化现有功能。
如果缺少任何重要功能，请加入 [Discord](https://discord.gg/c9uGs3cFXr) 或发送邮件至 ben@openseo.so 提出需求。
## 定价 / 成本
OpenSEO 完全免费使用。它通过调用 DataForSEO 的 API 来实现功能，这是一项付费的第三方服务，与 OpenSEO 没有关联。
这里包含两项独立的费用：
1. OpenSEO 应用费用：$0，由你自己托管。
2. DataForSEO API：根据使用量按需付费。
有关成本估算，请参阅 [DataForSEO API 成本参考](#seo-api-cost-reference)。
## DataForSEO API Key 配置
OpenSEO 使用 DataForSEO 获取 SEO 数据。你需要一个 API key 才能将 OpenSEO 连接到该服务。
外链功能在 API key 之外还需要一个额外步骤：你必须在你的 DataForSEO 账户中启用 Backlinks 功能（试用或付费订阅均可），然后在 OpenSEO 的 Backlinks 页面确认访问权限。
1. 前往 [DataForSEO API Access](https://app.dataforseo.com/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
```
4. 在你的环境变量文件中将此设为 `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`](./docs/SELF_HOSTING_GOOGLE_SEARCH_CONSOLE.md)。
## 自托管
OpenSEO 支持两种自托管途径：
- Docker（推荐用于本地使用和测试）。
- Cloudflare（用于跨多设备或团队协作的面向互联网的自托管）。
_Docker_
推荐使用 Docker 作为入门方式。安装 Docker 后，启动并运行非常简单。
_Cloudflare_
如果你喜欢 OpenSEO 并希望在多台设备上或与团队一起使用，你可以将它托管在 Cloudflare 上，这将带来类似 SaaS 的体验。此外，它还具备自动数据库备份和其他便利功能。如果你对 Cloudflare 不熟悉，入门设置可能会稍微多花一点精力。
## Docker 自托管
前置条件：
- 安装 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:标签：MCP, SEO工具, Web营销, 代码示例, 关键词分析, 排名追踪, 数据分析, 程序员工具, 自动化攻击, 请求拦截