Guides
OpenSEO published nine agent skills for SEO workflows
OpenSEO released nine agent skills that run repeatable SEO workflows in Claude Code, Codex, or any agent that reads the SKILL.md format, backed by its MCP server for live keyword, SERP, backlink, local, and Search Console data.
The two parts do different jobs. MCP connects your agent to OpenSEO data. Skills tell your agent which workflow to run with it. You type a slash command, the agent does the research, and you get a recommendation, plan, or shortlist. Strategy stays with you. The full reference lives at openseo.so/docs/skills.
Setup
Connect MCP first. The hosted server URL is https://app.openseo.so/mcp. In
Claude Code:
claude mcp add --transport http --scope user openseo https://app.openseo.so/mcp
The first connection sends you through OpenSEO login. Claude Desktop, Cursor, Codex CLI,
and Codex Desktop each have their own path in the
MCP setup docs. For headless environments and CI, create an API key
under Settings → API keys and pass it as an
Authorization: Bearer oseo_YOUR_KEY header instead of using OAuth.
If Codex reports a missing issuer during authorization, upgrade to Codex CLI 0.147.0 or later — versions 0.143 through 0.146 drop the issuer from the OAuth callback.
Then install the skills. They are separate files from MCP:
npx skills add every-app/open-seo
That shows the available skills and agents. To install everything, add
--skill '*', and pin it to one agent with --agent claude-code or
--agent codex. You can also clone
every-app/open-seo and copy
.agents/skills/* into ~/.claude/skills/ or
~/.codex/skills/.
What MCP gives the agent
The skills depend on these tools: keyword research with volume, difficulty, and CPC; live Google organic SERPs; keyword, page, rank, and traffic rows for a domain or page; SERP competitor comparison across a keyword set; local business search near a coordinate; Maps and Local Finder SERPs; Google Business Profile audits, reviews, posts, Q&A, and category slugs; Maps rank grids; saved keyword read and write; rank tracker configs and positions; domain organic overview; backlink and referring-domain overview; and Google Search Console performance plus URL inspection, up to 10 URLs per call.
Search Console data is first-party. No third-party tool can estimate it, and having it in the same context as SERP and backlink data is what lets these skills reason about your own site rather than a model of it.
The nine skills
SEO Project Setup
/seo-project-setup
Sets up a local workspace for one website or SEO project. The agent saves the domain, goals, audience, positioning, competitors, and target markets, organizes exports and notes, and records how you want it to approach SEO here. You get a folder structure and a short project summary: what site is in scope, which goals matter, what files are available, and what to run next. Run it from the folder where SEO work should live, and add Google Search Console exports if you have them. Later sessions reuse that context.
SEO Coach
/seo-coach
Recommends the next workflow. The agent looks at your goal, experience level, available data, and project context, explains the options in plain language, and keeps the next step small enough to act on. Useful for questions like where to start, whether to research keywords or competitors first, and how to use AI for SEO without getting generic output. If you already know which workflow you want, run that skill directly.
SEO Audit
/seo-audit
Audits a site and writes a one-page HTML report. The agent runs an OpenSEO site audit, pulls backlink and traffic-estimate data, and verifies every finding against the live page HTML before reporting it. The report is built around one action to take this week, with the exact steps or message included, then five to ten small fixes with evidence, a starting focus area of three to five specific keywords, a list of what already works, and a note on how the review was done. Technical terms are explained the first time they appear, so the report works for a client or founder who has never done SEO.
Broken sites are handled explicitly. If the domain is down or half-crawled, the agent investigates the cause first — an expired certificate, a dead domain with a live successor, a page-level block — and the recommendation changes to match. The site audit is included on every plan, up to 50 pages on the free plan; backlink, domain, and keyword lookups spend credits, and the skill keeps that spend modest.
Keyword Research
/keyword-research
Finds keywords worth targeting. The agent researches ideas from seed topics, products, pages, competitors, or audience problems, evaluates volume, difficulty, CPC, intent, and SERP competitiveness, and filters out irrelevant, duplicate, branded-only, and off-strategy terms. You get a prioritized shortlist, a longer opportunity table, SERP caveats, and a recommended next action, with reasons attached to each keyword. Give it one to five focused seed topics and name the country or language when it matters. It asks before saving keywords back to OpenSEO.
Keyword Clustering
/keyword-clustering
Turns a keyword list into a page plan. The agent groups keywords by intent, SERP similarity, and page type, separates terms that look similar but need different pages, maps clusters to existing URLs where they fit, and proposes new pages where nothing matches the intent. You get clusters with primary and secondary keywords, intent, page targets, priorities, and notes on cannibalization or consolidation. Input can be a keyword list, a saved keyword tag, a Search Console export, a seed topic, or a domain. Share your existing pages if you want URL mapping. Tag changes stay user-approved.
Competitive Landscape
/competitive-landscape
Maps a market before you choose competitors or pages. The agent builds a representative query set, inspects SERPs for recurring domains, separates direct product competitors from publishers, directories, communities, marketplaces, and resource sites, and compares organic footprints and keyword coverage across the strongest domains. You get market leaders, the most winnable opportunity area, the biggest ranking barrier, the query set used, domain types, winning themes, and recommended next workflows. Ask it to label domain types clearly — in many markets the pages winning search traffic are not your business competitors.
Competitor Analysis
/competitor-analysis
Analyzes one competitor in depth. The agent reviews ranking keyword themes, page opportunities, backlink and authority signals, and head-to-head SERPs, keeping evidence separate from inference. You get a competitor snapshot, the biggest lesson, the best opportunity to beat them, content patterns, backlink notes, and priority actions. It recommends stronger angles rather than copies of competitor pages. Use it when a competitor keeps appearing in search results or sales conversations, or before building comparison pages.
Local SEO
/local-seo
Works out why a business does or does not show up in Google Maps and the local pack. The
agent audits the Google Business Profile — categories, rating, hours, photos, claim
status — compares it to the competitors ranking nearby, analyzes the review gap by
volume, recency, rating, and owner replies, and runs a rank grid showing where Maps
visibility drops off around the location. You get a profile snapshot, a visibility map, a
signal-by-signal comparison, and a prioritized fix list starting with this week's. Give
it the cid or placeId rather than a business name, and the
correct storefront coordinate — a grid centered on the wrong place is worse than no grid.
Every grid point is a paid search, so ask for the cost before running anything larger
than 3×3.
Link Prospecting
/link-prospecting
Finds outreach prospects for a page or asset. The agent builds prospecting queries from your asset, topic, audience, or competitors, searches resource pages, listicles, comparisons, directories, publishers, and topical articles, and uses competitor backlink patterns to see where attention comes from. Prospects are qualified by topical relevance and outreach angle. You get the best angle, the highest-priority prospect type, a prospect table, contact-discovery notes, and reusable outreach drafts. It does not invent contacts, and it requires source URLs for any contact details. Use it when you already have something worth linking to: a guide, product page, study, tool, template, or dataset.
Where to find these skills
Skillscout is a catalog and Chrome extension for finding official agent skills. The catalog collects vendor-published skills in one place, and the extension surfaces the ones that match the site you are currently on. The nine OpenSEO skills are listed on the OpenSEO vendor page, each with its install command.
Official documentation: openseo.so/docs/skills. Source SKILL.md files: every-app/open-seo. Skillscout listing: skillscout.sh/official/every-app.
