Skip to content

Open source alternative to Semrush and Ahrefs

Guide Claude Cowork users to install the OpenSEO plugin (EVE-266) (#909)

Carter Smithbd59c282e5f5
diff --git a/.agents/skills/setup-openseo/SKILL.md b/.agents/skills/setup-openseo/SKILL.md
index 18c4c0dc..6af3d4b7 100644
--- a/.agents/skills/setup-openseo/SKILL.md
+++ b/.agents/skills/setup-openseo/SKILL.md
@@ -11,6 +11,7 @@ Set up OpenSEO in this agent. Do what you can; guide me through anything that ne
- Identify this agent and its version. Ask only if you cannot tell.
- Check for an existing OpenSEO connection. Preserve other integrations and avoid duplicates.
+- Check for OpenSEO skills separately. A connection without skills is incomplete.
## 2. If this is ChatGPT
@@ -29,6 +30,7 @@ The official plugin bundles MCP + SEO skills, with OpenSEO namespacing and share
- **Codex:** follow the [plugin guide](https://openseo.so/docs/codex-plugin).
- **Claude Code:** follow the [plugin guide](https://openseo.so/docs/claude-code-plugin).
+- **Claude Cowork or the Claude desktop app:** you cannot install plugins from this chat, so don't run commands. Tell me to open **Customize** (in Cowork, the **Cowork** tab first) → **Plugins** → **+** or **Add** → **Add marketplace** → **Add from a repository**, enter `https://github.com/every-app/open-seo`, and install **OpenSEO**. Then I start a new task and type `/` to check that OpenSEO skills appear. If I already have a custom OpenSEO connector, have me remove it once the plugin signs in. Plugins need a paid plan. The plugin connects only to hosted OpenSEO, so skip it if `https://app.openseo.so/mcp` is not on openseo.so (self-hosted) or I'm on Free. Instead, have me add that endpoint under **Customize → Connectors** → **Add custom connector** and upload the [public skills](https://openseo.so/docs/skills/setup) in **Customize → Skills**. Then continue at step 5.
- **Other agents:** verify plugin compatibility in their current documentation.
- Check the installed client's help before running commands.
@@ -76,6 +78,7 @@ Want to know what was set up? Just ask.
Adapt the template to the actual result:
+- If I must install the plugin by hand, as in Claude Cowork, replace step 1 with those clicks.
- If installation failed, name the blocker and replace reload with the fix. If fully verified, say it is ready and omit reload. Do not claim sign-in failed or is required merely because tools need reloading.
- Recommend this agent’s idiomatic way to invoke each installed skill: its native command, mention, picker, or natural-language request. Use the discovered skill name and plugin namespace; do not assume `/skill-name` works everywhere or create aliases to force it. Check the agent’s help or official documentation when unsure. If skills are unsupported, give equivalent plain-language requests using the connected tools. Recommend workflows; do not run them during installation.
- Keep tool names such as whoami and list_projects in your checks, not the final reply. Omit versions, paths, connection details, skill counts, other integrations, and cleanup commands unless they explain the blocker or I ask. Do not add more sections or a verification checklist.
diff --git a/web/content/docs/agent-setup.mdx b/web/content/docs/agent-setup.mdx
index 73178ca0..f98edc95 100644
--- a/web/content/docs/agent-setup.mdx
+++ b/web/content/docs/agent-setup.mdx
@@ -9,7 +9,7 @@ OpenSEO connects your agent to live SEO data through MCP. Skills give it reusabl
**Using ChatGPT?** Follow the [ChatGPT setup guide](/docs/chatgpt) for chatgpt.com and the desktop app. The custom ChatGPT connection works on Free and paid plans. If you paste this prompt into a regular ChatGPT chat, it gives you the manual connection steps.
-Copy this prompt into Claude Code, Codex, Grok Bot, Hermes, or another agent. It asks your agent to use its supported installation method and guide you through any steps you need to do yourself.
+Copy this prompt into Claude Code, Claude Cowork, Codex, Grok Bot, Hermes, or another agent. It asks your agent to use its supported installation method and guide you through any steps you need to do yourself.
<AgentPrompt kind="setup" />
@@ -30,6 +30,10 @@ Run inside Claude Code to install MCP and the public SEO skills:
If Claude asks you to activate the plugin, run `/reload-plugins`. Follow the sign-in prompt, then try `/openseo:seo-coach`. See the [Claude Code plugin guide](/docs/claude-code-plugin) for troubleshooting.
+### Claude Cowork
+
+Install the OpenSEO plugin from **Customize → Plugins → Add marketplace → Add from a repository** with `https://github.com/every-app/open-seo`. It adds MCP and the public SEO skills. See the [Claude Cowork steps](/docs/claude-code-plugin#install-in-claude-cowork) for details and the Free plan option.
+
### Codex in the ChatGPT desktop app
Open **Codex**, start a new chat, and paste the setup prompt above. Approve the OpenSEO sign-in when prompted, then start a new chat if Codex needs to load the tools. Ask: “Use OpenSEO to check my connection and list my projects.” This check uses no OpenSEO credits.
@@ -69,9 +73,9 @@ Paste the setup prompt into your Bot. Open **Marketplace** in the sidebar to man
Follow the Bot's instructions for any steps you need to complete yourself. See [Grok Bot skills](https://docs.x.ai/grok-bot/skills-routines-and-automations).
-### Claude web/Desktop and other agents
+### Claude web and other agents
-Follow the [MCP connection guide](/docs/mcp), then install skills through your agent's supported skill manager. Claude web/Desktop manages custom skills under **Customize → Skills**; its flow differs from the Claude Code plugin.
+Follow the [MCP connection guide](/docs/mcp), then install skills through your agent's supported skill manager. Claude manages custom skills under **Customize → Skills**. On a paid Claude plan, the [OpenSEO plugin](/docs/claude-code-plugin#install-in-claude-cowork) installs both in one step.
For agents using the skills CLI, choose public OpenSEO skills interactively:
diff --git a/web/content/docs/claude-code-plugin.md b/web/content/docs/claude-code-plugin.md
index 80f6d97b..2c81a625 100644
--- a/web/content/docs/claude-code-plugin.md
+++ b/web/content/docs/claude-code-plugin.md
@@ -1,11 +1,11 @@
---
-title: "Install the OpenSEO plugin for Claude Code"
-description: "Add OpenSEO MCP and Agent Skills to Claude Code with one marketplace and one install command."
+title: "Install the OpenSEO plugin for Claude Code and Claude Cowork"
+description: "Add OpenSEO MCP and Agent Skills to Claude Code or Claude Cowork with one plugin install."
---
-The OpenSEO plugin bundles OpenSEO MCP and all twelve SEO Agent Skills into one install. This is the preferred way to set up OpenSEO in Claude Code.
+The OpenSEO plugin bundles OpenSEO MCP and all twelve SEO Agent Skills into one install. This is the preferred way to set up OpenSEO in Claude Code and in Claude Cowork.
-## Install
+## Install in Claude Code
Run these two commands in Claude Code:
@@ -37,7 +37,7 @@ Claude Code should prompt you to log in to OpenSEO right after install. If it do
## Run a skill
-Plugin skills are namespaced by the plugin name:
+In Claude Code, plugin skills are namespaced by the plugin name:
```
/openseo:seo-project-setup
@@ -51,11 +51,23 @@ Plugin skills are namespaced by the plugin name:
/openseo:competitor-analysis
/openseo:local-seo
/openseo:link-prospecting
+/openseo:seo-report
```
-## Claude Desktop
+## Install in Claude Cowork
-Claude Desktop doesn't support this plugin format — plugins are a Claude Code feature. For Claude Desktop, [add OpenSEO as an MCP connector](/docs/mcp#claude-desktop) instead.
+Claude Cowork and the Claude desktop app install plugins through the Customize menu, not slash commands. An agent can't click these steps for you.
+
+1. Open **Customize** in the left sidebar. In Cowork, open the **Cowork** tab first.
+2. Open **Plugins**, click **+** or **Add**, and choose **Add marketplace**.
+3. Choose **Add from a repository** and enter `https://github.com/every-app/open-seo`.
+4. Find **OpenSEO** in the new marketplace and click **Install** or **Add**.
+5. Sign in to OpenSEO and approve the connection when Claude asks.
+6. Start a new task, type `/`, and check that the OpenSEO skills appear. Then try "Use OpenSEO to check my connection and list my projects." This check uses no OpenSEO credits.
+
+If Claude can list your projects but no OpenSEO skills appear under `/`, you have a connector, not the plugin. Install the plugin, then remove the old custom OpenSEO connector under **Customize → Connectors** so you keep one connection.
+
+Plugins need a paid Claude plan (Pro, Max, Team, or Enterprise). Your organization can limit which marketplaces you can add. On the Free plan or with a self-hosted instance, [add OpenSEO as a custom connector](/docs/mcp#claude-desktop) and upload skills under **Customize → Skills**. The plugin connects only to hosted OpenSEO. See [Anthropic's plugin guide](https://support.claude.com/en/articles/13837440-use-plugins-in-claude).
## Update
@@ -91,4 +103,4 @@ If the OpenSEO connection doesn't show as authenticated, run `/mcp`, select Open
## Other clients
-This plugin is for Claude Code. For Codex CLI, use the [OpenSEO plugin for Codex](/docs/codex-plugin) instead. For Cursor, Codex Desktop, Claude Desktop, or an API key setup, see [Set up OpenSEO MCP](/docs/mcp) and [Set up OpenSEO Agent Skills](/docs/skills/setup).
+This plugin is for Claude Code and Claude Cowork. For Codex CLI, use the [OpenSEO plugin for Codex](/docs/codex-plugin) instead. For Cursor, Codex Desktop, or an API key setup, see [Set up OpenSEO MCP](/docs/mcp) and [Set up OpenSEO Agent Skills](/docs/skills/setup).
diff --git a/web/content/docs/codex-plugin.md b/web/content/docs/codex-plugin.md
index 47d5c87e..617b49ef 100644
--- a/web/content/docs/codex-plugin.md
+++ b/web/content/docs/codex-plugin.md
@@ -75,4 +75,4 @@ If a `codex plugin` command reports "unrecognized subcommand," run `codex plugin
## Other clients
-For ChatGPT web, use the [ChatGPT setup guide](/docs/chatgpt). For Claude Code, use the [OpenSEO plugin for Claude Code](/docs/claude-code-plugin) instead. For Claude Desktop, Cursor, or an API key setup, see [Set up OpenSEO MCP](/docs/mcp) and [Set up OpenSEO Agent Skills](/docs/skills/setup).
+For ChatGPT web, use the [ChatGPT setup guide](/docs/chatgpt). For Claude Code or Claude Cowork, use the [OpenSEO plugin for Claude](/docs/claude-code-plugin) instead. For Cursor or an API key setup, see [Set up OpenSEO MCP](/docs/mcp) and [Set up OpenSEO Agent Skills](/docs/skills/setup).
diff --git a/web/content/docs/mcp.md b/web/content/docs/mcp.md
index 25feffe7..f90ca6b2 100644
--- a/web/content/docs/mcp.md
+++ b/web/content/docs/mcp.md
@@ -37,6 +37,8 @@ After adding the server, approve the OpenSEO login when prompted.
## Claude Desktop
+On a paid Claude plan, prefer the [OpenSEO plugin](/docs/claude-code-plugin#install-in-claude-cowork), which adds MCP and the SEO skills in one install. Use the custom connector below for MCP only or on the Free plan.
+
1. Open Customize -> Connectors.
2. Click Add (or +), then choose Add custom connector.
3. Paste `https://app.openseo.so/mcp`.
diff --git a/web/content/docs/skills/index.md b/web/content/docs/skills/index.md
index 5cea02ab..1fdd4b2d 100644
--- a/web/content/docs/skills/index.md
+++ b/web/content/docs/skills/index.md
@@ -13,7 +13,7 @@ No account yet? Try the [free SEO tools](/tools).
## Set up OpenSEO Agent Skills
-On Claude Code, the [OpenSEO plugin](/docs/claude-code-plugin) installs MCP and every skill below in one step. On Codex CLI, the [OpenSEO plugin](/docs/codex-plugin) does the same. Use the manual steps here for other agents, or if you want to pick individual skills.
+On Claude Code and Claude Cowork, the [OpenSEO plugin](/docs/claude-code-plugin) installs MCP and every skill below in one step. On Codex CLI, the [OpenSEO plugin](/docs/codex-plugin) does the same. Use the manual steps here for other agents, or if you want to pick individual skills.
1. [Set up OpenSEO MCP](/docs/mcp).
2. [Set up OpenSEO Agent Skills](/docs/skills/setup).
diff --git a/web/content/docs/skills/setup.md b/web/content/docs/skills/setup.md
index 1cb8c23a..6d176d82 100644
--- a/web/content/docs/skills/setup.md
+++ b/web/content/docs/skills/setup.md
@@ -5,7 +5,7 @@ description: "Add OpenSEO skill files to your AI agent after connecting OpenSEO
OpenSEO Agent Skills are separate files from OpenSEO MCP.
-On Claude Code, skip the steps below and use the [OpenSEO plugin](/docs/claude-code-plugin) instead — it installs MCP and every skill in one step. On Codex CLI, use the [OpenSEO plugin](/docs/codex-plugin) the same way.
+On Claude Code or Claude Cowork, skip the steps below and use the [OpenSEO plugin](/docs/claude-code-plugin) instead — it installs MCP and every skill in one step. On Codex CLI, use the [OpenSEO plugin](/docs/codex-plugin) the same way.
First, [set up OpenSEO MCP](/docs/mcp). MCP gives your agent access to OpenSEO data.
diff --git a/web/public/llms.txt b/web/public/llms.txt
index 5b5440a8..2901747c 100644
--- a/web/public/llms.txt
+++ b/web/public/llms.txt
@@ -17,7 +17,7 @@ Working with OpenSEO:
- [Agent setup prompt](https://openseo.so/agent-setup.txt): Plain-text setup instructions for an agent to follow.
- [Agent setup](https://openseo.so/docs/agent-setup): The same prompt, manual steps for Claude Code, Codex, Hermes, Grok Bot, and other agents, and how to update skills.
-- [Claude Code plugin](https://openseo.so/docs/claude-code-plugin): Installs MCP and all twelve skills. Skills run as `/openseo:<skill>`.
+- [Claude plugin](https://openseo.so/docs/claude-code-plugin): Installs MCP and all twelve skills in Claude Code or Claude Cowork. Skills run as `/openseo:<skill>`.
- [Codex plugin](https://openseo.so/docs/codex-plugin): Installs MCP and all twelve skills in Codex CLI. Type `$` to pick a skill.
- [MCP setup](https://openseo.so/docs/mcp): Connect `https://app.openseo.so/mcp` in Claude Desktop, Cursor, Codex, or another MCP client, or use an API key for headless agents.
- [Install skills without a plugin](https://openseo.so/docs/skills/setup): Add the skills to agents that don't support the plugin.