OpenSEO Agent Skills 安装配置指南为 Claude Code、Codex 等 AI Agent 部署 9 个 SEO 工作流技能【免费下载链接】open-seoOpen source alternative to Semrush and Ahrefs项目地址: https://gitcode.com/GitHub_Trending/op/open-seoOpenSEO Agent Skills 是独立于 MCP 的一组SKILL.md技能文件它把「关键词研究、竞品分析、外链拓展、网站审计」等完整 SEO 工作流打包成斜杠命令交给 AI Agent 直接执行。本文以仓库中的 setup 文档 为骨架完整覆盖从 MCP 连接、五种安装方式到技能运行与内部原理的实战流程读完后你可以在 Claude Code、Codex CLI 或其他支持SKILL.md的 Agent 上用一行命令跑通 OpenSEO 的 9 个 SEO 工作流。Skills 与 MCP两份不同但必须搭配的组件OpenSEO 的 Agent 集成由两个独立部分组成容易混淆先厘清二者分工OpenSEO MCP一套 MCP 服务器暴露关键词研究、SERP 抓取、外链概览、域名分析、本地商户检索、Google Search Console 性能查询、项目共享上下文读写等工具。它解决的是「Agent 从哪里拿到实时 SEO 数据」。OpenSEO Agent Skills一组SKILL.md文件每个文件描述一个完整的 SEO 工作流步骤、工具调用顺序、输出格式、护栏。它解决的是「Agent 拿到数据后该按什么流程做事」。在仓库中两者是物理隔离的MCP 连接配置在 plugins/openseo/mcp.json其中定义了托管服务器地址https://app.openseo.so/mcp9 个技能则位于 plugins/openseo/skills/ 目录下每个技能一个子目录内含各自的SKILL.mdseo-audit还附带报告模板template.html。plugins/openseo/README.md 对两者的关系做了概括插件包含九个引导 Agent 完成完整 SEO 工作流的技能外加承载实时数据与项目管理的托管 OpenSEO MCP 服务器。因此官方 setup 文档的开篇结论是先连 MCP再加 Skills。MCP 给 Agent 访问 OpenSEO 数据的能力Skills 告诉 Agent 执行哪个 SEO 工作流。两者都就位后技能运行时会自动调用 MCP 工具取数。第一步先连接 OpenSEO MCPSkills 依赖 MCP 工具读写数据所以安装技能之前必须先把 MCP 接通。完整步骤见 Set up OpenSEO MCP这里只提炼与本主题相关的要点托管 MCP 服务器地址为https://app.openseo.so/mcp首次连接会跳转 OpenSEO 登录授权Claude Code 推荐用插件一键安装MCP 全部技能参见 Claude Code 插件Codex CLI 同理参见 Codex 插件无头环境或 CI 场景可用 API Key 连接客户端发送Authorization: Bearer oseo_YOUR_KEY或x-api-key请求头。以 Claude Code 手动添加 MCP 为例--scope user表示对用户所有项目生效--scope local仅当前仓库claude mcp add --transport http --scope user openseo https://app.openseo.so/mcp连接成功后Agent 即可调用 MCP 暴露的工具。值得注意的是项目上下文工具get_project_context/update_project_context是免费的不消耗任何额度官方文档明确标注 free, no credits这是后续所有技能共享项目记忆的基础。第二步选择安装方式setup 文档提供了五种安装方式按「是否想交互式选择」和「目标 Agent」两个维度划分任选其一即可。方式一交互式安装推荐用于挑选技能如果不确定要装哪些技能用这条命令安装器会展示可用的 skills 和 agents 供你勾选npx skills add every-app/open-seo方式二安装全部 OpenSEO 技能如果想一步到位拿到全部 9 个技能npx skills add every-app/open-seo --skill *方式三仅给 Claude Code 安装全部技能--agent claude-code将技能限定写入 Claude Code 的 skills 目录避免污染其他 Agentnpx skills add every-app/open-seo --skill * --agent claude-code方式四仅给 OpenAI Codex 安装全部技能对应 Codex 的--agent codex参数npx skills add every-app/open-seo --skill * --agent codex方式五手动复制技能文件如果 Agent 不被npx skills支持或想完全掌控文件落盘位置可以直接克隆仓库并把技能目录复制进 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/两个目标目录的含义~/.claude/skills/是 Claude Code 的全局技能目录~/.codex/skills/是 Codex CLI 的技能目录Agent 启动时会扫描这些目录加载SKILL.md。注意本仓库中技能源码的实际位置是plugins/openseo/skills/seo-audit技能目录下还包含报告渲染用的template.html而官方文档中引用的.agents/skills是上游仓库的路径布局复制前先确认你所克隆版本的目录结构。另外Claude Code 与 Codex CLI 都有更省事的官方插件方案/plugin marketplace add every-app/open-seo/plugin install openseoopenseo一步完成 MCP 与全部技能安装详见 Claude Code 插件。仓库中的 9 个技能清单安装后你将获得 9 个技能每个对应一条斜杠命令和一个独立SKILL.md。下表汇总自 plugins/openseo/README.md 与技能目录每个技能页也有对应的说明文档位于 web/content/docs/skills/斜杠命令技能说明源码位置文档页/seo-project-setup一次访谈把站点范围、目标、定位、竞品、关键页面写入项目共享上下文SKILL.mdseo-project-setup.mdx/seo-coach友好教练模式帮新手选择下一个工作流、解释工具用法SKILL.mdseo-coach.mdx/keyword-research从种子主题发现关键词机会评估量、难度、CPC、意图与 SERPSKILL.mdkeyword-research.mdx/keyword-clustering按意图聚合关键词映射到现有或规划页面检查关键词自相蚕食SKILL.mdkeyword-clustering.mdx/competitive-landscape描绘一个市场里谁在赢找出内容与外链模式上的机会缺口SKILL.mdcompetitive-landscape.mdx/competitor-analysis深挖单个竞品的关键词、内容主题、外链画像与差距SKILL.mdcompetitor-analysis.mdx/link-prospecting寻找高质量外链机会发现联系路径并起草 outreach 文案SKILL.mdlink-prospecting.mdx/local-seo审计 Google Business Profile对比本地竞品绘制周边 Maps 可见度SKILL.mdlocal-seo.mdx/seo-audit审计站点产出一页纸、非技术语言、围绕单一行动的 SEO 报告SKILL.mdseo-audit.mdx技能索引页 index.md 将上述工作流归为四类起步类Project Setup、Coach、审计类SEO Audit、研究类Keyword Research、Keyword Clustering、Competitive Landscape、Competitor Analysis、Local SEO、推广类Link Prospecting。当你不确定先跑哪个时官方建议从/seo-project-setup或/seo-coach开始。第三步运行一个技能技能文件就位后直接输入对应的斜杠命令即可触发。以 Claude Code 插件方式安装时命令会带插件命名空间/openseo:seo-project-setup形式见 claude-code-plugin.md以手动复制方式安装时直接使用不带前缀的命令。手动安装场景下的命令全集即上表第一列。触发后 Agent 会读取对应SKILL.md中的工作流指令并按序执行。以/seo-project-setup为例其 SKILL.md 定义的流程是调用whoami、list_projects验证 MCP 连接并解析出projectId调用get_project_context读取项目已知信息与missingSections缺口清单分批访谈用户收集站点范围、SEO 目标、定位与写作偏好通过update_project_context写入business_overview、current_goal、positioning、writing_preferences、addCompetitors、addKeyPages等补丁操作引导连接 Google Search Console 或导入 GSC CSV 导出输出带状态标记的清单并推荐下一个工作流。从中可以提炼出所有 OpenSEO 技能的通用运行模式解析projectId→ 读取项目上下文 → 调用 MCP 工具取数 → 按护栏产出 → 把可持久化的结论写回项目上下文。技能之间通过项目共享上下文接力上下文存于 OpenSEO 而非本地文件因此能跨会话、跨机器、跨 Agent 复用。技能内部机制项目上下文与额度护栏理解技能如何工作对用好它们至关重要。从各技能SKILL.md的「Project context」与「Guardrails」小节可以看到三个贯穿始终的机制1. 免费的项目上下文是技能的共享记忆。get_project_context/update_project_context免费且与 App 内的 SAM、其他 Agent 共享。update_project_context支持的补丁操作包括写入五大 prose 章节business_overview、current_goal、positioning、writing_preferences、addCompetitors按域名添加竞品、addKeyPages按hub/spoke/money/other角色标记关键页面、customSection自定义章节、appendResearchLog追加研究日志。用户可以在项目 Context 设置页直接查看和编辑这些内容。2. 研究日志避免重复购买数据。多个技能seo-coach、seo-audit、keyword-research、seo-project-setup都要求消费额度前先查研究日志若同一研究在最近 30 天内执行过直接复用结果并明说而不是重新付费。技能结束时若本次会话花费了额度须追加一条{ appendResearchLog: { summary: 做了什么: 输入. Verdict: 结论 } }格式的日志条目。3. 明确的额度纪律。以seo-audit为例其 SKILL.md 明确限制总花费为「一次站点审计、一次外链概览、至多一次域名概览、至多一次关键词研究调用」只有概览与关键词查询消耗额度whoami、list_projects、审计爬取状态查询等不产生费用。技能运行前先whoami确认剩余额度是每个技能的第一道护栏。技能与数据源的分工什么数据从哪里来seo-coach的 SKILL.md 提供了一张数据源分工表是理解 Agent 能力边界的最佳参考OpenSEO MCP 工具关键词研究、精确排名关键词、搜索量、SERP、SERP 竞品、本地商户与 Maps 数据、域名概览、外链、已保存关键词、项目与排名追踪器Google Search Console项目 Integrations 页连接后第一方数据真实的点击、曝光、CTR、位置用get_search_console_performance实时读取免费不耗额度是「已经排到哪、差一点排上去」的最佳起点Web 搜索OpenSEO 之外的当下市场背景、新页面、评论、文档、社媒主页、联系路径页面抓取抽取页面正文、标题、作者、联系方式、schema 与内容结构项目上下文项目共享记忆免费所有技能都会读本地文件只承担文件类工作GSC CSV、爬取结果、草稿、简报、报告。keyword-research的 SKILL.md 展示了这套分工的典型用法先拉get_search_console_performance高rowLimit客户端侧过滤平均位置 5–20 的 striking distance 查询因为 API 按点击排序且无法按位置过滤再用get_keyword_metrics批量水合这些查询的量、难度与意图——把第一方数据变成最快的机会清单之后才做宽泛的research_keywords探索。下一步从哪个技能开始安装完成后官方给出的起点建议是全新 SEO 项目先跑/seo-project-setup把目标、定位、竞品、关键页面写进项目上下文后续所有技能都会复用不确定先跑哪个工作流先跑/seo-coach让 Agent 基于项目上下文推荐下一个动作。也可以按目标直接对号入座已有站点想知道先修什么用/seo-audit需要从种子主题找机会用/keyword-research有现成关键词或 GSC 数据要映射到页面用/keyword-clustering市场格局不清用/competitive-landscape已知竞品要深挖用/competitor-analysis有可链接资产或目标页面用/link-prospecting。每个技能的完整说明与触发命令可在 skills 文档目录 的对应页面查阅源码指令则以 plugins/openseo/skills/ 下的SKILL.md为准——它们是 Agent 实际执行的行为规范也是深入理解 OpenSEO 工作流设计的最佳阅读材料。【免费下载链接】open-seoOpen source alternative to Semrush and Ahrefs项目地址: https://gitcode.com/GitHub_Trending/op/open-seo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考