用途:将确定性的响应解析与实时搜索获取分离,使日常开发快速、私密且不消耗额度。
主要能力:使用 Read、Glob、Grep 定位客户端、解析器、固定样本与测试;用 WebFetch 复核引擎 schema;用 Write 或 Edit 编写适配器与样本;用 Bash(python3:) 或 Bash(npm:) 运行本地测试或经明确批准的录制器。
使用方式:先清点所消费字段并分类为必需、可选、引擎特定或派生;创建客户端接口,其 search 方法可由基于样本的假实现替换;对样本脱敏,删除含密钥的 URL、原始 HTML 链接、账户标识、敏感查询及无关结果;为正常、空成功、处理中、错误、缺失可选段和类型变化等情形添加样本;针对样本编写解析测试,断言归一化的应用输出而非完整厂商负载。实时录制须置于单独命令之后,并具备明确环境标志、额度检查与操作者批准。刷新时审查语义差异,更新检索日期与来源引擎,并重跑全部离线测试。
限制与注意:SerpAPI 响应分区随引擎、查询、地理位置、设备及上游搜索布局变化,代码应依赖窄的本地适配器,而非把某个抓取响应视为通用。离线测试不得要求 SERPAPI_KEY,密钥仅在单独调用的录制器中加载,拒绝哨兵值或缺失值,且不得序列化暴露密钥的请求 URL 或元数据字段。若离线测试发生实时调用,应判为失败并在网络边界替换客户端。