daily-seo-rank-tracker

Track Google keyword rankings daily, detect position changes, and save Markdown + CSV reports.

Install

git clone https://github.com/NickCirv/daily-seo-rank-tracker.git
cd daily-seo-rank-tracker
npm install

Requires an Apify API token:

export APIFY_TOKEN=your_token_here

Usage

node src/index.js --domain example.com --keywords "seo audit tool,rank tracker" --country us

# Multi-keyword with UK locale
node src/index.js --domain mysite.co.uk --keywords "wordpress plugin,schema markup,seo checker" --country gb

Flag	Description
--domain	Domain to track (e.g. example.com)
--keywords	Comma-separated keyword list
--country	Google country code (default: us)

What it does

Calls the Apify Google Search Scraper for each keyword and finds your domain's position in the top 100 organic results. On each run it compares against the previous day's data and flags any keyword that moved 3 or more positions. Results are saved to reports/<domain>-<date>.md and reports/<domain>-<date>.csv, with history stored in data/<domain>_history.json (90-day rolling window).

Run it daily via cron or a scheduler (e.g. render.yaml is included for Render deploys).

---

_{Node ≥18 · MIT · by NickCirv}