OpenSEO | 开源 SEO 平台 – 关键词研究、站点审计与 AI Agent 协作

OpenSEO 把关键词研究、排名跟踪、竞争分析、反链、站点审计和 AI 可见性等工作放进一个开源平台,代码采用 MIT 许可,也提供托管服务。它的一个特点是让这些数据能被 AI Agent 调用:MCP 提供工具接口,Skills 则把常见 SEO 任务整理成可复用流程。自托管可以控制应用部署,但外部 SEO 数据仍有自己的账号和费用。

OpenSEO 暖色桌面概念封面,笔记本展示关键词研究,旁有研究纸张与 MCP 和 AI Agent 连接

从一个页面问题出发,才知道该查什么

假设网站准备重写一篇桌面工具介绍,先问“访问这页的人要选工具,还是要解决安装问题”,再查关键词与相关结果。搜索量和竞争数据帮助安排优先级,却不能替代对页面问题的判断;两组词即使都包含同一个工具名,也可能需要不同正文。

  1. 明确页面对象与搜索地区、语言,将要回答的问题写下来。
  2. 查看相关关键词与竞争页面,区分介绍、下载、教程等不同意图,找出正文真正缺少的内容。
  3. 用站点审计定位抓取、页面和链接方面的问题,再确定哪些属于当前页面,哪些需要网站维护。
  4. 修改后继续观察排名和流量等变化,保留时间与条件,避免把一次波动都归因于文案。

MCP 可以让 Agent 查询数据并组织分析,Skills 可以指导它按任务选工具和解释结果。连接接口后,Agent 仍需要知道目标页面、地域和任务范围,否则很容易拿一组宽泛数据生成同样宽泛的建议。分析能力也不等于自动写回网站已经获得授权。

AI 可见性适合观察网站或品牌在相应查询结果中的呈现。结果受问题、模型、时间和覆盖范围影响,某次没有出现不能直接证明网站完全不可见;也不能把传统搜索排名上升当作所有 AI 服务都会引用的保证。

Docker 与 Cloudflare,先选访问方式

部署路线适合的使用方式先处理的条件
Docker本机或受控私有网络使用默认 local_noauth,不执行登录检查;对外开放需要另加认证与访问限制
Cloudflare跨设备或团队访问同一个工作区需要 Cloudflare 资源和 Access;配置允许登录的邮箱,承担服务与数据费用

两条路线都需要配置 DataForSEO。MIT 允许使用和修改代码,不会赠送上游数据服务;还要把查询用量、运行成本与托管服务费用分开估算。选择自托管的理由可以是部署和数据管理需要,不必先假定它一定更便宜。

Docker:先在本地跑通

取得官方仓库中的 compose.yaml 和配置示例,在同目录复制环境文件,填好参数后启动:

cp .env.example .env
docker compose up -d

Windows PowerShell 可以用 Copy-Item .env.example .env 完成复制。DATAFORSEO_API_KEY 按官方文档使用 DataForSEO 邮箱与 API 密码组成的 email:password 的 Base64 编码值;Base64 并非加密,环境文件仍需妥善保存。不要把普通密码或其他平台的 Key 随意填进去。

默认页面地址是 http://localhost:3001,可用 /api/health 检查服务健康情况。打不开时先看容器状态与日志;页面能打开但数据请求失败,则检查上游凭据、账号和额度。

local_noauth 会直接使用本地管理员身份。ALLOWED_HOST 控制可接受的主机名,不能代替用户登录。需要外部访问时,先增加认证代理或限制访问网络,不能仅改一个域名就当作完成了团队部署。

Compose 默认使用 latest 镜像,OPEN_SEO_IMAGE 可指定版本。日常维护记录实际镜像版本,升级前保留数据与配置;本文核对时仓库 package.json 为 0.1.10,早期 0.1.7 的配置和当前文档应按版本分别看。

Cloudflare:部署与 Access 一起配置

当前指南要求 Node.js 22.6+、pnpm、可用的 Cloudflare 账号、R2 及相关计费条件,并同样配置 DataForSEO。登录和初始化 Alchemy 状态存储后,使用正确位置的模板准备自托管环境:

cp deploy/.env.selfhost.example .env.selfhost
pnpm deploy:selfhost --yes

这是部署流程中的配置与执行阶段,前面的依赖安装、Cloudflare 登录和 bootstrap 不能跳过。部署会配置 Worker、D1、KV、R2、迁移和 Access;具体变量与权限按同一版本的官方指南准备。

ACCESS_ALLOWED_EMAILS 决定允许访问的邮箱,部署会管理相应 Access 策略。只在控制台手工加人,之后重新部署可能覆盖这些改动,需要按文档选择统一管理方式。一次部署是一个共享工作区,不能把多个客户加入后就假定数据已按租户隔离。

OpenSEO 关键词研究界面,显示关键词指标、趋势图与 SERP 分析
OpenSEO README 展示的关键词研究界面:同屏查看关键词指标、搜索趋势和 SERP 分析。界面中的示例查询与数值只用于展示布局,不代表实时市场数据。来源:https://github.com/every-app/open-seo

将应用、数据和任务流程分别接好

  • 先确认应用可访问,账号与权限符合自己的使用方式。
  • 用一个小范围查询确认 DataForSEO 配置和用量,再扩大关键词或站点分析。
  • 按官方 MCP 文档连接客户端;需要可重复的任务流程时,再选择对应 Skill。
  • 需要关闭产品遥测时,Docker 文档提供 OPENSEO_TELEMETRY_DISABLED=1 或 DO_NOT_TRACK=1,修改后要重建容器配置。

官方对遥测内容的说明不等于独立隐私审计;外部数据查询依然会访问数据供应商。限定页面和查询范围,才能用 OpenSEO 的数据分析具体问题,减少通用 SEO 建议。

  • 项目仓库:https://github.com/every-app/open-seo
  • Docker 自托管指南:https://github.com/every-app/open-seo/blob/main/docs/SELF_HOSTING_DOCKER.md
  • Cloudflare 自托管指南:https://github.com/every-app/open-seo/blob/main/docs/SELF_HOSTING_CLOUDFLARE.md
  • MCP 文档入口:https://openseo.so/docs/mcp
  • Agent Skills 设置:https://openseo.so/docs/skills/setup
OpenSEO | 开源 SEO 平台 - 关键词研究、站点审计与 AI Agent 协作 - 杂货喵
OpenSEO | 开源 SEO 平台 – 关键词研究、站点审计与 AI Agent 协作
此内容为免费资源,请登录后查看
M币0
发布平台GitHub
编码语言TypeScript
部署方式Docker/Cloudflare
项目版本0.1.7
项目许可MIT
收录日期2026年9月3日
免费资源
© 版权声明
THE END
喜欢就支持一下吧
点赞14 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容