keyword-researchlisted

# Keyword Research ## Mission Create a decision-ready keyword set, not a list of plausible phrases. Every recommended term must have provider evidence for the selected market and a clear intent or business role. ## Required inputs - Seed topic, product, service, or explicit keyword list. - Target country and language. - Optional: business priority, audience, funnel stage, competitor domains, volume threshold, and maximum number of terms. ## Workflow 1. Read .seo/project.md when available and inherit its domain, market, language, business priorities, and existing keyword lists. 2. If a direct Search Console connection is available for the user's own property, query `gsc.search_analytics` first with query/page dimensions and a bounded high row limit. Filter striking-distance positions (roughly 5–20) client-side, preserve the actual rows, and enrich those queries with Muapi metrics before broad discovery. 3. Normalize seed terms by trimming whitespace and removing exact duplicates. Preserve the original wording in the report. 4. For a small number of topics, call seo.keyword_research to obtain seed metrics and ideas. For an explicit list, prefer seo.keywords_search_volume or seo.keyword_overview rather than one call per term. 5. Expand promising seeds with seo.keywords_for_keywords and seo.related_keywords. Keep expansion depth and limits modest until the user approves a broad run. 6. Deduplicate case, punctuation, and obvious singular/pl