{无需用脑}把本教程一键复制给 Agent 即可

本文有一段关键内容上了锁,Agent 打开链接也看不到它。请先解锁,再一键复制完整内容给 Agent。

高级:在自己电脑上给 AI Agent 搭一套 SEO 后台

分享

高级教程:在 Windows 的 WSL2 里用 Docker 自己部署开源 SEO 工具 OpenSEO,配好 Docker 的 DNS,接上 DataForSEO 并分清哪些查询花钱,开 3 个 Google API、把 OAuth 同意屏幕改成正式版来接入 Search Console 和 GA4,再把 MCP 和官方 Skills 接给你的 AI Agent,让它查数据、找问题、直接改网站,附两个站的实测结果和常见问题排查表。附 2 段可直接复制的提示词。

你会得到什么

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

先把分工摆对:**OpenSEO 负责把数据集中到一处,AI Agent 负责查和改,花钱和上线由你拍板。**网页后台只是辅助,真正天天用的是接上 Agent 之后的那一步。

自己部署 OpenSEO 并接入 AI Agent 的五步:装好 WSL 里的 Docker、启动 OpenSEO、接上 DataForSEO、接上 Search Console 和 GA4、把 MCP 和 Skills 接给 AI 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,先弄清哪些花钱

  1. 登录 app.dataforseo.com,在 API Access 页面复制 API key(页面上可以直接复制好的那一串)。
  2. 用记事本打开 .env,Windows 里的路径是 \\wsl$\Ubuntu\root\open-seo\deploy\standalone\.env,填上 DATAFORSEO_API_KEY=...,保存。
  3. 跑上一步末尾那条重启命令。

自己部署的版本不走 OpenSEO 的积分,直接扣 DataForSEO 余额:

功能 花不花钱
站点审计爬取(不开 Lighthouse、不渲染 JS,最多 10,000 页) 免费
Search Console、GA4 数据 免费,走 Google 接口
建项目、写项目背景、绑定设置 免费
关键词研究、SERP、域名概览、排名词、外链 按次扣 DataForSEO 余额
Lighthouse 测速 每次约 0.14 美元
排名追踪、AI 可见度 按次扣费,开之前先估算

OpenSEO 站点审计会检查的问题类型,按严重、警告、提示三档分组

图片来自 OpenSEO 官方仓库:免费的站点审计会查的问题,从断链、缺标题到重复内容。

Docker 版没有内置浏览器,审计里的"渲染 JavaScript"要另配 CONTEXT_API_KEY,不配就用不了(也不会扣钱)。在网页上给项目填域名时,可能会自动开始一次 50 页的扫描;用 Agent 通过 MCP 建项目则不会。

第 4 步:接上 Search Console 和 Google Analytics

在 Google Cloud Console 里做,已有的项目和 OAuth 客户端可以直接复用:

  1. 启用 3 个 API:Google Search Console API、Google Analytics Admin API、Google Analytics Data API。只开第一个的话,GA 授权看着成功了,OpenSEO 日志里却会报 Ga4AdminApiError 403,页面显示 Not connected。
  2. OAuth 客户端(类型选"网页应用"):
    • 已获授权的 JavaScript 来源:http://localhost:3001
    • 已获授权的重定向 URI:http://localhost:3001/api/gsc/oauth/callback 和 http://localhost:3001/api/ga4/oauth/callback
  3. **OAuth 同意屏幕的发布状态改成"正式版"(In production)。**一直留在"测试"的话,Google 发的授权 7 天就过期,你得每周重连一次。改成正式版不用提交审核,自己用就行。
  4. 把客户端 ID 和密钥填进 .env,再跑一次重启命令:
GOOGLE_CLIENT_ID=<客户端 ID>.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=<GOCSPX- 开头的整串密钥,注意别漏掉中间的 ->
  1. 在 OpenSEO 里打开项目,进 Settings → Integrations,分别连接 Search Console 和 Google Analytics。看到"此应用未经 Google 验证"是正常的,点 高级 → 前往(不安全),勾选全部权限后继续。
  2. 选好这个项目对应的 Search Console 站点和 GA4 资源。一个 Google 账号下的所有站点都会列出来,每个网站建一个项目,各自绑定。GA4 资源很多时,到 GA 的 管理 → 数据流 里看登记的网址,按网址对应,别只看资源名字。

第 5 步:把 OpenSEO 接给你的 AI Agent

这一步才是部署 OpenSEO 的目的。官方插件只能连托管版,自己部署的要手动接两样:

  1. 加 MCP(对所有项目都可用):
claude mcp add --transport http --scope user openseo http://localhost:3001/mcp
  1. 装 12 个官方 Skills:把 ~/open-seo/plugins/openseo/skills 下的文件夹,复制到 Windows 的 C:\Users\<你的用户名>\.claude\skills\。WSL 里的路径是 \\wsl$\Ubuntu\root\open-seo\plugins\openseo\skills,已有同名的跳过。
  2. **重启 Claude Code。**新加的 MCP 要重启后才会出现在 /mcp 里。
  3. 输入 /mcp,选 openseo,点 Authenticate,在浏览器里登录 OpenSEO 并批准。
  4. 验证:说"用 OpenSEO 查一下连接,列出所有项目",它会调用 whoami 和 list_projects,都不花钱。

接入后,AI Agent 通过 OpenSEO 的 MCP 拉取 Search Console 的查询数据

图片来自 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 就能从"发现问题"一路做到"改代码、上线后核对"。开始前先把规矩定下来,写进它的记忆:

这段关键内容需要登录后解锁

新用户注册就送 10 积分,每天签到再领 1 积分。用 1 积分解锁,以后随时回来都能看。

为什么这样写:先给方案、先报价,是为了管住改错和乱花钱。只提交不推送,上线的按钮就留在你手里。有了跟踪文件,每次新会话都接得上,不用你重新交代一遍。

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 只用免费的网址检查就查清了是哪一种"没收录":

新闻站收录抽查:11 月的新闻 Google 不知道网址,较早的已发现但未收录,首页正常

"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 的效果按周看,别指望改完第二天排名就动。

参考

想先看别人怎么用它天天盯 SEO,看案例 让 AI Agent 每天替你盯着所有网站的 SEO;想先学怎么读 Search Console 的数据,看 让 Claude 用 Search Console 数据找出老页面的缺口。

读完了?标记一下,记录学习进度。登录
收藏起来,稍后再看登录
对这篇有疑问?向 Ask AI 提问

评论(0)

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

登录后参与讨论。登录