【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址https://gitcode.com/GitHub_Trending/cl/claude-seo点击查看免费下载Model Context ProtocolMCP让 claude-seo 这个通用 SEO 技能包具备了调用外部 API、获取真实线上数据的能力从 Google PageSpeed Insights 与 CrUX 的 Core Web Vitals 现场数据到 Search Console 的搜索表现再到 DataForSEO 的 SERP、关键词、外链与 GEO/AI 可见性数据。读完本文你将掌握在 claude-seo 中配置这些 MCP 服务器、用 curl/Python 直接调用 Google 免费 API、并通过官方扩展接入生产级 SEO 数据服务的完整方案。一、为什么需要 MCP从静态分析到实时数据claude-seo 的本地子技能技术 SEO、内容、外链、Schema 等默认基于 HTML 源码和静态规则做分析而 MCP 集成打开了一扇通往外部真实世界的门claude-seo 可以通过 Model Context Protocol 服务器访问外部 API从而增强分析能力见 docs/MCP-INTEGRATION.md。从仓库源码结构看这种集成是分层的直接 HTTP 调用层不需要 MCP 服务器靠 Python 脚本直连 Google 免费 APIPageSpeed Insights v5、CrUXMCP Server 层通过~/.claude/settings.json注册mcpServers让 Claude Code 原生感知工具如mcp-server-gsc、mcp-server-pagespeed官方扩展层仓库内预置的 DataForSEO 扩展 等由安装脚本自动完成 MCP 配置。二、Google 免费 APIPageSpeed Insights 与 CrUX2.1 凭据准备PageSpeed InsightsPSI与 Chrome UX ReportCrUXAPI 是免费且无需 OAuth 的只需要一个 Google API Key。配置步骤在 Google Cloud Console 创建项目在 API Library 中启用PageSpeed Insights API与Chrome UX Report API在 Credentials 中创建 API Key建议限制仅用于上述两个 API。claude-seo 提供了一站式凭据管理脚本 scripts/google_auth.py支持多种方式环境变量GOOGLE_API_KEY配置文件~/.config/claude-seo/google-api.json中的api_key字段校验命令python scripts/google_auth.py --check psi它会按服务区分认证方式PSI/CrUX 用 api_keyGSC/Indexing/GA4 用 OAuth 或服务账号源码中定义的标准请求头是X-Goog-Api-Key见 scripts/google_auth.py 的google_api_key_headers()这也是文档中 curl 示例使用的头部。2.2 直接调用示例curl文档给出了最直接的验证方式——用 curl 测试 PSI APIcurl -H X-Goog-Api-Key: $GOOGLE_API_KEY \ https://www.googleapis.com/pagespeedonline/v5/runPagespeed?urlURL执行后会返回包含 Lighthouse 评分、实验室指标、机会项opportunities等内容的 JSON。可将strategy参数设为mobile或desktop分别测试移动端与桌面端。2.3 Python 方式仓库内置的组合检查器仓库提供了比文档示例更完整的工程化实现scripts/pagespeed_check.py 是一个PSI CrUX 组合检查器把实验室数据与现场数据合并成一份报告。核心端点常量与文档一致PSI_ENDPOINT https://www.googleapis.com/pagespeedonline/v5/runPagespeedCRUX_ENDPOINT https://chromeuxreport.googleapis.com/v1/records:queryRecord典型用法# 默认同时跑 PSImobile desktop与 CrUX 现场数据 python scripts/pagespeed_check.py https://example.com # 只看现场数据必须有 API Key python scripts/pagespeed_check.py https://example.com --crux-only # 只看 Lighthouse 实验室数据JSON 输出 python scripts/pagespeed_check.py https://example.com --psi-only --json脚本还内置了Core Web Vitals 阈值表good/poor 判定指标Good 阈值Poor 阈值单位LCPLargest Contentful Paint25004000msINPInteraction to Next Paint200500msCLSCumulative Layout Shift0.10.25—FCPFirst Contentful Paint18003000msTTFBTime to First Byte8001800ms其中 CLS 在 CrUX 返回中是以字符串编码的脚本做了显式的浮点解析处理见 scripts/pagespeed_check.py这是直接拼装请求时常踩的坑。文档给出的最小 Python 示例同样可直接复用import requests def get_pagespeed_data(url: str, api_key: str) - dict: Fetch PageSpeed Insights data for a URL. endpoint https://www.googleapis.com/pagespeedonline/v5/runPagespeed params { url: url, strategy: mobile, # or desktop category: [performance, accessibility, best-practices, seo] } headers {X-Goog-Api-Key: api_key} response requests.get(endpoint, paramsparams, headersheaders) return response.json()CrUX 现场数据使用 POST 查询queryRecorddef get_crux_data(url: str, api_key: str) - dict: Fetch Chrome UX Report data for a URL. endpoint https://chromeuxreport.googleapis.com/v1/records:queryRecord payload { url: url, formFactor: PHONE # or DESKTOP } headers {Content-Type: application/json, X-Goog-Api-Key: api_key} response requests.post(endpoint, jsonpayload, headersheaders) return response.json()注意仓库的 pagespeed_check.py 还演示了如何把目标区分为URL 级与origin 级查询并在 URL 级无数据时自动回退到 origin 级当目标站点 Chrome 流量不足时 CrUX 会返回 404脚本会给出明确的流量不足提示。2.4 可获得的核心指标来自 PageSpeed Insights实验室数据指标说明LCPLargest Contentful Paint实验室INPInteraction to Next Paint估算CLSCumulative Layout Shift实验室FCPFirst Contentful PaintTBTTotal Blocking TimeSpeed Index视觉加载进度速度来自 CrUX现场数据真实用户指标说明LCP第 75 百分位真实用户INP第 75 百分位真实用户CLS第 75 百分位真实用户TTFBTime to First Byte三、通过 MCP Server 接入Search Console 与 PageSpeed3.1 Google Search Consolemcp-server-gsc需要有机搜索数据search performance、URL 检测、站点地图管理时使用社区 MCP 服务器mcp-server-gsc。在~/.claude/settings.json中注册{ mcpServers: { google-search-console: { command: npx, args: [-y, mcp-server-gsc], env: { GOOGLE_CREDENTIALS_PATH: /path/to/credentials.json } } } }注意GOOGLE_CREDENTIALS_PATH指向的是service account 的 JSON 密钥文件。Search Console API 走 OAuth 或服务账号认证见 scripts/google_auth.py 中gsc: oauth_or_sa的定义且需要把服务账号的client_email添加到 Search Console 的用户和权限中。仓库的 scripts/gsc_query.py 与 scripts/gsc_inspect.py 是这类 API 的本地脚本化实现可作对照参考。3.2 PageSpeed Insights MCP Servermcp-server-pagespeed需要以 MCP 工具方式获取 Lighthouse 审计、CWV 指标和性能评分时使用社区 MCP 服务器mcp-server-pagespeed{ mcpServers: { pagespeed: { command: npx, args: [-y, mcp-server-pagespeed], env: { PAGESPEED_API_KEY: your-api-key } } } }其底层调用的仍是 PSI v5 API只是把请求封装成了 MCP 工具供 Claude Code 在会话中直接调用。3.3 手工注册的一般模式综合仓库内多个 MCP 配置如 extensions/dataforseo/install.sh 的配置片段MCP 服务器统一注册在~/.claude/settings.json的mcpServers节点下标准字段为command启动方式通常是npxargs包名与参数如[-y, dataforseo-mcp-server]env该服务器所需的全部环境变量API Key、凭据路径、模块开关等。安装脚本会以 0600 权限原子化写入该文件避免凭据以明文落入日志或第三方进程。四、2025-2026 生产级 SEO MCP 生态一览MCP 生态在 SEO 领域已相当成熟文档列出的生产可用集成如下工具包 / 端点类型说明Ahrefsahrefs/mcp官方2025 年 7 月发布支持本地与远程模式覆盖外链、关键词、站点审计数据Semrushhttps://mcp.semrush.com/v1/mcp官方远程通过远程 MCP 端点提供完整 API域名分析、关键词研究、外链数据Google Search Consolemcp-server-gsc社区ahonn 开发搜索表现、URL 检测、站点地图PageSpeed Insightsmcp-server-pagespeed社区enemyrr 开发Lighthouse 审计、CWV 指标、性能评分DataForSEOdataforseo-mcp-server官方扩展9 个模块、79 个工具、22 个命令安装方式见下节kwrds.aikwrds MCP server社区关键词研究、搜索量、难度评分SEO Review ToolsSEO Review Tools MCP社区站点审计与页面级分析 API仓库内已内置 Ahrefs 扩展ahrefs/mcp0.0.11官方服务器提供metrics、backlinks、organic、content等命令并可与 seo-backlinks 技能的多源置信度加权配合使用见 extensions/ahrefs/skills/seo-ahrefs/SKILL.md。五、DataForSEO 官方扩展22 条命令的实时 SEO 数据层DataForSEO 是文档中唯一带官方扩展的付费数据源也是 claude-seo 实时数据能力的核心载体。5.1 安装与自动配置# Unix/macOS/Linux ./extensions/dataforseo/install.sh # Windows (PowerShell) .\extensions\dataforseo\install.ps1安装脚本会依次完成校验 Claude SEO 与 Node.js 20 环境 → 交互式收集 DataForSEO 用户名/密码 → 安装 skill 与 agent 文件 → 自动合并 MCP 配置到~/.claude/settings.json→ 预下载 npm 包见 extensions/dataforseo/install.sh。凭据通过 argv 传入内嵌 Python 脚本以 0600 权限原子写入不会泄露到 shell 历史。如果自动配置失败可参照 extensions/dataforseo/docs/DATAFORSEO-SETUP.md 手工添加{ mcpServers: { dataforseo: { command: npx, args: [-y, dataforseo-mcp-server], env: { DATAFORSEO_USERNAME: your-emailexample.com, DATAFORSEO_PASSWORD: your-api-password, ENABLED_MODULES: SERP,KEYWORDS_DATA,ONPAGE,DATAFORSEO_LABS,BACKLINKS,DOMAIN_ANALYTICS,BUSINESS_DATA,CONTENT_ANALYSIS,AI_OPTIMIZATION, FIELD_CONFIG_PATH: /home/youruser/.claude/skills/seo/dataforseo-field-config.json } } } }5.2 9 大模块与 22 条命令DataForSEO 扩展启用了全部 9 个 API 模块见 extensions/dataforseo/README.md模块用途示例命令SERP搜索引擎结果serp、serp-youtube、youtubeKEYWORDS_DATA搜索量、趋势volume、trendsDATAFORSEO_LABS关键词研究、竞品keywords、difficulty、intent、competitors、ranked、subdomains、top-searchesBACKLINKS外链画像backlinks、intersectionONPAGE页面分析LighthouseonpageDOMAIN_ANALYTICS技术栈检测、WHOIStech、whoisBUSINESS_DATA商家列表listingsCONTENT_ANALYSIS内容质量与趋势contentAI_OPTIMIZATIONChatGPT 抓取、LLM 提及ai-scrape、ai-mentions命令示例/seo dataforseo serp best coffee shops # Google 有机 SERP可用 se 参数切 Bing/Yahoo /seo dataforseo keywords seo tools # 关键词想法与建议 /seo dataforseo backlinks example.com # 完整外链画像含垃圾分 /seo dataforseo intersection a.com b.com # 2-20 个域名的关键词/外链交集 /seo dataforseo ai-mentions your brand # 跨 LLM 平台的品牌提及追踪GEO在 SERP 分析中serp_google_images_live_advanced支持 Google Images 图片排名分析site:/filetype:过滤符会产生5 倍 API 成本使用前应提醒用户见 extensions/dataforseo/skills/seo-dataforseo/SKILL.md。5.3 字段过滤节省约 75% Token扩展自带的 field-config.json 通过FIELD_CONFIG_PATH环境变量注入 MCP 服务器只保留 SEO 相关字段如 SERP 的title/url/domain/featured_snippet/ai_overview、backlinks 的spam_score/anchor等把 API 响应体积压缩约 75%既省钱又提速。5.4 成本护栏先估算、再调用、后记账DataForSEO 按调用计费仓库为此实现了成本治理脚本 scripts/dataforseo_costs.py# 调用前估算成本返回 approved / needs_approval / blocked python3 scripts/dataforseo_costs.py check endpoint [--count N] # 调用后记账 python3 scripts/dataforseo_costs.py log endpoint actual_cost # 查看今日/近 7 日支出 /seo dataforseo costs today /seo dataforseo costs summary典型成本参考标准队列美元/次SERP 约 $0.001–0.003、关键词研究约 $0.0005–0.05、外链概要约 $0.002–0.02、页面级 on-page 分析约 $0.01–0.05、AI 优化约 $0.01。新账户通常带有免费试用额度。5.5 与既有技能的联动安装后其他 claude-seo 子技能会自动感知 DataForSEO 可用性并使用实时数据/seo audit用真实 SERP 与外链数据、/seo technical用 on-page 真实抓取、/seo content用关键词量/难度/意图、/seo geo用 ChatGPT 抓取与 LLM 提及、/seo plan用竞品与关键词数据见 extensions/dataforseo/README.md。输出时会标注DataForSEO (live)以区别于静态分析。六、最佳实践文档给出的四条核心实践结合仓库源码可进一步落实为可操作规则Rate Limiting限流尊重 API 配额——PageSpeed 通常为 25,000 次/天源码中标注 240 QPM / 25,000 QPD见 scripts/pagespeed_check.pyCrUX 与 History API 共享 150 QPM。遇到 429 应等待后重试。Caching缓存缓存结果避免重复调用。DataForSEO 的 SKILL 文档同样要求会话内缓存不重复拉取同一数据。Field vs Lab现场优先排名信号优先使用 CrUX 现场数据真实用户第 75 百分位实验室数据仅作诊断参考。仓库的组合检查器同时输出两者并给出评级正是为了支持这种对比。Error Handling错误处理优雅处理 API 错误。仓库脚本对 400参数错误、429限流、404CrUX 无数据、超时120s均有语义化错误信息DataForSEO 侧对 401凭据错误、402余额不足、429每秒限流也给出了明确处置建议。凭据安全Google 侧使用X-Goog-Api-Key请求头而非 URL 参数且 scripts/google_auth.py 提供了redact_google_api_key()在异常输出前抹除 KeyMCP 配置文件统一以 0600 权限写入。七、没有 API Key 时的降级模式如果没有任何 API Keyclaude-seo 仍可完成有价值的静态分析分析 HTML 源码以发现潜在问题识别常见性能问题检查阻塞渲染的资源render-blocking resources评估图片优化机会检测 JavaScript 过重实现此时分析报告会明确注明真正的 Core Web Vitals 测量需要来自真实用户的现场数据field data以此区分静态诊断与实测结果的边界。八、总结claude-seo 的 MCP 集成是一条从免费 Google 数据 → 社区 MCP 服务器 → 官方付费扩展的渐进式实时数据管道零成本阶段可用 curl 或 pagespeed_check.py 获取 PSI/CrUX 数据需要搜索表现数据时注册mcp-server-gsc需要规模化、商业级的 SERP/关键词/外链/GEO 数据时一键安装 DataForSEO 扩展 即可获得 9 大模块、79 个工具、22 条命令配合字段过滤与成本护栏让每一次 SEO 分析都建立在真实、可溯源的数据之上。赞分享【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址https://gitcode.com/GitHub_Trending/cl/claude-seo点击查看免费下载相关推荐claude-seo 的 Google SEO API 实战指南Search Console、CrUX、PageSpeed、Indexing、GA4 一网打尽claude seo 的 Google SEO API 实战指南Search Console、CrUX、PageSpeed、Indexing、GA4 一网打尽claude-seo 电商 SEO 实战DataForSEO Merchant API 端点全解析与 Google Shopping / Amazon 市场数据采集指南claude seo 电商 SEO 实战DataForSEO Merchant API 端点全解析与 Google Shopping / Amazon 市场数如何高效自定义LabelImg导出模板专业开发者实战指南如何高效自定义LabelImg导出模板专业开发者实战指南 LabelImg作为一款开源的图像标注工具支持Pascal VOC、YOLO和CreateML等多上一篇如何免费快速清理重复文件这款开源工具让磁盘瞬间瘦身下一篇Uvicorn 日志系统完全指南从默认配置到自定义日志策略创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
