open-seo-mcp-skills README

The project's README from github.com/Ryze-AI-Adgent/open-seo-mcp-skills. As one markdown file: README.md.

Open SEO MCP Skills

Free SEO & GEO data via MCP

Open-source SEO + GEO skills for Claude — keyword research, rank tracking, site audits, backlinks, competitor gaps, AI visibility — running on your own Search Console, Analytics and ads data through the Ryze MCP, with DataForSEO built in for the data Google won't give you.

No subscription for the tool. No markup on API calls. The skills are MIT — take them, change them, ship them.

Why this exists

"Open source SEO tools" are having a moment. Look closer and most are a UI over the DataForSEO API: you either bring your own key and pay per request, or pay a hosted subscription plus a ~28% markup on every data call. The code is free; the data never was.

This takes the opposite approach:

Quick start

claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp
claude plugin marketplace add Ryze-AI-Adgent/open-seo-mcp-skills
claude plugin install open-seo-mcp-skills@ryze

Then: "run an SEO audit on mysite.com". The plugin bundles the connector, so step one is optional in Claude Code.

Product pages: Google Ads MCP · Meta Ads MCP

Install (2 steps)

1. Connect the Ryze MCP — in Claude: Settings → Connectors → Customize → add custom connector:

Name: Ryze AI
URL:  https://connector.get-ryze.ai/mcp

Sign in, pick your workspace, connect your Google Search Console / GA4 / ads accounts once. Full guide: https://www.get-ryze.ai/how-to-connect-claude-to-google-meta-ads-mcp

2. Install the skills — as a Claude Code plugin:

claude plugin marketplace add Ryze-AI-Adgent/open-seo-mcp-skills
/plugin install open-seo-mcp-skills@ryze

or just copy them:

git clone https://github.com/Ryze-AI-Adgent/open-seo-mcp-skills && cp -r open-seo-mcp-skills/skills/* ~/.claude/skills/

The skills

Skill What it does Data source
seo-audit Full site audit: indexation, CTR anomalies, decaying pages, quick wins GSC + GA4
keyword-research Seed → ideas → volume/CPC/intent → clustered keyword plan Google Ads + DataForSEO
rank-tracking Position movers between any two periods, no tracker subscription GSC
competitor-gap Keywords a competitor ranks for that you don't DataForSEO + GSC
backlink-check Backlink profile + referring domains vs a competitor DataForSEO
ai-visibility Which AI engines send you traffic and which pages they cite GA4 AI-referral reports
content-brief SERP-driven brief: headings, entities, questions, internal links DataForSEO + GSC
seo-vs-ads Queries you pay for that you already rank for organically GSC × Google Ads

Then just ask: "run an SEO audit on my site", "what keywords does competitor.com rank for that I don't?", "how much am I paying for clicks I'd get free?"

How it compares

OpenSEO-style wrappers Semrush/Ahrefs This
Tool cost free code or ~$10/mo hosted $120+/mo free (MIT)
Data cost your DataForSEO bill (+~28% markup if hosted) included through your Ryze workspace
Rankings estimated from SERP scrapes estimated your real GSC positions
Traffic estimated estimated your real GA4
AI visibility prompt-sampling estimates limited your actual AI referral traffic
Works inside Claude via MCP no native skills + MCP

Notes for skill authors

Ryze MCP tools are namespaced <provider>__<tool> (e.g. google_search_console__runRawSearchAnalytics, google_ads__generateKeywordIdeas). When a request shape is unclear, call native__get_provider_docs with the provider (dataforseo, google_search_console, …) — it returns the official API docs. Tool availability can vary by workspace; every skill here states its fallback.

License

MIT. The skills and this repo are free forever. Data access runs through your own Ryze workspace and your own connected accounts.

open-seo-mcp-skills (Ryze-AI-Adgent/open-seo-mcp-skills)

Searching Database…

What is this?A set of open-source SEO and GEO (generative engine optimization) skills for Claude, paired with an MCP connector called Ryze that pulls data from your own Google Search Console, GA4 and Google Ads instead of relying on estimates.
Is this a standalone app or something that plugs into Claude?It's a Claude Code plugin: a bundle of markdown-based skills plus the Ryze MCP server/connector that Claude calls to fetch your real analytics and SEO data; there's no separate UI to run.
Do I need my own DataForSEO or API keys?No — competitor keywords, backlinks and SERP data come from DataForSEO already wired into the Ryze connector, so there's no key to manage; you do need your own Google Search Console, GA4 and Google Ads accounts connected through your Ryze workspace, and Ahrefs/Semrush can optionally be connected if you already pay for them.
Any catches compared to other SEO tools?Tool availability can vary by workspace, so some skills may fall back to alternate data sources when a tool isn't connected; also the core value depends on you having real GSC/GA4/Ads data connected rather than just running the skills standalone.
What skills come in the bundle?Eight: seo-audit (indexation, CTR anomalies, decaying pages), keyword-research (seed to clustered keyword plan), rank-tracking (position movers between periods), competitor-gap, backlink-check, ai-visibility (which AI engines send you traffic), content-brief (SERP-driven outline), and seo-vs-ads (paid queries you already rank for organically).
Why not just use another open-source SEO tool?Most 'open source SEO tools' are just a UI over the DataForSEO API where you pay per request or a hosted subscription plus roughly a 28% markup on every data call. This project uses your actual GSC rankings, actual GA4 traffic and actual Google Ads keyword data instead of SERP-scrape estimates, with DataForSEO already wired in at no markup.
How does it compare to Ahrefs or Semrush?Ahrefs/Semrush cost $120+/month and give estimated rankings and traffic; this is free (MIT) and uses your real GSC positions and real GA4 traffic instead of estimates, running natively as Claude skills plus MCP rather than a separate dashboard.
What does the ai-visibility skill actually track?It reads GA4 AI-referral reports to show which AI engines (ChatGPT, Perplexity, Claude, Gemini) are sending you traffic and which of your pages they cite.
Size
15.5 MB
Stars
5.9K
Updated
CommitOct 13
Age
1mo
Commits · 90 Days