用途:把第一方 GSC 查询措辞转成一组边界明确的提示词,供后续人工或自动化监测使用。每条来源查询保留其点击、展示、CTR 和平均排名,确定性模板生成稳定的提示词建议,输出可用于设计监测语料。
主要能力:提供可复现的提示词种子集,支持品牌词处理(brandTerms 或 includeBrand:true),并通过 dataStatus 区分 empty、filtered、partial、available 状态。
使用方式:先调用 seo_list_reports(category 为 ai-search),再 seo_describe_report(id 为 to-ai-query),最后 seo_run_report,参数包含 site、days 或 startDate/endDate、limit、minImpressions、maxRows。CLI 等价命令:seo reports describe to-ai-query --json;seo reports run to-ai-query --params '{"site":"sc-domain:example.com","days":90,"limit":20,"minImpressions":100,"maxRows":10000}' --json。site 必填;days 与显式日期二选一。maxRows 限制来源抓取,limit 限制返回查询数。
限制:这不是任何人真的向 AI 产品输入这些提示词的证据,也不代表回答中提及了该站点,更不代表该查询具备等价的 AI 需求。methodology.observedAiPromptData 与 estimatedTrafficLift 明确为 false。每个条目的 evidenceScope 为 retained-gsc-query,提示词仅继承这一狭窄范围。安全做法是选取代表性提示词变体、把来源查询与日期范围随观察结果一同保存,并按受控计划刷新语料;不得把生成的提示词数量当作 AI 需求,不得用猜测流量填补缺失提示词,也不得在来源不完整或过滤移除候选时把无返回行解读为一切正常。需要保留 dateRange、source.possiblyTruncated、filters、selection.invalidRows、selection.conflictingRows、limited rows、warnings 和 caveats。