mcpField
S
setup-openseo

setup-openseo

github.com/every-app营销与增长25.5k135 次安装2 天前更新
代码仓库

关于 setup-openseo

setup-openseo 是指导在 AI Agent 中安装 OpenSEO 的技能,涵盖连接和技能配置。它区分托管与自托管部署,并要求完成验证后才报告设置成功。

主要功能

  1. 01检查 Agent 身份及现有 OpenSEO 配置
  2. 02指导安装插件或 MCP 连接
  3. 03在支持时安装公开 SEO 技能
  4. 04区分托管与自托管认证步骤
  5. 05重新加载并验证工具和技能发现

适用场景

  1. 01在受支持的编码 Agent 中设置 OpenSEO
  2. 02配置托管或自托管的 OpenSEO 连接
  3. 03排查设置问题并验证可用项目

MCP 相关

该技能指导将 OpenSEO 的 MCP 端点添加到兼容 Agent,并验证工具访问。托管部署使用 https://app.openseo.so/mcp;自托管部署使用其自身端点。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/every-app/open-seo --skill setup-openseo

安装后在 Claude Code 中输入/setup-openseo确认已加载。

详细介绍

在此 Agent 中设置 OpenSEO。尽可能完成设置;需要我提供信息的部分,请引导我操作。

1. 检查此 Agent

  • 确认此 Agent 及其版本。只有无法确认时才询问。
  • 检查是否已连接 OpenSEO。保留其他集成并避免重复添加。
  • 单独检查是否已安装 OpenSEO 技能。只有连接而没有技能是不完整的。

2. 如果这是 ChatGPT

如果我是在普通的 ChatGPT 对话中(网页或桌面应用,不是 Codex)粘贴了这段内容,你无法从这里安装 OpenSEO。不要运行命令或编辑文件,而是提供以下步骤并停止:

  1. 打开 OpenSEO 的 ChatGPT 插件,然后选择 Install plugin。
  2. 登录 OpenSEO 并批准连接。
  3. 开始新的聊天,从 + 菜单中选择 OpenSEO,然后发送:“Use OpenSEO to check my connection and list my projects.”

此插件仅连接托管版 OpenSEO。如果 https://app.openseo.so/mcp 不在 openseo.so 上(即为自托管),或者我的账户无法使用此插件,请提供 ChatGPT 设置指南中的自定义连接步骤,并附上该服务 URL。ChatGPT 需要可公开访问的 HTTPS URL。如果我使用的是 Codex,请继续下面的步骤。

3. 先安装插件

官方插件集成了 MCP 和 SEO 技能,并采用 OpenSEO 命名空间,且会同步更新。

  • **Codex:**按照插件指南操作。
  • **Claude Code:**按照插件指南操作。
  • **Claude Cowork 或 Claude 桌面应用:**你无法在此聊天中安装插件,因此不要运行命令。请告诉我打开 Customize(在 Cowork 中,先打开 Cowork 标签页)→ Plugins → + 或 Add → Add marketplace → Add from a repository,输入 https://github.com/every-app/open-seo,然后安装 OpenSEO。接着我开始新任务并输入 /,检查是否显示 OpenSEO 技能。如果我已有自定义 OpenSEO 连接器,请在插件登录后让我移除它。插件需要付费方案。插件仅连接托管版 OpenSEO,因此如果 https://app.openseo.so/mcp 不在 openseo.so 上(即为自托管),或者我使用的是 Free 方案,请跳过插件。改为让我在 Customize → Connectors → Add custom connector 下添加该端点,并在 Customize → Skills 中上传公开技能。然后继续第 5 步。
  • **其他 Agent:**查阅其当前文档,确认插件兼容性。
  • 运行命令前,先查看已安装客户端的帮助信息。

4. 回退到 MCP + 技能

如果不支持插件:

  • 按照 MCP 指南添加 https://app.openseo.so/mcp。
  • 仅为此 Agent 安装公开 SEO 技能。
  • 不要复制内部仓库中的技能,也不要重复安装已集成的技能。
  • 如果不支持技能,则仅使用 MCP,并链接到工作流指南。

对于自托管的 OpenSEO,请直接使用其端点;官方插件面向托管服务。

5. 登录

  • **托管版 OpenSEO:**优先使用 OAuth,并让我在浏览器中批准登录。如果此客户端无法使用 OAuth,请引导我前往 https://app.openseo.so/settings → API keys。让我在客户端的密钥设置或环境变量中输入密钥,绝不要在聊天或仓库中输入。
  • **自托管 OpenSEO:**遵循部署的身份验证说明。配置为无身份验证的本地服务无需 OAuth 或 OpenSEO API 密钥。对于 Cloudflare Access 部署,请按照自托管指南为 MCP 客户端配置 Managed OAuth。
  • **需要手动设置?**使用此 Agent 的当前文档,并且只提供我需要自行完成的步骤。

6. 重新加载并验证

  • 使用当前 Agent 的原生重新加载流程,并查看其已安装版本、帮助信息或官方文档。优先使用自动发现或就地重新加载;仅在加载新工具和技能确有必要时才重启。
  • 工具在本会话中加载后,运行 whoami 和 list_projects(免费读取)。也检查技能发现情况。如果重新加载需要我操作,请提供操作说明,不要反复重试当前不可用的工具。
  • 分别跟踪安装、登录和验证情况。服务已连接并不代表本会话可以使用其工具。免费读取成功前,绝不要声称已完成验证。
  • 如果 list_projects 未返回任何项目,请询问我的网站,并使用 create_project 为其创建项目。创建项目不消耗额度。
  • 安装期间不要运行付费研究。

7. 以简短交接收尾

进度更新要简短。最终回复必须不超过 140 个词,并遵循此模板:

状态 [简要说明哪些步骤已成功,或是什么阻碍了设置。]

下一步

  1. [仅在需要时,提供此 Agent 的原生重新加载命令或界面操作。] 然后说“检查 OpenSEO 是否已连接。”如有提示,请批准登录。
  2. 试试以下其中一种:
    • [SEO Audit 调用方式] (推荐) — 找出网站最严重的 SEO 问题。
    • [SEO Project Setup 调用方式] — 了解你的网站并设置其项目上下文。
    • [Keyword Research 调用方式] — 找出值得重点布局的关键词。
    • [Local SEO 调用方式] — 检查你的 Google 商家资料和本地竞争对手。

想了解设置了什么?直接询问即可。

根据实际结果调整模板:

  • 如果我必须手动安装插件(例如 Claude Cowork),将第 1 步替换为相应的点击操作。
  • 如果安装失败,说明阻碍,并将重新加载步骤替换为修复方法。如果已完成全部验证,说明已准备就绪,并省略重新加载步骤。不要仅因工具需要重新加载就声称登录失败或需要登录。
  • 推荐使用此 Agent 调用各项已安装技能的惯用方式:其原生命令、提及方式、选择器或自然语言请求。使用发现的技能名称和插件命名空间;不要假设所有环境都支持 /skill-name,也不要创建别名强行实现。无法确定时,查看 Agent 的帮助信息或官方文档。如果不支持技能,请使用已连接的工具提供等效的自然语言请求。推荐工作流;安装期间不要运行。
  • 检查时保留工具名称,例如 whoami 和 list_projects,但不要在最终回复中提及。除非用于解释阻碍或我提出要求,否则省略版本、路径、连接详情、技能数量、其他集成和清理命令。不要添加其他章节或验证清单。

评论

支持 Markdown