OpenSEO
π§MCP ServerOpenSEO is an open-source tool for improving how your website shows up in search results, as a cheaper option to Semrush or Ahrefs. Your AI agent can use its data to do keyword research, track rankings and check your site.
Installation
What this MCP server does
Overview
OpenSEO helps you with SEO, which means getting your website to show up higher in search engines. It is an open-source option to tools like Semrush and Ahrefs. AI agents such as Claude Code, ChatGPT, Codex and Cursor can connect to it and use your SEO data directly.
Key Features
- Find which search words people use and how popular they are.
- Track where your pages rank in search results over time.
- See what competitors do and which other sites link to yours.
- Run a check of your website to find problems.
- Use ready-made agent skills, or write your own, to guide your AI agent through SEO tasks.
Who is this for?
It suits site owners and marketers who find big SEO tools too costly or complex. You can use the hosted version or run it yourself with Docker or Cloudflare. Either way you need a DataForSEO key, a paid data service, and you only pay for what you use.
Summarized by AI from this repo's README. Suggest a better one
README.md
View on GitHub βOpenSEO
Open source alternative to Semrush and Ahrefs
OpenSEO is an SEO tool for the people. If tools like Semrush or Ahrefs are too expensive or bloated, OpenSEO is a pay-as-you-go alternative that you actually control.
All-in-one SEO tool for you and your AI agent.
Connect with any agent like Claude Code, OpenClaw or Hermes. We have pre-built skills, but you can build your own to tailor OpenSEO to your needs.
Hosted Version
Try OpenSEO for free on our website. If you want to support the project, a hosted subscription is $10/month.
EveryApp
Host OpenSEO and other open source apps on our platform EveryApp.
Self-host on EveryApp and give it a star β
Why use OpenSEO?
- Best in class MCP and AI Skills.
- Modern, simple UI.
- Focused workflows instead of a bloated, complex SEO suite.
- No subscriptions.
- Bring your own DataForSEO API key and pay only for what you use.
- Fork and vibe code your own custom tool.
Main SEO Workflows
- Keyword research
- Rank tracking
- Competitor Insights
- Backlinks
- Site Audits
- AI Visibility
OpenSEO MCP & Agent Skills
OpenSEO exposes an MCP server so AI agents like Claude Code, OpenClaw, and Hermes can use your SEO data directly. Agent Skills are reusable workflows that guide your agent through SEO tasks using the MCP.
- Set up ChatGPT web or desktop (works on Free and paid ChatGPT plans)
- Set up Codex
- Set up OpenSEO MCP
- Set up OpenSEO Agent Skills
Self-Hosting
OpenSEO supports two self-hosting paths. Both use email and password accounts: the first visitor creates the admin account, teammates join from invitation links, and MCP clients (Claude, ChatGPT, Codex, Cursor) sign in with the same accounts.
- Docker - On your own server or computer, with a prebuilt image that is ready in seconds. Works with Compose-based platforms such as Coolify, Portainer and Dokploy. See
docs/SELF_HOSTING_DOCKER.md.- Running the older single-container image? It keeps getting updates; move to the new setup when you are ready, data included.
- Cloudflare - No server to run: one deploy command puts OpenSEO on your own Cloudflare account (works on the free plan). See
docs/SELF_HOSTING_CLOUDFLARE.md.
For security-conscious setups, two advanced options replace the accounts with your own network controls:
- Cloudflare Access in front of the Cloudflare deploy, so Cloudflare checks every request before it reaches OpenSEO. See
docs/SELF_HOSTING_CLOUDFLARE.md. - No sign-in on Docker, behind Tailscale, a private network or your own authenticating proxy. See Without sign-in.
Either way, you need a DataForSEO API key to get SEO data. See docs/DATAFORSEO_API_KEY.md.
Costs
OpenSEO needs a DataForSEO API key so that you can get SEO data. You pay them directly when self hosting.
When you self host, your costs will be slightly lower than the estimates on our website. The way the hosted service makes money is by charging 28% extra for every request we make to DataForSEO.
Local Development
See docs/LOCAL_DEVELOPMENT.md.
Contributing
Creating clear issues is the best way to contribute.
Read more here: .github/CONTRIBUTING.md
We have this skill: /simple-issue-description which helps.
npx skills add every-app/open-seo --skill simple-issue-description
Community
Join Discord to chat: Discord
Follow along for updates:
- Follow on X: https://x.com/bensenescu
- Sign up for the mailing list on our website: openseo.so
Stop Paying $100+/Month for SEO β OpenSEO Is Free and Open Source
More from this repository10
Helps you find search words worth targeting for your website using OpenSEO data. It checks how often people search them and how hard they are to rank for, saves the good ones, and delivers a report.
Studies one competitor's website to see how it gets visitors from search engines. It looks at the search words it ranks for, its topics and links from other sites, then shows gaps you can use, in an OpenSEO report.
Groups search words by what people are looking for and decides which page on your site should target each group. It uses OpenSEO tools and delivers the plan as a report.
A friendly coach for OpenSEO that explains how to get your site found in search engines in plain words. It reads your project details, suggests one clear next step, and points you to a fuller report when you want more depth.
Finds websites, pages and authors that might link to your page or product, then looks up public ways to contact them. It drafts outreach messages and saves the findings as a report in OpenSEO.
Shows who wins the most search traffic in your market, what content works for them, and where openings remain for you. It uses OpenSEO data and delivers the result as a saved report.
Interviews you once about your website's search goals, competitors, key pages and writing preferences, and saves the answers in your OpenSEO project. Other OpenSEO skills then reuse this information in later sessions.
Gets a code branch ready for the project maintainer's final review. It checks for security problems, needless complexity, and ways to get paid features for free, fixes real issues, runs the checks, and opens or updates the pull request without merging it.
Prepares a new release of the OpenSEO project from start to finish. It raises the version number, writes short release notes from the changes since the last release, double-checks them, and opens a pull request.
Skill