关于 setup-openseo
setup-openseo 是指导在 AI Agent 中安装 OpenSEO 的技能,涵盖连接和技能配置。它区分托管与自托管部署,并要求完成验证后才报告设置成功。
主要功能
- 01检查 Agent 身份及现有 OpenSEO 配置
- 02指导安装插件或 MCP 连接
- 03在支持时安装公开 SEO 技能
- 04区分托管与自托管认证步骤
- 05重新加载并验证工具和技能发现
适用场景
- 01在受支持的编码 Agent 中设置 OpenSEO
- 02配置托管或自托管的 OpenSEO 连接
- 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。不要运行命令或编辑文件,而是提供以下步骤并停止:
- 打开 OpenSEO 的 ChatGPT 插件,然后选择 Install plugin。
- 登录 OpenSEO 并批准连接。
- 开始新的聊天,从 + 菜单中选择 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 个词,并遵循此模板:
状态 [简要说明哪些步骤已成功,或是什么阻碍了设置。]
下一步
[仅在需要时,提供此 Agent 的原生重新加载命令或界面操作。]然后说“检查 OpenSEO 是否已连接。”如有提示,请批准登录。- 试试以下其中一种:
[SEO Audit 调用方式](推荐) — 找出网站最严重的 SEO 问题。[SEO Project Setup 调用方式]— 了解你的网站并设置其项目上下文。[Keyword Research 调用方式]— 找出值得重点布局的关键词。[Local SEO 调用方式]— 检查你的 Google 商家资料和本地竞争对手。
想了解设置了什么?直接询问即可。
根据实际结果调整模板:
- 如果我必须手动安装插件(例如 Claude Cowork),将第 1 步替换为相应的点击操作。
- 如果安装失败,说明阻碍,并将重新加载步骤替换为修复方法。如果已完成全部验证,说明已准备就绪,并省略重新加载步骤。不要仅因工具需要重新加载就声称登录失败或需要登录。
- 推荐使用此 Agent 调用各项已安装技能的惯用方式:其原生命令、提及方式、选择器或自然语言请求。使用发现的技能名称和插件命名空间;不要假设所有环境都支持
/skill-name,也不要创建别名强行实现。无法确定时,查看 Agent 的帮助信息或官方文档。如果不支持技能,请使用已连接的工具提供等效的自然语言请求。推荐工作流;安装期间不要运行。 - 检查时保留工具名称,例如 whoami 和 list_projects,但不要在最终回复中提及。除非用于解释阻碍或我提出要求,否则省略版本、路径、连接详情、技能数量、其他集成和清理命令。不要添加其他章节或验证清单。
评论
支持 Markdown