Home / Open Source / open-seo

open-seo

Open-source, pay-as-you-go SEO tool and Semrush/Ahrefs alternative with keyword research, rank tracking, backlinks, site audits and an MCP server.

TypeScriptMITApplication
โญ GitHubhttps://github.com/every-app/open-seo
24,361
Stars
+0
Star growth
Oct 20, 2026
Last updated
8
Clicks

1. Project Overview

OpenSEO is an open-source, pay-as-you-go SEO toolkit โ€” positioned as an alternative to Semrush and Ahrefs โ€” that covers keyword research, rank tracking, competitor insights, backlinks, site audits and AI visibility, and exposes the same data to AI agents through an MCP server and Agent Skills.

2. Background & Positioning

Why it was created

Established SEO suites are typically sold as monthly subscriptions, which is a poor fit for small teams, indie developers and agencies that only run SEO analyses occasionally. OpenSEO takes a different approach: you bring your own DataForSEO API key and pay only for the data you actually request. There is no seat licence or flat subscription when you self-host.

How it differs from similar projects

  • Usage-based cost โ€” data is billed by DataForSEO per request instead of a bundled monthly plan.
  • Open and forkable โ€” MIT-licensed, with a deliberately simple UI built around focused workflows, designed to be customized.
  • Agent-ready โ€” ships an MCP server and reusable Agent Skills so tools such as Claude Code, Codex, ChatGPT and other agents can run SEO tasks directly.
  • Flexible hosting โ€” use the hosted service at openseo.so or self-host with Cloudflare or Docker.

3. Feature Categories

๐Ÿ”Ž Keyword Research

Discover and evaluate search terms and their potential. Purpose: decide which topics are worth targeting.

๐Ÿ“ˆ Rank Tracking

Monitor how your pages rank for chosen keywords over time. Purpose: measure the effect of your SEO work.

๐Ÿ•ต๏ธ Competitor Insights

Examine what competing sites rank for. Purpose: find gaps and opportunities.

๐Ÿ”— Backlinks

Review link profiles pointing to a site. Purpose: understand authority and link-building opportunities.

๐Ÿฉบ Site Audits

Crawl a site and surface technical SEO issues. Purpose: find and fix problems that hold rankings back.

๐Ÿค– AI Visibility

Check how a brand or site shows up in AI-driven search experiences. Purpose: stay visible as search shifts toward AI answers.

๐Ÿงฉ Agent Integrations

An MCP server, Agent Skills, and setup guides for ChatGPT (web and desktop), Codex and Claude Code-style agents. Purpose: let AI agents run SEO workflows on real data.

4. Key Highlights

  • Pay only for what you use โ€” bring your own DataForSEO key; self-hosting costs go straight to DataForSEO.
  • MCP server and Agent Skills โ€” guide agents step by step through SEO tasks.
  • Cloudflare-first self-hosting โ€” the recommended path, documented as workable on Cloudflare's free plan.
  • Docker option โ€” a compose.yaml setup, best suited for testing.
  • Hosted option โ€” free to try; a hosted subscription is listed at $10/month, with a 28% markup on DataForSEO requests.
  • Modern TypeScript stack โ€” Vite, Cloudflare Wrangler, pnpm and Drizzle ORM, easy to fork and extend.

5. Use Cases by Role

  • General developers โ€” add SEO data to your own apps or fork the UI for a custom workflow.
  • DevOps/SRE โ€” self-host on Cloudflare or Docker and manage keys through environment configuration.
  • Data/research scientists โ€” pull keyword, ranking and backlink data for analysis, or query it through an agent.
  • Project managers & marketers โ€” track rankings, audit sites and compare competitors without a fixed subscription.

6. Getting Started

Find what you need

Install / integrate

Self-hosting guides live in the repository:

git clone https://github.com/every-app/open-seo.git
cd open-seo
# Then follow one of:
#   docs/SELF_HOSTING_CLOUDFLARE.md  (recommended)
#   docs/SELF_HOSTING_DOCKER.md      (best for testing)
#   docs/LOCAL_DEVELOPMENT.md        (development)
#   docs/DATAFORSEO_API_KEY.md       (API key setup)

Contribute

Clear, well-written issues are the most useful contribution. The project provides a skill to help:

npx skills add every-app/open-seo --skill simple-issue-description

See docs/CONTRIBUTING.md for details.

7. Project Structure

open-seo/
โ”œโ”€โ”€ src/            # Application source
โ”œโ”€โ”€ web/            # Web frontend
โ”œโ”€โ”€ docs/           # Self-hosting, development and contributing guides
โ”œโ”€โ”€ drizzle/        # Database migrations
โ”œโ”€โ”€ deploy/         # Deployment configuration
โ”œโ”€โ”€ plugins/openseo/# Plugin package for agent tools
โ”œโ”€โ”€ scripts/        # Tooling scripts
โ”œโ”€โ”€ specs/          # Specifications
โ”œโ”€โ”€ tests/          # Tests
โ”œโ”€โ”€ compose.yaml    # Docker Compose setup
โ”œโ”€โ”€ wrangler.jsonc  # Cloudflare configuration
โ””โ”€โ”€ .env.example    # Example environment variables

8. Related Ecosystem

  • DataForSEO โ€” the required data provider for all SEO data.
  • Cloudflare โ€” the recommended self-hosting platform (Railway, Coolify and Dokploy are also mentioned).
  • MCP-compatible agents โ€” Claude Code, Codex, ChatGPT, OpenClaw and Hermes.
  • Commercial counterparts โ€” Semrush and Ahrefs, which OpenSEO positions itself as an alternative to.

9. License

  • โœ… Use, modify, fork and redistribute the code, including commercially, under the MIT License
  • โœ… Self-host for personal, team or client work
  • โŒ No warranty or liability from the authors
  • โ„น๏ธ Keep the copyright and licence notice in copies
  • โ„น๏ธ SEO data comes from DataForSEO, which has its own pricing and terms

10. FAQ

Q: Do I need a subscription?
A: Not when self-hosting. You pay DataForSEO directly for usage. The hosted version is free to try, with a paid plan listed at $10/month.

Q: Where should I self-host it?
A: Cloudflare is recommended (see docs/SELF_HOSTING_CLOUDFLARE.md). Docker is best for testing (docs/SELF_HOSTING_DOCKER.md).

Q: Can AI agents use it?
A: Yes. See the MCP guide and the Agent Skills guide.

Q: How do I get a DataForSEO key?
A: Follow docs/DATAFORSEO_API_KEY.md in the repository.

Q: How can I contribute?
A: Open a clear issue; the simple-issue-description skill can help you write one.

11. Quick Links

12. Summary

OpenSEO brings the core workflows of commercial SEO suites into an MIT-licensed, usage-priced, forkable project, and makes that data available to AI agents. It suits developers, small teams, agencies and marketers who want SEO insights without a fixed monthly subscription.