Track your Amazon keyword rankings — for free

A self-hosted, open-source rank tracker. Point it at your ASINs and keywords, and GitHub Actions checks positions every day, commits the history, and renders a report. No servers, no fees.

Fork it on GitHub

✨ What it does

📈 Daily rank checks

Every day, the workflow queries Amazon search results for your target keywords and records where each ASIN lands — organic and sponsored.

🗂️ SQLite history

Each run upserts into a local SQLite database, preserving the first-seen date so you can watch momentum build over weeks.

📝 Markdown reports

A human-readable reports/latest.md is generated and committed, so the trend is visible right in the repo.

🔌 Powered by Pangolinfo

Uses the Pangolinfo MCP search_amazon tool — the same engine behind the official Pangolin-spg scrapers.

🚀 Quick start

# 1. Fork & clone the repo
git clone https://github.com/pangolinfoapi/amazon-keyword-rank-tracker
cd amazon-keyword-rank-tracker

# 2. Add your targets (ASINs + keywords)
cp targets.example.json targets.json
#   edit targets.json

# 3. Run locally with your Pangolinfo token
export PANGOLIN_TOKEN=eyJ...your_jwt
python3 rank_tracker.py run
python3 rank_tracker.py report

In GitHub, add a repository secret PANGOLIN_TOKEN and the daily workflow runs itself.