OpenSEO: Open-Source SEO Tool for AI Agents
every-app/open-seo
OpenSEO is an open-source SEO tool that swaps a flat Semrush or Ahrefs subscription for a self-hosted app billed by the API call. Reach for it if you have, or don't mind buying, a DataForSEO key and want keyword research, rank tracking, and site audits wired into Claude Code or another MCP-speaking agent. Skip it if you want a polished dashboard with support included — this is a fork-it-yourself tool, not a managed product.
What is OpenSEO?
OpenSEO is a TypeScript SEO application, with 10,549 GitHub stars, bundling keyword research, rank tracking, competitor insights, backlink analysis, site audits, and AI visibility checks into one self-hosted tool. It runs on a DataForSEO API key you supply, so there's no OpenSEO fee beyond what DataForSEO charges. It also exposes an MCP server, so agents like Claude Code, OpenClaw, or Hermes can query your data and run Agent Skills.
Addressing High-Cost SEO Tools
Semrush and Ahrefs bill a flat monthly rate whether you run ten queries or ten thousand, and neither lets you self-host or point an AI agent straight at the underlying data. OpenSEO strips the SaaS layer out: you supply a DataForSEO API key, pay DataForSEO for exactly what you query, and run the OpenSEO app yourself via Docker or Cloudflare. The README frames this as a tool 'for the people' — pay-as-you-go pricing you control instead of a subscription tier you're locked into.
Core SEO Workflows and AI Integration
- ✓Six core SEO workflows: keyword research, rank tracking, competitor insights, backlink analysis, site audits, and AI visibility checks
- ✓MCP server exposes your SEO data directly to AI agents like Claude Code, OpenClaw, and Hermes
- ✓Pre-built Agent Skills guide an agent through SEO tasks over the MCP connection, and you can write your own
- ✓Bring-your-own DataForSEO API key model — no OpenSEO subscription, you pay DataForSEO per request
- ✓Two self-hosting paths: a simple Docker setup for solo use, and a Cloudflare deployment for internet-facing, multi-device or team use on Cloudflare's free plan
- ✓MIT-licensed source you can fork and modify — the README calls it building your own 'vibe coded' custom tool
- ✓Hosted version at openseo.so with a free option and a $10/month subscription for anyone who'd rather not self-host
Practical Applications for SEO Tasks
- •Running keyword research and rank tracking for a site without paying for a Semrush or Ahrefs seat
- •Letting an AI coding agent pull backlink and site audit data mid-conversation via the MCP server instead of you copy-pasting reports
- •Self-hosting a private SEO tool for a small team on Cloudflare's free plan rather than sharing logins to a paid SaaS account
- •Forking the codebase to build a custom SEO workflow or Agent Skill tailored to one site or client
Self-Hosting OpenSEO
OpenSEO supports two self-hosting paths, per the README. Docker is for personal use on a single machine and is what the project recommends for getting started; Cloudflare is for internet-facing deployments across multiple devices or a team, and it works on Cloudflare's free plan. Either path needs a DataForSEO API key before OpenSEO can pull any SEO data — the README links to separate docs (docs/SELF_HOSTING_DOCKER.md, docs/SELF_HOSTING_CLOUDFLARE.md, docs/DATAFORSEO_API_KEY.md) for the exact setup steps, which aren't reproduced here. A hosted version also exists at openseo.so for anyone who'd rather skip self-hosting.
Strengths
- ✓Pay-as-you-go pricing via your own DataForSEO key instead of a flat SaaS subscription
- ✓MCP server plus pre-built Agent Skills let an AI agent run SEO workflows directly, not just read a dashboard
- ✓MIT license and a codebase built to be forked and customized
- ✓Two self-hosting options that fit different needs: a quick Docker setup for solo use, Cloudflare for a team on a free plan
Understanding OpenSEO's Dependencies and Costs
- △No SEO data works without a separate DataForSEO API key and DataForSEO account — OpenSEO itself doesn't provide keyword or backlink data
- △Self-hosting means you're responsible for Docker or Cloudflare setup, updates, and uptime, unless you pay for the $10/month hosted plan
- △The hosted plan marks up DataForSEO usage by 28%, per the README, so self-hosting is cheaper but takes more setup work
- △The README doesn't list a version number, release history, or roadmap, so it's hard to judge from the repo alone how mature specific features are
Open-Source Alternative to Commercial SEO Suites
Frequently Asked Questions
OpenSEO itself has no required subscription — you pay DataForSEO directly for the SEO data you query. If you'd rather not self-host, OpenSEO also offers a $10/month hosted subscription, per the README.
OpenSEO requires a DataForSEO API key to pull any keyword, rank, backlink, or audit data — without one, the self-hosted app has no SEO data source to query.
OpenSEO exposes an MCP server so agents such as Claude Code, OpenClaw, and Hermes can query your SEO data directly, plus pre-built Agent Skills that guide an agent through SEO workflows.
OpenSEO supports two self-hosting paths: a simple Docker setup for personal use on one machine, and a Cloudflare deployment for internet-facing use across multiple devices or a team on Cloudflare's free plan.
OpenSEO is released under the MIT license, so you can fork, modify, and redeploy the codebase freely.
OpenSEO trades Semrush's and Ahrefs's flat hosted subscriptions for a self-hosted app billed per DataForSEO query, plus direct MCP access for AI agents, giving up their polish and support for control over cost and deployment.
Who should try it — and who should skip
Try OpenSEO if you're comfortable running a Docker container or a Cloudflare deployment, already pay (or don't mind paying) DataForSEO directly, and want an AI agent — Claude Code, OpenClaw, or Hermes — to pull SEO data through MCP instead of a browser tab. Skip it if you want one flat bill with no infrastructure to manage, or you need the account support only a vendor like Semrush or Ahrefs provides.
Related repositories
Curious whether open-seo is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about open-seo.