Self-hosted SEO rank tracker: Google Search Console, Bing, DuckDuckGo, Mojeek, Brave. Web UI + API
426
Self-hosted SEO rank tracker. See where your websites rank for their keywords on Google, Bing, DuckDuckGo, Mojeek and Brave. It includes history charts, scheduled checks, CSV export and a JSON API. Everything runs in one small container with SQLite and needs no external services. Runs on amd64 and arm64 (Raspberry Pi 4/5).
mkdir -p rank-tracker && cd rank-tracker
docker run -d --name rank-tracker --restart unless-stopped \
-p 8085:8080 -e TZ=Europe/Berlin -e ADMIN_PASSWORD=change-me \
-v "$PWD/data:/data" usernahme/rank-tracker:latest
Open http://<host>:8085, create a project and press Check project.
services:
rank-tracker:
image: usernahme/rank-tracker:latest
container_name: rank-tracker
restart: unless-stopped
ports:
- "8085:8080"
environment:
TZ: Europe/Berlin
ADMIN_PASSWORD: change-me # protects the web UI
API_TOKEN: "" # optional, header X-Api-Key for /api/*
volumes:
- ./data:/data
All settings (projects, keywords, schedule, API keys) are made in the web UI and
stored in /data/rank.db. Back up this file to back up everything.
| Variable | Default | Description |
|---|---|---|
ADMIN_PASSWORD | – | Password for the web UI. Set it if anyone else can reach the port. |
API_TOKEN | – | Allows /api/* with header X-Api-Key while a password is set |
TZ | Etc/UTC | Time zone for scheduled checks |
PORT | 8080 | Internal HTTP port |
SECRET_KEY | generated | Session key (auto-generated and persisted) |
PUID / PGID | 1000 | User/group the app runs as. Ownership of /data is fixed automatically at start. |
| Path | Description |
|---|---|
/data | SQLite database (ownership is set to PUID:PGID on start) |
The app runs as a non-root user (root is only used at start to fix /data ownership) and has a built-in health check (/health).
For access from the internet, put it behind a reverse proxy with HTTPS.
| Engine | Data | Setup |
|---|---|---|
| average position, impressions, clicks | Google Cloud service account with Search Console API enabled, added as user to your Search Console property, then paste its JSON key into Settings | |
| Bing | average position, impressions, clicks | Bing Webmaster Tools → Settings → API access → key into Settings |
| DuckDuckGo | exact rank | none |
| Mojeek | exact rank | none |
| Brave | exact rank | API key from api-dashboard.search.brave.com (monthly free credit, then paid) |
Google ranks are taken from Search Console because Google cannot be queried reliably without a paid SERP service. Search Console only lists queries your site already had impressions for, and its data lags about two days.
DuckDuckGo and Mojeek are read from their public result pages. The tracker waits randomly between requests (configurable). Keep volumes moderate.
GET /api/projects projects, keywords, summary
GET /api/projects/<id>/latest latest result per keyword and engine
GET /api/projects/<id>/results?days=30 history
POST /api/projects/<id>/run start a check
| Tag | Meaning |
|---|---|
latest | most recent build |
YYYYMMDD-HHMM | dated build. Only the 6 most recent are kept. |
Images are rebuilt regularly on the latest python:3.12-slim base for security
updates. Pin a dated tag if you need reproducible deployments, and update it
within a few rebuilds before it is removed.
MIT
Content type
Image
Digest
sha256:52d997ffb…
Size
50.9 MB
Last updated
5 days ago
docker pull usernahme/rank-tracker