What you’ll have at the end
Your own SEO tool for keyword research, rank tracking, competitor insights, backlinks, site audits and AI visibility, without a monthly Semrush or Ahrefs bill. Your AI (Claude, ChatGPT, Codex, Cursor) can also use it to do SEO work for you.
Written from OpenSEO’s GitHub README and its docs (DataForSEO key, Docker self-hosting), read on 17 Nov 2026.
Which way should you use it?
| Hosted (openseo.so) | Self-hosted (your computer or server) | |
|---|---|---|
| Setup | Sign up and go | Docker or Cloudflare, about 30 min |
| Who pays DataForSEO | OpenSEO bills you. It adds about 28% on top of DataForSEO’s price | You pay DataForSEO directly |
| Monthly fee | Free to try; $10/month if you want to support the project | None |
| Best for | Business owners trying it out | Agencies and heavy users |
Our suggestion: try the hosted version first. If you end up using it every week, self-hosting saves the extra 28%.
Option A: hosted (5 minutes)
Sign up
Go to openseo.so and create an account.
Run your first search
Type a keyword your customers would search for, like “dentist in Kochi”. Look at the volume and difficulty, and at who ranks right now.
Option B: self-hosted with Docker
You need Docker Desktop and some comfort with a terminal. If that’s new to you, stay on the hosted version.
Get a DataForSEO API key
Create an account at dataforseo.com and open API Access. Copy the credential labelled Base64. New accounts get $1 of free credit to test with. After that, the minimum top-up is $50.
Install Docker Desktop
Install Docker Desktop and give it at least 4 GB of memory in its settings.
Download OpenSEO
Open PowerShell (Windows) or Terminal (Mac) and run these one at a time:
Windows (PowerShell):cd open-seoMac / Linux:$env:COMPOSE_FILE = "deploy/standalone/compose.yaml"; copy deploy/standalone/.env.example deploy/standalone/.envexport COMPOSE_FILE=deploy/standalone/compose.yaml && cp deploy/standalone/.env.example deploy/standalone/.envAdd your keys
Open
deploy/standalone/.envin Notepad and set two values:DATAFORSEO_API_KEY: paste the Base64 credential from step 1.STORAGE_SECRET_KEY: any long random text. Treat it like a password.
Leave
BETTER_AUTH_URL=http://localhost:3001as it is.Start it
docker compose pulldocker compose up -dWait until you see OpenSEO initialized and ready.docker compose logs -f initCreate your admin account
Open http://localhost:3001 and create the first account. That account becomes the admin, and sign-up closes after it. Invite teammates from Team settings.
OpenSEO can also be deployed to your own Cloudflare account with one command (it works on the free plan). See docs/SELF_HOSTING_CLOUDFLARE.md in the repo.
Connect Claude or ChatGPT
OpenSEO has an MCP server and ready-made Agent Skills. Follow the official setup pages on openseo.so/docs for ChatGPT, Codex or MCP. Then you can ask, for example:
Using OpenSEO, find 20 low-competition keywords for a bakery in Kochi and group them by search intent.
Costs at a glance
- Software: free (MIT licence).
- SEO data: pay-as-you-go to DataForSEO, starting with $1 free credit and then a $50 minimum top-up.
- Optional extras: AI summaries need an OpenRouter key, and JavaScript-rendered site audits need a rendering key. Both are paid per use.
Back to the full list: 4 open-source alternatives to paid AI tools