--- title: '把 Claude Code 变成你的专属 SEO 分析师' video_id: quYneNBX4ck url: https://youtu.be/quYneNBX4ck title_en: "I Turned Claude Code Into My Personal SEO Analyst (Here's How)" channel: Semrush published: 2026-04-09 duration: "20:52" topics: - AI SEO / AEO - MCP 与工具调用 - Claude Code 定制扩展 noted: 2026-07-08 value: A views: '9,878' --- [![封面](https://i.ytimg.com/vi/quYneNBX4ck/maxresdefault.jpg)](https://youtu.be/quYneNBX4ck) > Semrush · 20:52 · 发布 2026-04-09 · 9,878 次观看(截至抓取) · [观看原视频](https://youtu.be/quYneNBX4ck) ## 主旨 把 Claude Code + GSC + GA4 + Semrush MCP 串成一个"个人 SEO 分析师":7 步走通(安装 Claude Code / 连 GSC+GA4 API / 接入 Semrush MCP / 缓存数据 / 一键建 dashboard / 生成报告 / 对话查数据),不需要会写代码。Chris 用 Traffic Think Tank(Semrush 旗下 SEO 教育站)做案例示范,完整流程跑下来可输出可交互的 5 tab dashboard + Word 报告 + 自然语言查询易胜词清单。 ## 核心论点 1. **"对话式 SEO 数据"是 Claude Code + 第三方数据源的最大价值**——把 SEO 工具的数据变成"可以问问题的对象",而不是"需要人去翻的图表" [18:58](https://youtu.be/quYneNBX4ck?t=1138)。([[#7-step-7对话查数据-1851--1858|→ 详解7]]) 2. **fetcher scripts + Claude.md 是 Claude Code 做 SEO 任务的最小配置**——fetcher 拉数据,Claude.md 写入业务上下文,Claude 就能理解"该对这些数据做什么" [01:54](https://youtu.be/quYneNBX4ck?t=114) / [03:17](https://youtu.be/quYneNBX4ck?t=197)。([[#1-step-1安装--文件结构--claudemd-0036--0154--0317|→ 详解1]]) 3. **MCP 是 Claude Code 接入第三方 SaaS 的标准协议**——Semrush 把全量 SEO 数据通过 MCP 暴露,Claude Code 像调工具一样调数据 [10:16](https://youtu.be/quYneNBX4ck?t=616)。([[#3-step-3连接-semrush-mcp-1004--1016|→ 详解3]]) 4. **AI 输出的 SEO 结论必须人工 validate**——LLM 可能 hallucinate 数字、可能拉错数据源,跑通后必须复核才能交给客户 [16:49](https://youtu.be/quYneNBX4ck?t=1009)。([[#6-step-6下载报告word-文档-1707--1724--1732|→ 详解6]]) ## 知识点详解 ### 1. Step 1:安装 + 文件结构 + Claude.md [00:36](https://youtu.be/quYneNBX4ck?t=36) / [01:54](https://youtu.be/quYneNBX4ck?t=114) / [03:17](https://youtu.be/quYneNBX4ck?t=197) **安装**两种方式:Mac/Windows 桌面 app(本视频走这条)或 terminal 命令行。 **文件结构**(让 Claude Code 一次性建好): - `fetchers/` —— 存 GSC/GA4/Google Ads 的数据抓取脚本(Snippet 形式,Claude 自动跑) - `data/GSC / data/GA4 / data/ads` —— 存各源数据 - `dashboard/` —— 存 Claude 一键生成的 web app 仪表盘 - `reports/` —— 存生成的 Word 报告 **Claude.md**(本项目最关键的配置文件):把"业务上下文"塞进 Markdown——网站域名、类型、目标、竞品列表、数据源、博客主题、内容是否 gated。**Claude 全程会参考这个文件理解"该对数据做什么"**——这是把通用 Claude Code 变成"专属 SEO 分析师"的关键一步 [02:58](https://youtu.be/quYneNBX4ck?t=178)。 ### 2. Step 2:连接 GSC + GA4(API 优先) [04:20](https://youtu.be/quYneNBX4ck?t=260) / [04:45](https://youtu.be/quYneNBX4ck?t=285) 两种接法: - **API 路由**(强烈推荐):在 Google Cloud Console 建项目 → 启用 Search Console API + Analytics Data API → 建 service account 拿 JSON key → 把 key 上传到 Claude Code → 在 GSC / GA4 后台给这个 service account 加 read 权限 [06:25](https://youtu.be/quYneNBX4ck?t=385) - **CSV 路由**(临时):下载 GSC/GA4 CSV 丢给 Claude,让它存进 `data/GSC / data/GA4` 文件夹 API 路由的好处:**可以随时让 Claude 调数据**(实时)、不需要重复下载 CSV。CSV 路由只适合一次性的临时分析。 **安全警告**:service account 的 JSON key 是私有凭证,上传到 Claude Code 后**只在项目目录内可用**;Claude 是 agent,不要给它整盘访问权限。 ### 3. Step 3:连接 Semrush MCP [10:04](https://youtu.be/quYneNBX4ck?t=604) / [10:16](https://youtu.be/quYneNBX4ck?t=616) MCP = **Model Context Protocol**,Linux Foundation 旗下跨厂商标准,让 Claude Code(以及任何 LLM 工具)像调本地函数一样调外部 SaaS 的数据。Semrush 在所有 SEO Classic / Semrush One 订阅里**默认带 MCP 访问 + 一批 API units**。 配置: - Terminal 用户:在 Claude Code 输入 MCP 命令,选 Semrush,走 OAuth 授权 - Desktop app 用户:Settings → Connectors → Add custom connector → 填 Semrush MCP remote server URL 接好后,Claude Code 调 Semrush 就像调一个 tool——可以直接问"我的域名 top 10 关键词是什么",自动返回 position / volume / KD / ranking URL [11:51](https://youtu.be/quYneNBX4ck?t=711)。 **已知限制**:MCP 当前不直接拉 Semrush AI visibility toolkit 的数据,但可以手动 export → 喂给 Claude Code,实现"SEO 数据 + AI 引用数据"交叉分析 [12:01](https://youtu.be/quYneNBX4ck?t=721)。 ### 4. Step 4:缓存 Semrush 数据 [12:39](https://youtu.be/quYneNBX4ck?t=759) 在让 Claude 建 dashboard 之前,**先缓存一批 Semrush 基础数据**——Claude 一键建 dashboard 时直接用缓存数据填表,不用每次临时调 API。 策略: - **API units 是硬约束**——cache 太多会爆 units,推荐"够 dashboard 用就行" - **context window 也是约束**——cache 太大每次 Claude 处理都费 token - **不要直接让 Claude 拉"全球所有关键词"**——只缓存你目标市场的子集 实操:用 `cache` 类的 prompt 让 Claude 跑一次,数据落到 `data/semrush/`。 ### 5. Step 5:一键建 dashboard [13:40](https://youtu.be/quYneNBX4ck?t=820) / [15:41](https://youtu.be/quYneNBX4ck?t=941) / [15:48](https://youtu.be/quYneNBX4ck?t=948) 用一条 prompt 让 Claude Code **基于已有数据建一个完整 web app dashboard**,本地起服务可访问。Chris 的 prompt 模板产出 5 tab: 1. **Overview** —— 总 clicks / impressions / estimated traffic 2. **Striking distance keywords** —— 排名 position 5-20 的"易胜词",可按 GSC clicks / Semrush volume / KD 排序 3. **Competitive gap** —— 竞品差距分析 4. **Content performance** —— 内容表现 5. **Backlink profile** —— 外链档案 **坑**:Chris 第一次跑用了 10+ 分钟、token 涨到 5000+ 后**主动 stop 重跑**——建议"4-5 分钟没结果就停"避免烧 token。第二次重跑通常更快出结果。 **分享**:把 dashboard 部署到 Vercel / Netlify 给客户 / 团队成员看(用 Claude Code 自己搞定 deploy 流程即可) [16:15](https://youtu.be/quYneNBX4ck?t=975)。 ### 6. Step 6:下载报告(Word 文档) [17:07](https://youtu.be/quYneNBX4ck?t=1027) / [17:24](https://youtu.be/quYneNBX4ck?t=1044) / [17:32](https://youtu.be/quYneNBX4ck?t=1052) 用 prompt 让 Claude 生成 Word 格式报告(可转 Google Docs 二次编辑),典型结构: - Executive summary(高管摘要) - Quick wins(易胜词清单) - Competitive benchmarking(竞品对照) - Backlink opportunities(外链机会) - Content performance(内容表现) **关键警告**:**所有 LLM 生成的数据必须人工 validate**——可能 hallucinate 数字、可能拉错数据源、可能从错误位置取数据 [16:49](https://youtu.be/quYneNBX4ck?t=1009) / [16:59](https://youtu.be/quYneNBX4ck?t=1019)。在交付给客户 / 用于决策前,必须自己核对每个数字。 **权限管理** Chris 第一次跑 Word 报告时,Claude 要了一大堆额外权限——他主动 stop,问"你到底需要什么权限生成 Word",Claude 列出最小必需项,只授权那些就行。 ### 7. Step 7:对话查数据 [18:51](https://youtu.be/quYneNBX4ck?t=1131) / [18:58](https://youtu.be/quYneNBX4ck?t=1138) 把 GSC 数据 + Semrush 关键词难度 / 搜索量组合,**用自然语言问 Claude "我应该优先攻哪些关键词"**: > "Find queries where we're ranking okay but not great, with impressions, and combine with Semrush KD/volume. Give me 64 easiest wins." Claude 直接吐出 Traffic Think Tank 站点的 64 个易胜词清单。 **核心价值**:**这是"对话式 SEO 数据"的真正威力**——以前这种"KD × GSC position × 流量价值"的多维筛选要在 Semrush UI 里点 N 次;现在一句话搞定。 **进一步**:把这种对话式查询变成"工作流模板"——描述里给 5 个现成 prompt,直接套用;也可以按自己的需求改。 ## 可执行步骤 - [ ] 装 Claude Code(Mac/Windows 桌面 app 或 terminal),建好 `fetchers / data / dashboard / reports` 文件结构 - [ ] 写 `Claude.md` —— 填入域名、类型、目标、竞品、数据源 - [ ] 走 Google Cloud Console 流程:建项目 → 启用 GSC + GA4 Data API → 建 service account 拿 JSON key → 在 GSC/GA4 加 read 权限 - [ ] 把 JSON key 上传 Claude Code,存到 `data/` 目录 - [ ] 在 Claude Code 接入 Semrush MCP(Desktop app 用 custom connector,Terminal 用 MCP 命令) - [ ] 先 cache 一批 Semrush 基础数据(够 dashboard 用即可,别贪) - [ ] 用 dashboard prompt 模板让 Claude 一键建 web app 仪表盘,本地起服务查看 - [ ] 用报告 prompt 模板生成 Word 报告,自己 validate 每个数字再交付 - [ ] 把"对话查数据"模板套到自己域名,做一轮关键词易胜词分析 ## 关联 - 互补:[[MCP]] —— 已定义为"LLM 调外部工具/数据的标准协议,喻为 AI 的 USB",本片展示 Semrush 用 MCP 把 SEO 数据(top organic keywords / AI visibility 等)暴露给 Claude Code,实操 7 步搭"个人 SEO 分析师"——MCP 在 SEO 域的具体落地,接 GSC+GA4 API 后 Claude 可一句话问"我域名最容易攻的关键词是哪些" - 印证:Striking Distance Keywords —— 已定义为"排名接近首页只差一点授权就能冲上去的词/页",本片 Chris 把 position 5-20 的 striking distance keywords 作为 dashboard 第二 tab,展示"按 GSC clicks / Semrush volume / KD 排序挑易胜词"的实操,给出"对话式查询"模板(找 KD × GSC position × 流量价值的最优组合) ## 一手来源与延伸 - Semrush MCP 注册入口(本期重点):https://social.semrush.com/4uChtRd - Semrush MCP 官方文档:https://www.semrush.com/kb/1619-getting-started-with-mcp - Claude Code quickstart:https://code.claude.com/docs/en/quickstart - Chris 提供的 prompt 文档(本期配套):https://docs.google.com/document/d/12Iy66mU496nmy6rdqC9tR5RJHZQ_ximAJpcd6svGyG4/copy - Google 文档:为 GSC 加 user(https://support.google.com/webmasters/answer/7687615?hl=en)/ 为 GA4 加 user(https://support.google.com/analytics/answer/9305788?hl=en) - Semrush 免费试用(本期 affiliate):https://social.semrush.com/3RWb7xr - Semrush Academy(职业向):https://social.semrush.com/43tyReQ ## 术语 - MCP(Model Context Protocol):Linux Foundation 旗下跨厂商标准,让 LLM 像调本地函数一样调外部 SaaS 数据/工具 - GSC(Google Search Console):Google 官方的"网站在 Google 搜索里的表现"后台 - GA4(Google Analytics 4):Google 当前的网站分析平台 - Fetcher scripts(数据抓取脚本):Claude Code 用来从 GSC/GA4/Google Ads 拉数据的代码片段 - Claude.md(项目记忆文件):放在 Claude Code 项目根的 Markdown 文件,写业务上下文——Claude 全程参考 - Service account(GCP 服务账号):Google Cloud 提供的"非人类用户"身份,给 AI / 脚本访问 Google API 用 - Stale cache(陈旧缓存):过期数据;Semrush 数据 cache 要定期刷新 - Striking distance keywords(易胜词):排名 position 5-20 的关键词——已有点击,推一把就上首页 - Hallucination(LLM 幻觉):LLM 生成的虚假数字 / 结论;本期 Chris 反复警告必须人工 validate - API units(API 单位):Semrush MCP 的硬配额,cache / 调一次消耗一定量 - AI visibility tool kit(Semrush AI 可见度工具):Semrush 测"你的品牌在 AI 答案里被引用多少次"的工具(本期未走 MCP,改走 export → Claude) ## 金句 > **"I promise you do not need to know how to code to use it."** > —— [00:36](https://youtu.be/quYneNBX4ck?t=36) > 为什么值得记:Chris 把"非程序员也能用 Claude Code 做严肃 SEO 工作"作为本片前提——这与"Claude Code = 程序员工具"的常规印象相反。 > **"It's basically a way for Claude Code to speak to the SEMrush interface and allow data flow that you can then use and speak to effectively."** > —— [10:16](https://youtu.be/quYneNBX4ck?t=616) > 为什么值得记:把 MCP 的价值用"对话式"语言说清楚——MCP 不是"接数据库",是"让 Claude 跟 SaaS 对话"。 > **"You don't want to make decisions on data that is either hallucinated by the AI or if it's drawing conclusions that are inaccurate, you don't want to act on that data. So just always be extra careful."** > —— [16:49](https://youtu.be/quYneNBX4ck?t=1009) / [16:59](https://youtu.be/quYneNBX4ck?t=1019) > 为什么值得记:Chris 反复强调 LLM SEO 数据的"validate before share"——这条对所有"AI 自动化分析"工作流都适用,不只是 SEO。 ## 立场与利益 - 与利益同向(待印证):本片对"Claude Code + Semrush MCP 7 步走"的易用性主张——与 Semrush 自身订阅产品(本期 affiliate 强绑定)同向。**MCP 实际稳定性 + 7 步流程的真实搭通率 + LLM SEO 数据的 hallucination 频率,这些需独立测试,不要只信官方教程**。 - 利益中性:对 MCP / Claude Code / GSC+GA4 工具机制的客观介绍——这些是技术事实,无变现关联,按内容采信。 - 与利益反向(可信度最高):Chris 反复警告"LLM 数据必须人工 validate" [16:49](https://youtu.be/quYneNBX4ck?t=1009) / [16:59](https://youtu.be/quYneNBX4ck?t=1019)——主动给产品泼冷水,与卖课 / 卖订阅利益反向,反而证明 Semrush 没在无脑站台。 利益证据:description 头部 `social.semrush.com/4uChtRd`(MCP 注册) + `social.semrush.com/3RWb7xr`(免费试用) + 视频结尾"Sign up via the link in the description below"——本片是 Semrush 官方频道 + 课程级 affiliate。 ## 价值定位 - **适合谁**:已经在用 Semrush(或准备用)做 SEO 的人;想把 GSC/GA4 数据从"翻图表"升级到"对话式查询"的人;以及想用 Claude Code 做严肃业务自动化、又怕不知道怎么起步的人 - **解决什么**:给一个 7 步走的"Claude Code + Semrush MCP"完整工程流 + 5 tab dashboard 的 prompt 模板 + 易胜词对话查询模板 - **认知 vs 实操**:强实操——7 步都有 prompt 模板可拷,但**前期配置(GCP project / service account / OAuth)有学习成本**,不是 5 分钟能跑通的 - **与已有笔记重叠**:vault 内 semrush 频道此前无笔记,无可比;与"AI SEO / AEO"、"MCP 与工具调用"主题的 vault 内笔记可能重叠(命中才写,暂无) ## 自检问题 1. Chris 用的最小 Claude Code 配置是什么?fetcher scripts 和 Claude.md 各自承担什么角色? **答案**:文件结构 fetchers / data / dashboard / reports + Claude.md。fetcher 拉数据,Claude.md 写业务上下文让 Claude 理解"该对数据做什么"。锚点:详解1。 2. GSC + GA4 接 Claude Code 有哪两条路?为什么 Chris 强烈推荐 API 路由? **答案**:API 路由(GCP project + service account + JSON key)和 CSV 路由(下载后丢 Claude)。API 路由优势:可随时让 Claude 调数据(实时)、不需重复下载 CSV。锚点:详解2。 3. 什么是 MCP?为什么 Semrush 把 SEO 数据通过 MCP 暴露给 Claude Code 很重要? **答案**:Model Context Protocol——跨厂商标准,让 LLM 像调本地函数一样调外部 SaaS。Semrush 走 MCP 后,Claude Code 调 Semrush 数据像调 tool,直接问"我域名 top 10 关键词"就能拿。锚点:详解3。 4. "Striking distance keywords" 是什么?为什么 Chris 用 5-20 位置定义它? **答案**:排名 position 5-20 的关键词——已有点击和 impressions,推一把就上首页。position 5-20 是在"几乎上榜 + 还有优化空间"的甜蜜区。锚点:详解5。 5. Chris 反复强调"LLM SEO 数据必须人工 validate"具体指什么风险?为什么他主动 stop Claude 要权限的尝试? **答案**:LLM 可能 hallucinate 数字、拉错数据源、从错误位置取数据——在交付前必须自己核对。Chris 第一次跑报告时 Claude 要了一大堆额外权限,他 stop 后追问"最小必需项是哪些"——避免给 agent 过度授权。锚点:详解6。