rank-trackinglisted

# Rank tracking ## Goal A rank tracker with no dashboard and no account: a keyword list in the repo, a history file next to it, one paid check per keyword per run, and a diff that says what moved. The agent is the tracker; the wallet pays per run; the history lives with the site it describes. ## Required inputs - The domain to track. - A keyword list — a file (`citable/keywords.txt`, one per line) or pasted. Ask for the market: country and language — `gl`/`hl` on `rank_check`, `country`/`lang` on `domain_history` and `domain_keywords` (default `us`/`en`). - How often: on demand, or a schedule (daily / weekly). Never assume a schedule. ## Before spending - `citable_prices` (free) once per session. - A run costs $0.012 × keywords. Say the total before the first run ("20 keywords → $0.24 per run, $7.20 a month daily"). Ask before more than 30 keywords per run. - For the whole domain's trend, `citable_domain_history` is $0.03 for up to 24 months — offer it first when the user has no keyword list yet. - Failed calls are never charged; a keyword that errors is retried on the next run, not now. ## Tools - `citable_rank_check(keyword, domain, gl?, hl?, num?)` — $0.012. `position` (null = outside the top `num`, default 20), the ranking `url`, and the top-10 list. - `citable_domain_history(domain, months?, country?, lang?)` — $0.03. Monthly keywords ranked, top-10 count, traffic, and new/up/down/lost counts, with a first-to-last trend. Monthly resolution, index-wide. - `citable