1. 项目概览
OpenSEO 是一个开源、按需付费的 SEO 工具包——定位为 Semrush 和 Ahrefs 的替代方案——涵盖关键词研究、排名跟踪、竞争对手洞察、外链、站点审计和 AI 可见性,并通过 MCP 服务器和 Agent Skills 向 AI 智能体开放同样的数据。
2. 背景与定位
为什么创建它
成熟的 SEO 套件通常以月度订阅方式出售,这对只偶尔进行 SEO 分析的小团队、独立开发者和代理机构来说并不合适。OpenSEO 采取了不同的方式:你自带 DataForSEO API 密钥,只为实际请求的数据付费。自托管时没有席位许可或固定订阅。
与类似项目的区别
- 按使用量计费——数据由 DataForSEO 按请求计费,而不是捆绑的月度套餐。
- 开放且可分支——MIT 许可,围绕聚焦工作流构建的刻意简洁的界面,专为定制而设计。
- 面向智能体——附带 MCP 服务器和可复用的 Agent Skills,使 Claude Code、Codex、ChatGPT 等工具和其他智能体能够直接执行 SEO 任务。
- 灵活的托管——使用 openseo.so 上的托管服务,或通过 Cloudflare 或 Docker 自托管。
3. 功能类别
🔎 关键词研究
发现并评估搜索词及其潜力。目的:决定哪些主题值得作为目标。
📈 排名跟踪
随时间监控你的页面在所选关键词上的排名。目的:衡量你的 SEO 工作的效果。
🕵️ 竞争对手洞察
检查竞争网站排名所针对的内容。目的:发现差距和机会。
🔗 外链
审查指向某个网站的链接配置文件。目的:了解权威性和链接建设机会。
🩺 站点审计
抓取网站并暴露技术 SEO 问题。目的:发现并修复阻碍排名的问题。
🤖 AI 可见性
检查品牌或网站在 AI 驱动的搜索体验中的呈现方式。目的:随着搜索转向 AI 答案,保持可见性。
🧩 智能体集成
MCP 服务器、Agent Skills,以及针对 ChatGPT(网页版和桌面版)、Codex 和 Claude Code 风格智能体的设置指南。目的:让 AI 智能体基于真实数据运行 SEO 工作流。
4. 关键亮点
- 只为使用付费——自带 DataForSEO 密钥;自托管成本直接流向 DataForSEO。
- MCP 服务器和 Agent Skills——逐步引导智能体完成 SEO 任务。
- Cloudflare 优先的自托管——推荐路径,文档说明可在 Cloudflare 的免费计划上运行。
- Docker 选项——
compose.yaml配置,最适合测试。 - 托管选项——可免费试用;托管订阅标价为每月 10 美元,DataForSEO 请求加价 28%。
- 现代 TypeScript 技术栈——Vite、Cloudflare Wrangler、pnpm 和 Drizzle ORM,易于分支和扩展。
5. 按角色的使用场景
- 普通开发者——将 SEO 数据添加到自己的应用中,或分支界面以定制工作流。
- DevOps/SRE——在 Cloudflare 或 Docker 上自托管,并通过环境配置管理密钥。
- 数据/研究科学家——提取关键词、排名和外链数据进行分析,或通过智能体查询。
- 项目经理和营销人员——跟踪排名、审计网站并比较竞争对手,无需固定订阅。
6. 快速开始
找到你需要的内容
- 托管应用和文档:openseo.so
- MCP 设置:https://openseo.so/docs/mcp
- Agent Skills 设置:https://openseo.so/docs/skills/setup
安装 / 集成
自托管指南位于仓库中:
git clone https://github.com/every-app/open-seo.git
cd open-seo
# 然后按照以下之一操作:
# docs/SELF_HOSTING_CLOUDFLARE.md (推荐)
# docs/SELF_HOSTING_DOCKER.md (最适合测试)
# docs/LOCAL_DEVELOPMENT.md (开发)
# docs/DATAFORSEO_API_KEY.md (API 密钥设置)
贡献
清晰、编写良好的问题是最大的贡献。项目提供了一个技能来帮助:
npx skills add every-app/open-seo --skill simple-issue-description
详情请参阅 docs/CONTRIBUTING.md。
7. 项目结构
open-seo/
├── src/ # 应用源代码
├── web/ # Web 前端
├── docs/ # 自托管、开发和贡献指南
├── drizzle/ # 数据库迁移
├── deploy/ # 部署配置
├── plugins/openseo/# 智能体工具的插件包
├── scripts/ # 工具脚本
├── specs/ # 规范
├── tests/ # 测试
├── compose.yaml # Docker Compose 配置
├── wrangler.jsonc # Cloudflare 配置
└── .env.example # 示例环境变量
8. 相关生态
- DataForSEO——所有 SEO 数据所需的数据提供商。
- Cloudflare——推荐的自托管平台(也提到了 Railway、Coolify 和 Dokploy)。
- 兼容 MCP 的智能体——Claude Code、Codex、ChatGPT、OpenClaw 和 Hermes。
- 商业对应产品——Semrush 和 Ahrefs,OpenSEO 将自己定位为它们的替代方案。
9. 许可证
- ✅ 在 MIT 许可证下使用、修改、分支和再分发代码,包括商业用途
- ✅ 为个人、团队或客户工作自托管
- ❌ 作者不提供任何保证或承担责任
- ℹ️ 在副本中保留版权和许可证声明
- ℹ️ SEO 数据来自 DataForSEO,其有自己的定价和条款
10. 常见问题
问:我需要订阅吗?
答:自托管时不需要。你直接向 DataForSEO 支付使用费用。托管版本可免费试用,付费计划标价为每月 10 美元。
问:我应该在哪里自托管?
答:推荐 Cloudflare(参见 docs/SELF_HOSTING_CLOUDFLARE.md)。Docker 最适合测试(docs/SELF_HOSTING_DOCKER.md)。
问:AI 智能体可以使用它吗?
答:可以。参见 MCP 指南 和 Agent Skills 指南。
问:我如何获取 DataForSEO 密钥?
答:按照仓库中的 docs/DATAFORSEO_API_KEY.md 操作。
问:我如何贡献?
答:提交一个清晰的问题;simple-issue-description 技能可以帮助你编写。
11. 快速链接
- 仓库:https://github.com/every-app/open-seo
- 网站 / 托管服务:https://openseo.so
- 定价:https://openseo.so/pricing
- 问题:https://github.com/every-app/open-seo/issues
- 社区:https://discord.gg/c9uGs3cFXr
12. 总结
OpenSEO 将商业 SEO 套件的核心工作流带入一个 MIT 许可、按使用量定价、可分支的项目中,并使这些数据可供 AI 智能体使用。它适合希望在没有固定月度订阅的情况下获得 SEO 洞察的开发者、小团队、代理机构和营销人员。