SuperAPI AI 工具集

google-immersive-product

通用与其它

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能用于把 Google Shopping 的商品结果展开为 Google Immersive Product 详情数据,通过 Frevana 接口获取商品详情、店铺报价及分页信息。

主要能力:接收 page_token(必填)和可选的 next_page_token,返回经过校验的 JSON 响应,包含 search_metadata、search_parameters、product_results 等字段;product_results 可能含 title、brand、rating、reviews、price_range、thumbnails、stores、stores_next_page_token、about_the_product、top_insights、ratings、reviews_images、user_reviews。每次成功运行都会把同一份 JSON 保存到本地文件,并原样输出到 stdout。

使用方式:需提供 page_token,它必须来自 Google Shopping 结果项的 immersive_product_page_token;next_page_token 仅用于店铺报价分页,须来自上一次响应中的 product_results.stores_next_page_token。运行前需在环境变量中设置 FREVANA_TOKEN,或使用 --token 覆盖;依赖 curl、bash、python3。基本命令:bash <skill-path>/scripts/search_google_immersive_product.sh --page-token "...";分页命令加 --next-page-token "...";可用 --output 指定保存路径。--page_token、--immersive-product-page-token 为 --page-token 的别名,--next_page_token 为 --next-page-token 的别名。

适用场景:已有 immersive_product_page_token 时查询商品详情、汇总店铺报价、翻取店铺下一页,或保存原始 JSON 供后续解析。

限制:page_token 是特定沉浸式商品的输入游标,不是通用搜索词;若用户只给商品名、搜索词或商品 URL,不应猜测 token,需先运行 Google Shopping 搜索技能获取 immersive_product_page_token。不要添加 engine、api_key、output、no_cache、async、zero_trace 等不支持的字段。缺少 curl 或 python3 时应停止并提示安装。不要回显 Bearer token。除非用户要求完整数据,否则应总结商品与店铺报价而非直接输出原始 JSON。