用途:调用 Google 搜索 AI 模式,针对一个关键词抓取其 AI 概览(AI Overview)答案,返回带来源引用链接的 Markdown 文档,可用于深度调研、技术问答、长尾选品分析和海外消费者偏好研究。
主要能力:keyword 为必填,作为 q= 参数发送至 Google AI Mode;返回 stdout(Markdown 概览及内联引用)、sourceUrl(实际请求的 AI Mode 搜索 URL)、resultsNum(渲染出的 AI 概览块数量,0 表示该关键词未触发概览)、code/errcode(200 为成功)、msg/errmsg、costTime、costToken、taskId、type(固定 stdoutWorkbenches)。
用法:每次调用只处理一个问题,无多轮追问参数。追问时 agent 须先总结上一轮概览要点与引用,再与新问题拼接为新的 keyword 重新调用。可运行 scripts/google_ai_search.py 直接测试;响应过大时可用 python scripts/response_io.py run --script scripts/google_ai_search.py --out-dir <DIR> '<params>' 落盘,再用 read 字段投影。查询建议前置市场/地区信息,语言匹配目标市场(美国英语、日本日语、德国德语等),用自然语言提问更易获得丰富概览。
展示规则:直接渲染 Markdown 并保留引用链接;resultsNum 为 0 时告知未触发概览并建议改写或换地区;不要将结果转发到数据分析沙箱;结果反映调用时的实时抓取。
限制:输出为非结构化 Markdown,不支持结构化表或二次数据查询;部分关键词不触发 AI 概览;仅单轮;locale 跟随 Google 默认,无显式地区切换;同一关键词实时结果可能波动;不适用于内部结构化数据查询、Amazon ABA 分析、特定平台结构化商品抓取、纯原始网页搜索及图像生成识别等场景。收费、价格等信息暂未提供。