SuperAPI AI 工具集

serpapi-core-workflow-a

办公与效率

查看项目

更新于 10-15 23:29

技能介绍

用途:把业务检索问题转成有界、可复现的 Google Search 请求,只归一化应用真正需要的结果区块,并保留溯源字段。

主要能力:使用 engine=google 与 q 发起查询,支持 location、hl、gl、device 等地区与设备参数,分页通常使用 start;organic_results、answer_box、knowledge_graph、related_questions、本地结果等区块依查询而定,属于可选内容。工作流要求先确认搜索元数据状态为 Success 或 Error 再解析区块,按 serpapi_pagination.next 或记录的 start 偏移继续翻页,且不超过页数预算。

使用方式:核心示例为 params = {"engine": "google", "q": "site:example.com release notes", "location": "Austin, Texas, United States", "hl": "en", "gl": "us", "safe": "active"},调用 client.search(params),状态非 Success 则报错,再从 organic_results 取 position、title、link 等字段。密钥由服务端网关提供 SERPAPI_KEY,禁止把密钥及带密钥 URL 写入输出、缓存键、日志、遥测、夹具与错误报告。

适用场景:实现搜索功能、SEO 数据获取等需要可控分页与来源追溯的检索任务。

限制:各结果区块随查询变化且可能缺失,需为缺省区块准备夹具;翻页无续接时应正常终止,不得臆造偏移;模式变更需隔离响应并离线重放;账号预算与页面上限需事先核对。