Keyword research

Input: $ARGUMENTS — the topic, niche, product or business to research, and a location if one was given. If that placeholder is empty or still literal, take the topic from what the user asked; if they named none, ask what topic and market before calling anything.

Steps

1. Resolve the market. If the user named a country, city or region, call location_suggest and use the returned locId. If they named nothing, ask once — or state the default you are using (US / en) so the numbers are not silently for the wrong market.

2. Pick 1–3 seed terms from the topic. Broad head terms, not sentences: "running shoes", not "where can I buy good running shoes online". google_suggestions fans out ~60 autocomplete queries per seed, so more seeds is not better.