SuperAPI AI 工具集

ecommerce-google-ai-mode-search

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:调用 Google 搜索 AI Mode(搜索结果顶部的 AI Overview 面板),针对单个关键词返回 AI 综合摘要及来源引用链接,适合深度调研、技术问答、长尾关键词探索、海外消费者偏好与选品方向的网络信息汇总。

主要能力:每个关键词返回一份 Markdown 文档(含标题、要点与内联引用链接);resultsNum 表示渲染出的 AI Overview 块数,为 0 说明该关键词未触发 AI Overview。响应字段还包括 sourceUrl、code/errcode、msg/errmsg、costTime、costToken、taskId、type。

使用方式:设置环境变量 NEXSCOPE_API_KEY;接口为 POST /aiMode/googleSearch(详见 references/api.md),脚本调用为 python scripts/google_ai_search.py '<JSON params>' [--inline]。唯一必填参数是 keyword。默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-ai-mode-google-search-<timestamp>.json;响应 ≤8 KB 时保存后完整打印 JSON,>8 KB 时仅打印摘要,--inline 可强制完整输出。读取时先用摘要判断是否够用,再按需用 jq 或 ConvertFrom-Json 提取字段。

注意事项:仅支持单轮,单次调用只处理一个问题,没有多轮追问参数;需追问时由智能体自行总结上一轮答案并与新问题拼接成新的 keyword 再发起调用。输出为非结构化 Markdown,不应转入数据分析沙箱处理。该工具消耗额度,同一会话+参数默认只调用一次,脚本含 24 小时本地缓存;不要通过改关键词、翻页或切换地区码自动重试失败或空结果,确需再次检索应先告知用户额外成本。鉴权失败(401/402)或余额不足时可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 API Key 或充值。

限制:AI Overview 不保证触发,小众、歧义或敏感关键词可能返回 resultsNum = 0;地区跟随 Google 默认,无显式区域切换,需通过关键词语言与措辞匹配目标市场;实时抓取,同一关键词不同时间结果可能不同;输出为文本,不支持结构化表格或二次数据查询。