Example
Options
--domainHOST and--brandNAME required.--topicTOPIC changes the suggested prompt subject. Repeat--aliasTEXT and--promptQUESTION.--researchFILE cannot be combined with--prompt--limit1..500 defaults to 50.--competitorsFILE supplies a JSON array.--engineaccepts mock (default), chatgpt:web-own-browser, grok:web-own-browser, duck or google-aio.--localedefaults to en-US--countrydefaults to the locale suffix.--samples1..500 defaults to 10.--max-usdis greater than zero and at most 500, default 1.--outPANEL.json requires a new file.
Exit status
0 on success; 2 on invalid input or output failure.What happens
Uses mock by default. Suggestions are not measured search demand. Competitor target scopes share prompts with the brand supplied through--brand. Review prompts and explicitly select a supported live engine before measurement.
Existing output files are refused. Research input is a JSON array of text, intent_cluster, branded and provenance (source gsc|paa|autocomplete|manual, reference, observed_at).
These are user-supplied records, not demand verified by this command. Selection removes exact duplicate questions and rotates across supplied intent clusters.
Full command syntax
Full command syntax
Configuration and file contracts
Configuration and file contracts
Read configuration and file ownership for environment variables, compatibility aliases and writer locks. Read local file contracts for artifact fields. Browse the CLI index for related commands.
Check the selected environment and workspace access before calling hosted operations. See capability status.