Query clusters

Use this report to organise retained GSC query/page rows into stable lexical themes. It normalizes queries, removes low-actionability and optionally branded rows, aggregates page evidence, then groups related wording by shared tokens. This is useful for navigation, information architecture, and review queues because the same input produces the same grouping. Token overlap does not prove shared intent, justify a new page, or establish that current URLs compete with each other.

Run the report

Use the compact MCP flow:

1. Call seo_list_reports with {"category":"opportunities"}.
2. Call seo_describe_report with {"id":"query-cluster"}.
3. Call seo_run_report with {"id":"query-cluster","params":{"site":"sc-domain:example.com","scope":"/guides/","minImpressions":50,"limit":20,"includeBrand":false}}.

The CLI uses the same registry and report handler:

seo reports describe query-cluster --json
seo reports run query-cluster --params '{"site":"sc-domain:example.com","scope":"/guides/","minImpressions":50,"limit":20,"includeBrand":false}' --json