用途：诊断 SerpAPI 调用失败，先判定失败发生在哪一层，再决定修复还是重试，避免盲目重试掩盖配置或配额问题。
主要能力：区分传输、账户、搜索、引擎和应用层的错误；识别常见 HTTP 状态：400 请求无效、401 认证失败、403 账户被禁、404 资源缺失、410 归档搜索过期、429 小时吞吐或搜索配额耗尽、500/503 服务器故障。搜索状态可为 Queued、Processing、Success、Error，其中 Success 也可能包含空结果，应按数据而非错误处理，并检查引擎特有的 _state 字段。
使用方式：需准备 HTTP 状态、安全错误文本、引擎、规范化参数、客户端版本与时间戳，以及响应生成时的 search ID 和 search_metadata.status；任何在线复现需账户所有者授权。用 Read、Glob、Grep 追踪请求构造与解析，用 WebFetch 核对当前错误语义，用 Write 或 Edit 保存修复与脱敏证据，Bash(python3:*) 仅限经批准的诊断。处理原则：400 对照对应引擎文档本地修正参数，不原样重试；401/403 停止并修复账户访问；429 通过 Account API 区分吞吐与额度；超时和 500/503 仅在小重试预算内以指数退避、抖动和幂等处理重试；410 仅在获批后重跑。须保持 SERPAPI_KEY 不出现在异常和请求 URL 中，仅分享脱敏元数据或 search ID。最后添加脱敏回归夹具，记录分类、修复、重试次数与最终状态。
适用场景：搜索失败、卡住或返回异常结果时的排障与恢复决策。
限制：具体客户端版本、引擎参数细节和配额数值资料未提供。