keyword-clusteringlisted

# Keyword clustering ## Goal A page plan, not a keyword dump: which keywords belong on the same page, which page each group deserves, in what order to build them, and where the site already ranks two of its own URLs for the same intent. ## Required inputs - A keyword list (paste, file, or the output of `keyword-brief`) — or a seed to expand first. - Country and language (default `us` / `en`; two-letter codes). - Optional: the user's domain, for the cannibalization check. ## Before spending - Call `citable_prices` (free) once per session. - Metrics cost $0.03 per batch of up to 20 keywords — 100 keywords is $0.15. Say the total before the first batch. - Rank checks are $0.012 each; ask before more than 5. - Failed calls are never charged. ## Tools - `citable_keyword_suggest(seed, country?, lang?, depth?, limit?)` — $0.005. Only if the user gave a seed instead of a list. - `citable_keyword_metrics(keywords, country?, lang?)` — $0.03 per call of 1–20 keywords: volume, CPC, competition, difficulty, intent. Always fill a batch; never call per keyword. - `citable_rank_check(keyword, domain, gl?, hl?, num?)` — $0.012. The domain's Google position and the URL that holds it. ## Workflow 1. Normalise the list: lowercase, trim, drop exact duplicates. If it came from a seed, keep `suggestions[]` with `matchesSeed: true` plus every `questions[]` item. 2. `citable_keyword_metrics` in batches of 20 until every keyword has numbers. Keywords with null metrics stay in the list marked