动手写你自己的SEO技能open-seo-mcp-skills的SKILL.md结构与MCP工具调用规范详解【免费下载链接】open-seo-mcp-skillsFree SEO MCP server open-source SEO and GEO skills for Claude: keyword research, rank tracking, audits, backlinks, AI visibility on your real GSC/GA4/ads data. claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp项目地址: https://gitcode.com/gh_mirrors/op/open-seo-mcp-skillsopen-seo-mcp-skills 是一套完全开源的 SEO 技能包它为 Claude 等 AI 助手提供关键词研究、排名追踪、网站审计、外链分析、AI 可见度等 8 个 SEO 技能所有数据来自你真实的 Google Search Console 和 GA4 账号。本文带你拆解 README.md 背后的核心机制一个技能文件SKILL.md到底长什么样、MCP 工具调用有什么命名规范读完你就能动手写出属于自己的第一个 SEO 技能。先认识一下内置的 8 个 SEO 技能项目的 skills/ 目录下有 8 个技能每个技能就是一个文件夹 一个SKILL.md文件技能干什么数据来源seo-audit整站 SEO 审计收录、CTR 异常、衰退页面GSC GA4keyword-research种子词 → 关键词计划Google Ads DataForSEOrank-tracking两期之间的排名涨跌对比GSCcompetitor-gap找到对手有排名而你没有的词DataForSEO GSCbacklink-check外链画像 与对手的链接差距DataForSEOai-visibilityChatGPT、Perplexity 等带来的真实流量GA4 AI 引荐报表content-brief基于真实 SERP 的内容大纲DataForSEO GSCseo-vs-ads找出付费买到的免费流量GSC × Google Ads这些技能是 MIT 协议的——你可以直接拿走、修改、发布成自己的版本。而修改一个技能本质上就是改一个 Markdown 文件下面拆解它的标准结构。SKILL.md 文件结构拆解一个技能的四个区块以最典型的 skills/seo-audit/SKILL.md 为模板一个合格的技能文件由 4 个区块组成1️⃣ YAML 头部name description文件开头是被---包裹的元信息见 SKILL.md 第1~4行name技能名与文件夹名一致如seo-auditdescription这是最关键的一行。除了说明做什么还要写明什么话触发它——例如审计技能的描述里列出了用户常说的audit my site、SEO audit、why is my organic traffic down。Claude 正是靠这句话判断该不该调用你的技能。 写技能的第一个技巧在 description 里把用户可能的 3~5 种问法都列出来。2️⃣ Requires声明依赖每个技能都有## Requires区块统一声明依赖免费的 Ryze MCP 连接器。这是所有技能共用的数据高速公路负责把 GSC、GA4、Google Ads、DataForSEO 的接口打包暴露给 AI。3️⃣ Workflow分步工作流这是技能的大脑。以 seo-audit 的工作流 为例它把审计拆成 7 个编号步骤选站点 → 查收录 → 拉 90 天数据做环比 → 找出衰退页/CTR 异常/差一步上首页的词/内耗词 → 抽查最差页面 → 用 GA4 交叉验证流量 → 看 AI 引荐。注意每步都写清了调哪个 MCP 工具、传什么参数如dimensions 传 query 和 page各期调两次这是让 AI 稳定执行的核心。4️⃣ Output规定交付格式## Output区块规定最终报告长什么样seo-audit 要求结论放最前一段话说明站点健康与否 头号问题然后分章节配表格最后给 5 条优先行动清单。再如 seo-vs-ads 要求第一句话就是你每季度为本来排第 1 的点击多花了 $X。 小技巧很多技能还带## Fallbacks数据源缺失时怎么办和## Rules红线规则如 keyword-research 中的永远不许编造搜索量。写上回退方案技能才可靠。MCP 工具调用规范两条命名规则技能的 Workflow 里频繁出现带双下划线的工具名这就是 MCP 工具的命名规范写在 README.md 的 Notes for skill authors 一节规则一provider__tool命名空间工具名 数据提供方 __ 具体工具例如google_search_console__runRawSearchAnalytics—— 拉 GSC 搜索表现原始数据google_ads__generateKeywordIdeas—— 生成关键词创意google_analytics__getAIReferrals—— 查 AI 引擎引荐明细写技能时按我要哪个平台的数据去前缀匹配即可一眼可读。规则二不确定参数形状时先问文档工具当某个工具的请求格式拿不准规范做法是先调用native__get_provider_docs传入 provider 名dataforseo、google_search_console、google_ads……它会返回该平台的官方 API 文档。content-brief 里就是这么写的拉取实时 SERP 前先用native__get_provider_docs确认请求格式。⚠️ 还有一点工具可用范围因工作区配置而异所以每个技能都会写明 Fallback比如 DataForSEO 没暴露时改用 Ahrefs/Semrush再没有就明说缺哪个连接绝不编造数据。动手实践3 步写出你的第一个 SEO 技能掌握了上面两部分写新技能只需三步第 1 步建文件夹 复制结构在 skills/ 下新建文件夹比如skills/seasonal-traffic/SKILL.md按四个区块填充。最小骨架如下--- name: seasonal-traffic description: 找出季节性波动关键词……用户问哪些词有季节性时触发。 --- # Seasonal Traffic ## Requires 声明依赖 Ryze MCP ## Workflow 编号步骤每步写清调哪个 provider__tool ## Output 报告格式结论先行 表格 行动清单 ## Fallbacks 数据缺失时的降级方案第 2 步写清 description 触发词模仿 rank-tracking 的写法把 how are my rankings、what moved this week 这类真实口语写进 description。第 3 步声明工具与回退Workflow 里只用命名空间规范内的工具名拿不准参数就写先调native__get_provider_docs查官方文档最后补一段 Fallbacks。写好后用 install.sh 一行装进本地它会把所有技能复制到~/.claude/skills/或者直接克隆整个仓库仓库地址https://gitcode.com/gh_mirrors/op/open-seo-mcp-skills 后拷贝skills/目录。小结一个 SEO 技能 一个文件夹里的 SKILL.md四区块结构name/description → Requires → Workflow → Output Fallbacksdescription 里的触发词决定技能能否被唤起Workflow 里的工具名决定执行是否稳定MCP 工具遵循provider__tool命名参数拿不准就用native__get_provider_docs查官方文档技能是 MIT 开源的 Markdown改起来零门槛——你的第一个 SEO 技能今天就能写出来 ✍️【免费下载链接】open-seo-mcp-skillsFree SEO MCP server open-source SEO and GEO skills for Claude: keyword research, rank tracking, audits, backlinks, AI visibility on your real GSC/GA4/ads data. claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp项目地址: https://gitcode.com/gh_mirrors/op/open-seo-mcp-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考