你会得到什么
在一台 Windows 电脑上,用 WSL2 里的 Docker 自己部署开源 SEO 工具 OpenSEO,接上 DataForSEO、Google Search Console 和 Google Analytics,最后把它接给你的 AI Agent(下面以 Claude Code 为例)。之后你只要说一句"看看这个站的 SEO 怎么样",它就会自己把各项数据查一遍,找出问题,还能直接到网站代码里改。不用买服务器,不用订阅 Semrush 这类工具,全程大约一小时。文中有 2 段可直接复制的提示词。
先把分工摆对:**OpenSEO 负责把数据集中到一处,AI Agent 负责查和改,花钱和上线由你拍板。**网页后台只是辅助,真正天天用的是接上 Agent 之后的那一步。

为什么值得自己部署
OpenSEO 是开源的(MIT 协议),GitHub 上近三万星,对标 Semrush 和 Ahrefs。自己部署时没有订阅费:Search Console 和 GA4 的数据走你自己的 Google 账号,免费。市场数据(关键词、排名、外链)按次扣 DataForSEO 的余额,用多少付多少。
它常驻要占 2 到 3 GB 内存。云服务器内存不到 4 GB 的话,像这篇一样放在自己电脑上跑更省事。有三件事要盯:
- 数据只在你电脑里:服务只绑在本机的
127.0.0.1:3001,外面访问不到。 - 花钱的查询先报价:DataForSEO 按次计费,让 Agent 先说要花多少再动手。
- Agent 要两样都装:MCP 给它查数据的工具,Skills 教它按 SEO 的流程做事,只装 MCP 它只会零散地查。
第 1 步:准备 Windows、WSL 和 Docker
要求是 Windows 10 或 11、16 GB 内存起。OpenSEO 有 5 个容器,Docker 直接装在 WSL 的 Ubuntu 里,不用 Docker Desktop。
| 准备什么 | 怎么做 | 用来干什么 |
|---|---|---|
| WSL2 + Ubuntu | 在 PowerShell 里跑 wsl --install -d Ubuntu |
Docker 装在这里面 |
| Docker Engine | 在 Ubuntu 里装 docker 和 compose 插件 | 跑 OpenSEO 的 5 个服务 |
| git、openssl | Ubuntu 自带,没有就 apt install |
拉代码、生成随机密钥 |
| DataForSEO 账号 | app.dataforseo.com 注册,先充一小笔 | 关键词、SERP、外链数据 |
| Google 账号 | 能管理你的 Search Console 和 GA4 | 读免费的一手数据 |
| Google Cloud 项目 | 一个"网页应用"类型的 OAuth 客户端 | Google 登录授权,已有的可以复用 |
| AI Agent | 已经装好(这篇用 Claude Code) | 最后一步接 MCP |
所有密钥(DataForSEO key、Google 客户端密钥)只填进服务器上的 .env 文件,不要贴进聊天,也不要提交到代码仓库。
第 2 步:拉代码,启动 OpenSEO
用的是仓库自带的独立 Docker 版 deploy/standalone,里面有 5 个服务:对象存储、运行时、初始化、爬虫网关和对外的 nginx。只有 nginx 对外,而且只绑本机的 3001 端口。
在 WSL 的 Ubuntu 里拉代码,复制一份配置:
cd ~ && git clone https://github.com/every-app/open-seo.git && cd open-seo
cp deploy/standalone/.env.example deploy/standalone/.env
编辑 deploy/standalone/.env,先改这几项(随机值用 openssl rand -hex 32 生成):
STORAGE_SECRET_KEY=<一串随机字符>
BETTER_AUTH_URL=http://localhost:3001
AUTH_MODE=password
**接着给 Docker 配 DNS,这一步不能省。**WSL 默认的域名解析在容器里用不了,缺了它,后面连 Google 时会报 oauth_code_verification_failed。在 /etc/docker/daemon.json 里写上:
{ "dns": ["8.8.8.8", "8.8.4.4"] }
然后 sudo systemctl restart docker。
装过 Docker Desktop 的电脑,docker 命令可能报找不到 docker-credential-desktop.exe。建一个空的配置目录绕开它:
mkdir -p ~/.docker-nocreds && echo '{}' > ~/.docker-nocreds/config.json
export DOCKER_CONFIG=~/.docker-nocreds
启动并检查:
export COMPOSE_FILE=deploy/standalone/compose.yaml
docker compose up -d
docker compose ps # 5 个服务都是 running 或 healthy 就好
在 Windows 浏览器打开 http://localhost:3001 注册账号。第一个注册的人就是管理员,注册完名额就关了,所以部署完马上自己先注册。
以后每次改了 .env,都用这条命令让配置生效:
cd ~/open-seo && DOCKER_CONFIG=~/.docker-nocreds COMPOSE_FILE=deploy/standalone/compose.yaml \
docker compose up -d --force-recreate init web crawl-gateway
Google 登录用的 BETTER_AUTH_SECRET 不用自己填,官方文档说 Docker 版会自动生成。
第 3 步:接上 DataForSEO,先弄清哪些花钱
- 登录 app.dataforseo.com,在 API Access 页面复制 API key(页面上可以直接复制好的那一串)。
- 用记事本打开
.env,Windows 里的路径是\\wsl$\Ubuntu\root\open-seo\deploy\standalone\.env,填上DATAFORSEO_API_KEY=...,保存。 - 跑上一步末尾那条重启命令。
自己部署的版本不走 OpenSEO 的积分,直接扣 DataForSEO 余额:
| 功能 | 花不花钱 |
|---|---|
| 站点审计爬取(不开 Lighthouse、不渲染 JS,最多 10,000 页) | 免费 |
| Search Console、GA4 数据 | 免费,走 Google 接口 |
| 建项目、写项目背景、绑定设置 | 免费 |
| 关键词研究、SERP、域名概览、排名词、外链 | 按次扣 DataForSEO 余额 |
| Lighthouse 测速 | 每次约 0.14 美元 |
| 排名追踪、AI 可见度 | 按次扣费,开之前先估算 |

图片来自 OpenSEO 官方仓库:免费的站点审计会查的问题,从断链、缺标题到重复内容。
Docker 版没有内置浏览器,审计里的"渲染 JavaScript"要另配 CONTEXT_API_KEY,不配就用不了(也不会扣钱)。在网页上给项目填域名时,可能会自动开始一次 50 页的扫描;用 Agent 通过 MCP 建项目则不会。
第 4 步:接上 Search Console 和 Google Analytics
在 Google Cloud Console 里做,已有的项目和 OAuth 客户端可以直接复用:
- 启用 3 个 API:Google Search Console API、Google Analytics Admin API、Google Analytics Data API。只开第一个的话,GA 授权看着成功了,OpenSEO 日志里却会报
Ga4AdminApiError 403,页面显示 Not connected。 - OAuth 客户端(类型选"网页应用"):
- 已获授权的 JavaScript 来源:
http://localhost:3001 - 已获授权的重定向 URI:
http://localhost:3001/api/gsc/oauth/callback和http://localhost:3001/api/ga4/oauth/callback
- 已获授权的 JavaScript 来源:
- **OAuth 同意屏幕的发布状态改成"正式版"(In production)。**一直留在"测试"的话,Google 发的授权 7 天就过期,你得每周重连一次。改成正式版不用提交审核,自己用就行。
- 把客户端 ID 和密钥填进
.env,再跑一次重启命令:
GOOGLE_CLIENT_ID=<客户端 ID>.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=<GOCSPX- 开头的整串密钥,注意别漏掉中间的 ->
- 在 OpenSEO 里打开项目,进 Settings → Integrations,分别连接 Search Console 和 Google Analytics。看到"此应用未经 Google 验证"是正常的,点 高级 → 前往(不安全),勾选全部权限后继续。
- 选好这个项目对应的 Search Console 站点和 GA4 资源。一个 Google 账号下的所有站点都会列出来,每个网站建一个项目,各自绑定。GA4 资源很多时,到 GA 的 管理 → 数据流 里看登记的网址,按网址对应,别只看资源名字。
第 5 步:把 OpenSEO 接给你的 AI Agent
这一步才是部署 OpenSEO 的目的。官方插件只能连托管版,自己部署的要手动接两样:
- 加 MCP(对所有项目都可用):
claude mcp add --transport http --scope user openseo http://localhost:3001/mcp
- 装 12 个官方 Skills:把
~/open-seo/plugins/openseo/skills下的文件夹,复制到 Windows 的C:\Users\<你的用户名>\.claude\skills\。WSL 里的路径是\\wsl$\Ubuntu\root\open-seo\plugins\openseo\skills,已有同名的跳过。 - **重启 Claude Code。**新加的 MCP 要重启后才会出现在
/mcp里。 - 输入
/mcp,选 openseo,点 Authenticate,在浏览器里登录 OpenSEO 并批准。 - 验证:说"用 OpenSEO 查一下连接,列出所有项目",它会调用
whoami和list_projects,都不花钱。

图片来自 OpenSEO 官方仓库:一句话让 Agent 拉出最近 28 天的搜索词、点击、展示和排名。
接通后,第一件事就让 Agent 把项目搭好,不用自己点网页:
请用 OpenSEO 帮我把项目搭好,全程只用不花钱的操作:
1. 给 [网站 A]、[网站 B] 各建一个项目
2. 对照 Search Console 的站点和 GA4 资源(按数据流里登记的网址),给每个项目绑定对应的那一个,绑不上的列出来问我
3. 每个项目的目标市场是 [国家和语言],你改不了的告诉我去哪改
4. 最后跑一次 /seo-project-setup,问我网站做什么、目标是什么、对手是谁,写进项目背景
任何会扣 DataForSEO 余额的查询,先告诉我要查什么、大概花多少,等我确认
为什么这样写:绑定这一步最容易错站,所以让它按网址对应。目标市场决定以后所有付费查询用哪个国家和语言,MCP 改不了,得你在项目 Settings 里改。项目背景写好后,之后每个 Skill 都会用到。
接上以后,它手里有哪些本事
按类别看,Agent 能通过 OpenSEO 做这些事(自己部署时的收费情况):
| 类别 | 能做什么 | 花钱吗 |
|---|---|---|
| 项目管理 | 每个网站一个项目,记下域名、目标市场、业务背景、对手和重点页面;做过的研究也记着,不重复花钱 | 免费 |
| Search Console | 按词、页面、国家、设备、日期看点击、展示和排名;找快上首页的词;查网址收录状态和原因 | 免费 |
| Google Analytics | 自然流量、落地页、流量来源、转化事件、站内搜索,以及跟踪代码装得对不对 | 免费 |
| 站点审计 | 爬全站查断链、标题和描述、canonical、重定向、薄内容、孤立页面、标题层级、慢页面 | 爬取免费,Lighthouse 测速另算 |
| 关键词研究 | 找词,查搜索量、难度和点击单价,保存并聚类 | 收费 |
| 搜索结果和对手 | 看某个词的搜索结果、谁在跟你抢排名、对手域名概况和排名词 | 收费 |
| 外链 | 外链概况、明细、找外链机会 | 收费 |
| 排名追踪 | 选一批词定期查排名,看变化 | 收费,按词数和频率算 |
| 本地 SEO | Google 商家资料、评价、本地搜索结果、地图排名网格 | 收费 |
| AI 可见度 | ChatGPT、Gemini 这类 AI 回答相关问题时会不会提到你、引用了哪些来源 | 收费,开之前先估价 |
| 报告 | 把分析结果存成 HTML 报告,可以做成模板、分享出去 | 免费 |
那 12 个官方 Skills,就是让 Agent 按固定流程把这些串起来做:
| Skill | 管什么 |
|---|---|
seo-project-setup |
建项目背景 |
seo-audit |
完整审计 |
keyword-research |
找关键词 |
keyword-clustering |
给关键词分组 |
competitor-analysis |
分析单个对手 |
competitive-landscape |
看整个市场格局 |
link-prospecting |
找外链机会 |
local-seo |
本地商家 |
ai-prompt-research |
研究大家会怎么问 AI |
ai-visibility-audit |
审计 AI 可见度 |
seo-report |
出报告 |
seo-coach |
不知道从哪开始时用它 |
第 6 步:日常怎么用,以及让它直接改网站
| 你说 | Agent 做什么 | 花钱吗 |
|---|---|---|
| "看下目前状态,尽量不要花钱" | 读项目、Search Console、GA,按站汇总 | 不花 |
| "X 站哪些词快上首页了" | 找排第 5 到 20 名、展示多的词和对应页面 | 不花 |
| "这几篇有没有被收录" | 用 Google 的网址检查看收录状态和原因 | 不花 |
| "先免费审计一下 X" | 爬全站查断链、标题、canonical、薄内容 | 不开 Lighthouse 就不花 |
/seo-audit |
完整审计加域名和外链数据,出报告 | 花一点,先让它报价 |
/keyword-research、/competitor-analysis |
找词、看对手 | 花钱,先让它报价 |
把网站代码 clone 到同一个工作目录(比如 sites\<站名>),Agent 就能从"发现问题"一路做到"改代码、上线后核对"。开始前先把规矩定下来,写进它的记忆:
为什么这样写:先给方案、先报价,是为了管住改错和乱花钱。只提交不推送,上线的按钮就留在你手里。有了跟踪文件,每次新会话都接得上,不用你重新交代一遍。
OpenSEO 的 Skills 不会自动更新,升级 OpenSEO 后记得重新复制一遍。
实际跑一遍:两个站查出了什么
下面是我们用这套流程给两个自己的网站做的检查,数字都是真实结果。
第一个是软件下载站。免费审计查出一串问题,Agent 先逐条给方案,确认后才改:

它还从 Search Console 里发现,用户搜的是"软件名 + 下载",标题里却没有"下载"这个词,于是给几个快上首页的下载页标题补上:
| 页面 | 改前 | 改后 |
|---|---|---|
| 英文下载页 A | NX2Apple - Run your Switch games… | NX2Apple Download - Run your Switch games… |
| 英文下载页 B | Savage Wind Recomp - Zelda Breath of the Wild… | Savage Wind Recomp Download - Zelda Breath of the Wild… |
| 中文下载页 | TotK Recomp - 塞尔达王国之泪原生 PC 移植版 | TotK Recomp 下载 - 塞尔达王国之泪原生 PC 移植版 |
第二个是新闻站。它的问题不在细节:一千多篇新闻几乎都没进 Google。Agent 只用免费的网址检查就查清了是哪一种"没收录":

"Google 不知道这个网址"和"已发现但未收录"是两种病:前一种要让 Google 找得到(网站地图、内链),后一种要让它觉得值得收(内容质量、重复度)。分清了再改,才不会白忙。
常见问题
| 现象 | 原因 | 怎么办 |
|---|---|---|
localhost:3001 打不开 |
WSL 闲置后自动停了 | 打开一次 WSL;想常驻就在后台跑 wsl -d Ubuntu -e sleep infinity,或做成开机计划任务 |
连 Google 时显示 connection didn't finish,或 oauth_code_verification_failed |
容器解析不了 Google 的域名、客户端密钥没填完整,或 Search Console API 没启用 | 依次查第 2 步的 DNS、.env 里的密钥、API 是否启用 |
| GA 显示 Not connected | Analytics 的两个 API 没启用 | 启用后等一两分钟重连 |
| 重定向 URI 不匹配 | OAuth 客户端里没加回调地址 | 加上第 4 步的两个 URI,保存后等几分钟 |
| 授权过了 7 天失效 | 同意屏幕还在"测试" | 改成"正式版" |
/mcp 里看不到 openseo |
加完 MCP 没重启 | 退出后用 claude --continue 接着刚才的会话 |
| 关键词数据都是美国的 | 项目默认市场是美国、英文 | 在项目 Settings 里改 Country |
出了问题想看日志(顺手过滤掉密钥):
cd ~/open-seo && DOCKER_CONFIG=~/.docker-nocreds COMPOSE_FILE=deploy/standalone/compose.yaml \
docker compose logs --since 30m 2>&1 | grep -iE "error|oauth|ga4" | grep -viE "secret|token" | tail -40
注意
- DataForSEO 先充一小笔、关掉自动充值,第一周盯着余额看。
- 别把 3001 端口开到公网。要从外面访问,先看官方文档里关于反向代理和 HTTPS 的说明。
- 升级前先看仓库的
docs/release-notes和docs/SELF_HOSTING_DOCKER.md,有没有要手动处理的事,升级后重新复制 Skills。 - SEO 的效果按周看,别指望改完第二天排名就动。
参考
- OpenSEO GitHub 仓库
- OpenSEO 官方文档:Docker 自部署
- OpenSEO 官方文档:接入 Google Search Console
- OpenSEO 官方文档:接入 Google Analytics
想先看别人怎么用它天天盯 SEO,看案例 让 AI Agent 每天替你盯着所有网站的 SEO;想先学怎么读 Search Console 的数据,看 让 Claude 用 Search Console 数据找出老页面的缺口。


评论(0)
还没有评论,来说第一句。