krankie-rankings

Installation
SKILL.md

ASO Rankings Check (krankie)

Pull keyword rankings with krankie instead of Astro MCP, compare against the previous check, and save a dated rankings file to the Obsidian vault.

This is the no-subscription replacement for asc-aso-rankings. krankie is MIT-licensed, stores history in local SQLite, and reads ranks from the public App Store search API. The trade-off vs Astro: krankie reports rank position only - no popularity or difficulty scores, and tracks the top 200 (Astro tracked top 250).

Architecture: VPS is the source of truth

  • VPS (lobster@openclawtail) runs krankie under a daily cron (krankie cron), so the SQLite DB there holds the continuous day-over-day history. This is canonical.
  • MacBook also has krankie installed for ad-hoc local peeks, but its DB only has data from whenever it was last run - do not use it for the historical comparison.
  • The vault is bidirectionally synced between the VPS (/home/lobster/vault) and the MacBook (/Users/antonnovoselov/Documents/Vault), so a report written on either side appears on both.

Because the VPS holds the history and the previous_rank/rank_change columns krankie computes between checks, run the check + report on the VPS.

Tracked set (the documented strategy)

Track the 41 canonical keywords from the ASO strategy (see app-store-keywords.md change log) plus the brand term vivadicta, for the app 6758147238, on stores us, gb, ca, au. The same 41 keywords are tracked for 3 competitors on us only:

Installs
1
Repository
n0an/vivadicta
GitHub Stars
112
First Seen
Sep 11, 2026