OpenSEO Agent Skills 完全指南把可复用的 SEO 工作流交给 Claude Code、Codex 等 AI Agent【免费下载链接】open-seoOpen source alternative to Semrush and Ahrefs项目地址: https://gitcode.com/GitHub_Trending/op/open-seoOpenSEO Agent Skills 是一组独立的SKILL.md指令文件让 AI Agent 直接执行关键词研究、关键词聚类、竞争对手分析、外链挖掘、站点审计、本地 SEO 等项目级工作流。本指南完整覆盖技能与 MCP 的分工、五种安装方式、九个技能的斜杠命令与适用场景并结合仓库内 plugins/openseo/skills 下的真实SKILL.md源码深入剖析项目上下文Project Context写入机制与 SEO 审计工作流的核心实现。读完你可以为 Claude Code、Codex 或任何支持 Skills 格式的 Agent 一键装配 OpenSEO 技能并知道每个技能背后到底调用了哪些数据工具。什么是 OpenSEO Agent Skills根据 web/content/docs/skills/index.md 的定义OpenSEO Agent Skills 的核心理念是把可重复执行的 SEO 工作流交给 AI Agent。当你需要关键词研究、聚类、竞品分析、外链挖掘或项目初始化时直接运行一个斜杠命令技能文件就会把对应的工作流指令交给 Agent。你仍然掌握策略主动权——Agent 使用 OpenSEO 实时数据配合技能指令最终返回的是推荐、计划或候选清单而不是替你拍板。这一设计把研究-执行-决策链条拆成了两部分OpenSEO MCP负责连接数据层。配置声明见 plugins/openseo/mcp.json其中注册了托管 MCP 端点让 Agent 能读取关键词指标、SERP、域名概览、外链、已保存关键词等实时 SEO 数据Agent Skills负责流程层。每个技能是一个独立的SKILL.md指令文件位于 plugins/openseo/skills告诉 Agent这个工作流该按什么步骤跑、调哪些工具、产出什么格式的结果。用官方文档的一句话概括MCP connects your agent to OpenSEO data. Skills tell your agent which SEO workflow to run.值得强调的是OpenSEO 采用的是现代 AI Agent 普遍支持的SKILL.md模式而不是私有协议。因此同一套技能文件可以在 Claude Code、OpenAI Codex、Cursor 以及任何实现了该格式的 Agent 中运行不存在锁定问题。开始之前先建立 OpenSEO MCP 连接绝大多数技能都依赖实时数据所以在安装技能之前第一步永远是 搭建 OpenSEO MCP。MCP 建立后Agent 才能执行whoami、list_projects、run_site_audit、research_keywords、get_backlinks_overview这类数据工具。以 plugins/openseo/skills/seo-audit/SKILL.md 为例它的Required inputs环节明确要求先用list_projects解析projectId若没有匹配的项目则用create_project创建whoami用于在产生任何花费前确认连接与剩余额度——如果 OpenSEO 未连接技能会停下来请求用户先连接。这说明 MCP 连接是技能运行的前置硬约束。五种安装方式从一行命令到手动复制安装说明见 web/content/docs/skills/setup.md。如果你用的是 Claude Code 或 Codex CLI官方推荐直接走插件方式下文通过插件一键安装一节本节的手动步骤面向其他 Agent或只想挑选部分技能的场景。方式一交互式安装推荐可挑选技能让安装器展示可用的技能和 Agent由你交互式选择npx skills add every-app/open-seo方式二安装全部 OpenSEO 技能npx skills add every-app/open-seo --skill *方式三仅安装全部技能到 Claude Codenpx skills add every-app/open-seo --skill * --agent claude-code方式四仅安装全部技能到 OpenAI Codexnpx skills add every-app/open-seo --skill * --agent codex方式五手动复制技能文件如果你偏好直接管理文件先克隆仓库再把技能目录复制到对应 Agent 的 skills 文件夹git clone https://gitcode.com/GitHub_Trending/op/open-seo.git # Codex mkdir -p ~/.codex/skills cp -R open-seo/plugins/openseo/skills/* ~/.codex/skills/ # Claude Code mkdir -p ~/.claude/skills cp -R open-seo/plugins/openseo/skills/* ~/.claude/skills/注意本仓库中技能源码的实际位置是 plugins/openseo/skills共 9 个技能目录每个目录下是一个SKILL.mdseo-audit还附带 template.html 报告模板。复制时以该目录为准。安装完成后在 Agent 中输入/mcp检查 OpenSEO 连接首次使用任一技能工具时按 OAuth 提示登录并授权。运行技能斜杠命令速查表技能文件就位后运行对应的斜杠命令即可。完整命令清单如下技能斜杠命令工作流类型SEO Project Setup/seo-project-setup起步SEO Coach/seo-coach起步SEO Audit/seo-audit审计Keyword Research/keyword-research研究Keyword Clustering/keyword-clustering研究Competitive Landscape/competitive-landscape研究Competitor Analysis/competitor-analysis研究Local SEO/local-seo研究Link Prospecting/link-prospecting推广如果通过 Claude Code 插件安装技能会以插件名为命名空间调用形式变为/openseo:seo-project-setup、/openseo:seo-audit等见 web/content/docs/claude-code-plugin.md。技能全景四大类九个技能官方文档按工作流性质把九个技能分为四组见 web/content/docs/skills/index.md。下面逐一说明每个技能做什么、何时用、能得到什么。起步组先建立上下文再决定方向SEO Project Setup/seo-project-setup——文档明确指出每个技能之前都应先跑它。Agent 会一次性访谈网站目标、定位、竞品与关键页面并把答案写入 OpenSEO 项目的共享上下文。这些上下文被所有其他技能、App 内的 SAM 复用也会持久保存在项目 Context 设置页跨会话、跨机器、跨 Agent 生效。它不是一个完整审计而是一个上下文建立工作流。重跑时机目标发生变化或发现其他技能留下的上下文空缺需要补齐。产出是一份简短项目摘要范围站点、目标、定位、已保存的竞品与关键页面、Search Console 状态、缺失项、以及下一步建议运行的工作流。SEO Coach/seo-coach——适合刚接触 SEO 或不确定该先跑哪个工作流的场景。Agent 会结合你的目标、经验水平、可用数据和项目上下文用通俗语言解释选项并推荐下一步。它会区分策略问题与执行工作解释何时该用 OpenSEO MCP、已保存的项目上下文、网络搜索、浏览器审查或本地文件。官方给出一组典型提问示例我该从哪里开始做 SEO应该先做关键词研究还是先研究竞品怎么用 AI 做 SEO 又不产出千篇一律的内容。产出是一个简短计划现在该跑哪个工作流、Agent 还需要什么信息、为什么这个步骤合理。注意Coach 在 MCP 连接前也能帮忙但实时的关键词、SERP、域名、外链与已保存关键词数据需要 MCP 就绪。审计组面向非专家的一页纸报告SEO Audit/seo-audit——对站点执行审计输出一页可行动的通俗 HTML 报告让完全没做过 SEO 的人也能看懂并执行。Agent 会运行 OpenSEO 站点审计、拉取外链与流量估算数据并在报告每条结论前逐条对照线上页面核实。报告围绕本周唯一一件事展开给出可直接复制粘贴的具体步骤后面附带 5~10 个小修项和哪些已经做对了的部分。文档特别强调它会诚实地处理坏站点如果域名挂了或只爬取了一半Agent 会先调查原因证书过期、死域名有存活的继承站点、页面级屏蔽等再据此调整那一件事的建议。详细工作流见下文源码级剖析。研究组关键词、聚类与竞争情报Keyword Research/keyword-research——从种子主题、产品、页面、竞品或受众问题出发拉取关键词想法、评估难度、检查 SERP并按公司/网站/目标过滤。产出是带优先级的机会清单每条附为什么适合你、排名难度如何、下一步做什么。好的结果会解释关键词为什么有用而不只是有没有搜索量。使用时建议给 1~5 个聚焦的种子主题明确产品/受众/页面类型必要时指定目标国家或语言保存关键词前务必经你确认。Keyword Clustering/keyword-clustering——把杂乱的关键词列表变成页面规划。Agent 按搜索意图、SERP 相似度与页面类型分组区分看着像但需要不同页面的词把簇映射到现有 URL没有匹配页面时推荐新建页面并标记薄弱、偏离策略或不应 targeting 的词。输入可以是关键词列表、已保存的关键词标签、Search Console 导出、种子主题或目标域名。产出包含簇、主关键词、次关键词、搜索意图、页面目标、优先级以及关于关键词蚕食cannibalization或合并的提示。Competitive Landscape/competitive-landscape——在市场还不明朗、进入新品类、或不知道哪些 SEO 竞品真正重要时使用。Agent 会构建代表性查询集、检查 SERP 找出反复出现的域名并区分直接产品竞品与出版商、目录、社区、市场、资源站——这是文档特别强调的一点在许多市场拿到搜索流量的往往是后者而非直接竞品。产出包括市场领导者、最值得争取的机会区、最大的排名障碍、所用查询集、域名类型、制胜主题与推荐的下一步工作流。Competitor Analysis/competitor-analysis——与 Landscape 的面不同这是针对单一竞品域名的点级深挖。Agent 审查竞品的关键词、页面、外链与内容主题找出其自然可见度来源的模式并区分证据与推断推荐比复制竞品页面更强的切入角度。适用场景某个竞品反复出现在搜索结果、销售对话或客户对比中制作对比页之前刷新定位之前判断竞品优势到底来自内容、外链、品牌还是少数强页面。Local SEO/local-seo——针对依赖实体位置或服务区域的业务门店、餐厅、诊所、服务商等。Agent 审计 Google Business Profile类目、评分、营业时间、照片、认领状态对比本地实际排在你前面的竞品分析评论差距数量、新鲜度、评分、商家回复并运行**排位网格rank grid**展示地图可见性在位置周边的衰减。产出是档案快照、可见性地图、与最强竞品的逐信号对比以及从本周一件修复开始的优先级行动清单。使用技巧最好提供cid或placeId店面坐标务必准确网格中心放错地方比没有网格更糟超过 3×3 的网格前先问成本——每个网格点都是一次付费搜索。推广组外链机会挖掘Link Prospecting/link-prospecting——为某个页面或资产寻找有真实理由提到它的外链候选。Agent 会搜索资源页、列表文、对比页、目录、出版商与主题文章并利用竞品外链模式理解注意力来源。产出是小而精的合格候选清单每条附适配理由与可行的外链角度外加几条可复用的 outreach 草稿。技能明确要求不得编造联系人不得把垃圾外链候选当作有用资源。最适合的场景是你已经拥有值得被链接的东西指南、产品页、原创研究、工具、模板、数据集或强观点。源码级剖析一Project Context 的写入机制为什么项目设置只做一次、却能惠及所有技能答案在 plugins/openseo/skills/seo-project-setup/SKILL.md 的源码里。整个上下文写入只依赖两个 MCP 工具且文档注明两者免费、不消耗额度get_project_context(projectId)返回该项目已知的全部信息外加missingSections缺失清单update_project_context(projectId, updates)接收一组 patch 操作。技能使用的写入操作patch ops完整列举如下操作说明{ section: business_overview \| current_goal \| positioning \| writing_preferences, content }写入四个类型化小节之一每节约 4000 字符的散文写紧凑段落而非访谈转录{ addCompetitors: [{ domain, name?, notes? }] }追加竞品每个域名一行附简短备注如直接竞品占据对比页{ addKeyPages: [{ url, role: hub \| spoke \| money \| other, topic?, notes? }] }保存关键页面标注枢纽页/辐射页/盈利页角色这是精选清单而非站点清单10~30 个 URL 为常态{ customSection: slug, title?, content }写入类型化小节之外的自定义小节{ appendResearchLog: { summary } }本会话产生额度消耗时追加研究日志让其他技能避免重复购买从源码的 Checklist 可以看出几个关键设计先读再写第 2 步先调get_project_context向用户展示已知信息与缺失项确认或纠正已有条目而不是重复提问——因为该技能经常在其他技能补全部分上下文后被重跑分批写入访谈过程中就分批update_project_context不攒到最后覆盖即替换源码 Guardrails 特别警告覆盖一个小节会替换它因此当上下文已存在时要把新答案合并进现有散文而不是丢弃证据边界写入库的必须是经用户确认的事实从站点推断的内容只能作为提案保存的是达成一致的答案而非猜测不得虚构 GSC CSV 已上传、不得谎称 Search Console 已连接除非get_search_console_performance确认返回。此外竞品条目会被competitive-landscape、competitor-analysis、link-prospecting三个技能复用Search Console 数据则在keyword-research、keyword-clustering中直接读取托管版原生连接或以 CSV 文件形式放入本地gsc/目录自托管回退方案推荐文件名如gsc/queries-last-3-months.csv。源码级剖析二SEO Audit 的完整执行链plugins/openseo/skills/seo-audit/SKILL.md 是仓库中指令最完整的一个技能足以代表 OpenSEO 工作流的工程化水准。它的执行链如下whoami确认连接与剩余额度再用list_projects/create_project解析projectId先调get_project_context以business_overview作为报告基调业务是什么决定了哪些发现重要若为空先做最小化内联设置——从站点推断业务并用一个问题与用户确认写入上下文后再继续审计而不是把完整访谈前置花费额度前检查研究日志同一研究 30 天内跑过就直接复用并说明避免重复购买run_site_audit启动爬取默认页面预算默认关闭 Lighthouse会增加几分钟且本报告不需要仅当用户要求性能/Core Web Vitals 深度时才传runLighthouse: true爬取期间并行拉get_backlinks_overview——外链与引荐域名图景通常是那一件事的决定性数据爬取完成后读get_audit_issues站点存活时再取get_domain_overview估算自然流量与关键词数站点明显死亡时跳过审计结果异常证书错误、5xx、只爬了一页时先调查再动笔自行检查证书与重定向变体、搜索该业务——死域名常有存活的继承站点这会整个翻转建议为把旧域名重定向报告任何结论前先抓取线上页面逐条核实——只报告你亲眼见过证据的东西决定本周那一件事且必须从数据推导而非泛泛建议常见模式包括干净站点无外链→给嘉宾/合作伙伴/目录发可复制的邀约死域名存活继承站→通过主机商做永久重定向并附上发给他们的原句页面被屏蔽或 noindex→解除屏蔽站点健康时给出起步聚焦区一次research_keywords调用种子词取自已爬取的站点主题挑选一个主题下的 3~5 个低难度、可现实排上名的关键词每个配要做的页面/文章站点下线时完全跳过此步用技能目录内的 template.html 生成报告保持其 CSS 与结构仅浅色系、无暗色模式交付前做对抗式复核让第二个 Agent/模型攻击四件事——超出事实的论断、未解释的术语、对新手过载的内容、夸张措辞交付方式环境支持发布/预览 HTML 就用否则保存文件让用户用浏览器打开。额度纪律是贯穿始终的设计一次审计、一次外链概览、至多一次域名概览、至多一次关键词研究调用——只有概览与关键词查询消耗额度技能把花费保持在克制水平。报告标题为域名日期独立一行其后是 2~3 句全文摘要整体状态、主要差距与那一件事、报告覆盖范围。通过插件一键安装Claude Code / Codex / Cursor不想手动挑选技能的用户可以走插件路径。在 Claude Code 中web/content/docs/claude-code-plugin.md/plugin marketplace add every-app/open-seo /plugin install openseoopenseo若安装摘要提示Run /reload-plugins to activate.执行该命令。插件会一次性连接 MCP端点与 plugins/openseo/mcp.json 中声明的一致并启用全部九个技能安装后 Claude Code 通常立即弹出登录提示若没有运行/mcp并在其中批准 OpenSEO 连接。Codex CLI 通过 web/content/docs/codex-plugin.md 实现同样的效果。另外plugins/openseo/README.md 展示了同一套技能在 Cursor 中的形态从 Cursor Marketplace 安装插件后首次使用 OpenSEO 工具时跟随 OAuth 提示登录即可。该 README 提供了一组可直接试用的提问示例Research keywords for my website and shortlist the best opportunities.研究我的网站关键词并列出最佳机会、Audit my website and tell me what to fix first.审计我的网站并告诉我先修什么、What does competitor.com rank for that I dont?竞品有哪些排名词是我没有的、Track my rankings for these keywords and summarize what changed.追踪这些关键词排名并总结变化等。插件包本身免费且开源托管版套餐与额度消耗见 openseo.so/pricingOpenSEO 也支持自托管。技能目录速览与下一步仓库中所有技能源码集中在 plugins/openseo/skills每个技能一份SKILL.mdseo-project-setup/SKILL.md访谈一次写入共享项目上下文seo-coach/SKILL.md选择下一步工作流seo-audit/SKILL.md含 template.html一页纸通俗审计报告keyword-research/SKILL.md关键词机会与适配理由keyword-clustering/SKILL.md关键词到页面的内容地图competitive-landscape/SKILL.md市场胜者与机会区competitor-analysis/SKILL.md单竞品深挖local-seo/SKILL.mdGoogle Business Profile 审计与 Maps 可见性网格link-prospecting/SKILL.md合格外链候选与 outreach 角度。每个技能页还提供了独立的文档说明见 web/content/docs/skills 目录下的对应.mdx文件seo-project-setup.mdx、seo-coach.mdx、seo-audit.mdx、keyword-research.mdx、keyword-clustering.mdx、competitive-landscape.mdx、competitor-analysis.mdx、local-seo.mdx、link-prospecting.mdx安装步骤见 setup.md。推荐的启动顺序如果是全新 SEO 项目先跑/seo-project-setup建立项目上下文如果不确定先跑哪个先跑/seo-coach让 Agent 帮你选其余技能按研究 → 审计 → 聚类 → 推广的节奏推进即可。【免费下载链接】open-seoOpen source alternative to Semrush and Ahrefs项目地址: https://gitcode.com/GitHub_Trending/op/open-seo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考