HUB
Sign inSign up

usernahme/rank-tracker

By usernahme

•Updated 5 days ago

Self-hosted SEO rank tracker: Google Search Console, Bing, DuckDuckGo, Mojeek, Brave. Web UI + API

Image
0

426

usernahme/rank-tracker repository overview

⁠Rank Tracker

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).

⁠Features

  • Any number of projects (domain + country + language + keywords)
  • Google and Bing: average position straight from Search Console / Bing Webmaster Tools. These are real data for your own site and cost nothing.
  • DuckDuckGo and Mojeek: exact rank at check time, no API key needed
  • Brave Search API: optional, uses your own key
  • History chart per keyword, ▲/▼ changes, top-10 count, average position
  • Daily schedule (multiple times possible), manual checks from the UI
  • Optional password protection, JSON API with token, CSV export
  • UI in English and German, dark and light theme

⁠Quick start

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.

⁠docker compose
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

⁠Configuration

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.

VariableDefaultDescription
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
TZEtc/UTCTime zone for scheduled checks
PORT8080Internal HTTP port
SECRET_KEYgeneratedSession key (auto-generated and persisted)
PUID / PGID1000User/group the app runs as. Ownership of /data is fixed automatically at start.
PathDescription
/dataSQLite 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.

⁠Search engines

EngineDataSetup
Googleaverage position, impressions, clicksGoogle Cloud service account with Search Console API enabled, added as user to your Search Console property, then paste its JSON key into Settings
Bingaverage position, impressions, clicksBing Webmaster Tools → Settings → API access → key into Settings
DuckDuckGoexact ranknone
Mojeekexact ranknone
Braveexact rankAPI 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.

⁠API

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

⁠Tags

TagMeaning
latestmost recent build
YYYYMMDD-HHMMdated 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.

⁠License

MIT

Tag summary

Content type

Image

Digest

sha256:52d997ffb…

Size

50.9 MB

Last updated

5 days ago

docker pull usernahme/rank-tracker