Skip to content
OpenSEO
Get started

Docs

OpenSEO docs and SEO tutorials

Start with how OpenSEO works and what it costs, then follow a tutorial for the feature you need. The reference pages cover the REST API, the MCP server and every audit check.

Start here

Set up your account and understand the model: where the data comes from and what it costs.

  1. Getting started

    Get started with OpenSEO: create a YepAPI account, paste your key, run your first keyword research and set a monthly spending limit.

  2. How OpenSEO works

    How OpenSEO works: projects and markets, where the SEO data comes from, what runs in the background, what is stored and how it is secured.

  3. Costs, caching and limits

    How prices are worked out, when results are free, where to see what you spent, and the controls that stop spending.

Tutorials

One walkthrough per feature, from an empty project to results you can act on.

  1. The SEO tools, screen by screen

    A guide to every OpenSEO tool: keyword overview, keyword ideas, SERP checker, backlinks, competitors, AI visibility and local rank grids, screen by screen.

  2. Build a keyword list

    How to do keyword research: find keywords from a seed term, filter by volume and difficulty, save the ones worth targeting and keep them fresh.

  3. Track your rankings

    How to track keyword rankings on Google: set up a rank tracker for a country, city or exact point, price a check, run it and read the changes.

  4. Size up a competitor

    How to do SEO competitor analysis: find your organic competitors, size them up, run a keyword gap and see the backlinks behind their rankings.

  5. Audit a site

    How to run a technical SEO audit: crawl your site for free, fix issues by severity, track them audit to audit and export the fixes for a coding agent.

  6. Measure AI visibility

    How to track AI visibility: see whether ChatGPT, Claude, Gemini and Perplexity mention and cite your brand for the questions buyers ask.

  7. Use your Search Console and Analytics data

    How to use Google Search Console and GA4 for SEO: connect read-only, find striking-distance queries and rank pages by where a push pays off.

  8. Map local rankings

    How to track local rankings: find your Google Business Profile, check its reviews and run a geo-grid to map your Google Maps rank.

  9. Work with an AI agent

    How to do SEO with an AI agent: hand keyword research and rank tracking to Claude, Cursor or Codex over MCP, with a spending cap on every call.

Run it yourself

Run the whole stack on your own machine or server.

  1. Self-hosting

    How to self-host OpenSEO with Docker: run the open-source SEO suite on your own computer or a cloud server, with HTTPS for your own domain.

  2. Set up Google sign-in

    Create the Google OAuth client that lets users connect Search Console and Analytics to your install.

Reference

The details: every API route, MCP tool, audit check and error code.

  1. Connect your agent

    Connect Claude, ChatGPT, Cursor, Codex or Gemini to the OpenSEO MCP server: sign-in, a setup prompt, SEO skills and the Claude Code plugin.

  2. MCP tools

    All 69 tools of the OpenSEO SEO MCP server: keyword research, rank tracking, site audits, AI visibility and Search Console, and which ones spend.

  3. REST API

    The OpenSEO SEO REST API: authentication, the response envelope, every route for keywords, rankings and audits, and how dry runs and ceilings work.

  4. Site audit checks

    Every issue the crawler reports, its severity, what it means and how to fix it, and how the health score is worked out.

  5. Errors and troubleshooting

    OpenSEO errors and troubleshooting: what each error code means, from missing keys and spending limits to Google connection and site audit problems.

OpenSEO is an early project in active development. The docs describe what the current version does.