Track your Amazon keywords for free (in 5 minutes)

A no-server, no-credit-card setup using the open-source amazon-keyword-rank-tracker and the Pangolinfo MCP.

💡 Why this matters: Knowing where you rank is the first step to growing organic Amazon sales. Most rank trackers cost money and lock your data in. This one is free and lives in your own GitHub repo.

1. Fork the repository

Head to github.com/pangolinfoapi/amazon-keyword-rank-tracker and click Fork. You now have your own copy.

2. Clone and configure targets

git clone https://github.com/YOUR_USER/amazon-keyword-rank-tracker
cd amazon-keyword-rank-tracker
cp targets.example.json targets.json

Edit targets.json to list the keywords you care about and the ASINs you want to monitor:

[
  {
    "label": "wireless earbuds",
    "marketplace_id": "ATVPDKIKX0DER",
    "keyword": "wireless earbuds",
    "asin": "B0XXXXXXXX"
  }
]

3. Get a Pangolinfo token

Sign up at pangolinfo.com, open the dashboard, and copy your API token. This token is what lets the tracker query Amazon search results through the Pangolinfo MCP.

🔒 Add it as a repository secret named PANGOLIN_TOKEN (Settings → Secrets and variables → Actions). Never commit it to the repo.

4. Run it locally first

export PANGOLIN_TOKEN=eyJ...your_jwt
python3 rank_tracker.py run
python3 rank_tracker.py report

You should see a reports/latest.md with today's rankings.

5. Let GitHub Actions do it daily

The repo ships with .github/workflows/track.yml, which runs every day, commits the new data, and refreshes the report. Once the secret is set, you're done — rankings update automatically.

Next steps

➡️ Open the repository