Nextfix

An SEO tool that tells you what to fix next. Runs locally, costs nothing, and can be fully operated by Claude via MCP.

Large SEO suites show hundreds of numbers (errors, warnings, notices) and leave it to you to decide where to start. Nextfix audits a website just as thoroughly and turns the result into a short list: what to do first, why, how, and how much it will help.

All screenshots show the fictional demo website “Radhaus Elbe” (scripts/demo_website.py). The user interface is in German.

Features

On top of that, checks for AI search (GEO): llms.txt, blocked AI crawlers, citations, FAQ markup, author and date, organization markup, based on the GEO study (Princeton, KDD 2024).

Related MCP server: DataForSEO MCP Server

What makes it different

• Tasks, not a wall of numbers. Every issue becomes one sentence with an action, the effort involved (“configure once”, “write text”), who does it (yourself in the CMS, or your developer/host) and its impact (high / medium / low). No fake precision like “+4.2 points”: nobody can predict what a fix does to rankings.

• An honest health score. The formula does not dilute problems across checks that never fire, and thin content on many pages weighs as much as an error (app/core/score.py).

• Plain language. Urgent / Important / Polish instead of Error / Warning / Notice, technical terms explained.

• Zero cost. No paid APIs and no scraping of Google results (terms of service). Rankings come only from Search Console and Bing, the sources website owners already have access to.

• Three interfaces, one core. Web UI, REST API (/docs) and an MCP server for Claude share the same functions.

• Light and dark mode, mobile-friendly, works offline (font and HTMX are bundled).

Quick start

Requires Python 3.12 or newer.

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/playwright install chromium          # for page speed and PDF reports
.venv/bin/uvicorn app.web:app --reload         # http://localhost:8000

Then add a domain and click “Website prüfen” (audit website). No website of your own? Start the demo site:

.venv/bin/python -m scripts.demo_website 8798  # demo website “Radhaus Elbe” at http://127.0.0.1:8798/

Create a project with the start URL http://127.0.0.1:8798/. Rankings can be tried out without access using test data.

With Claude (MCP)

.venv/bin/python -m app.mcp_server             # MCP server (stdio)

For Claude Code, copy .mcp.json.example to .mcp.json and set your project path. 50 tools, e.g. crawl_starten, issues_liste, onpage_pruefen, positionen_uebersicht, keyword_recherche_starten, vitals_messen, pdf_bericht.

Google Search Console, Bing and Open PageRank

Setup guides (German): docs/anleitung-gsc.md, docs/anleitung-bing.md. For domain authority, get a free key at openpagerank.keywordseverywhere.com and save it as ~/.config/seo-tool/openpagerank-api-key.txt. Credentials live outside the project in ~/.config/seo-tool/ and never end up in Git.

Development

.venv/bin/python -m pytest -q                  # tests (no network needed)
.venv/bin/python -m scripts.screenshots        # regenerate screenshots (separate demo database)

Convention: a new feature starts in app/core/, then gets wired into the API, the UI and MCP, plus a test. Data is stored in data/seo.db (SQLite, not in Git); set a different path with SEO_DB. Code and UI are written in German.

Limitations

• No individual backlinks and no competitor rankings; both would require paid databases. Domain authority (one value per domain) comes from Open PageRank.

• JavaScript rendering is optional and slower (Chromium per page); without it, content rendered only by JS is not seen.

• Page speed is a lab measurement, not field data from real users (CrUX).

License

MIT. Font: Fira Sans (SIL Open Font License, app/web/static/fonts/OFL.txt). HTMX 2.0.4 (BSD-2-Clause).