用途:本技能用于在项目中安装官方 SerpAPI 客户端、在服务端配置私有密钥,并通过免费的 Account API 验证账户访问是否正常,避免泄露凭证。
主要能力:
- 检查运行时、包管理器、已有 SerpAPI 包、.gitignore、密钥加载约定与部署环境;
- 根据官方文档固定客户端版本后安装;
- 将私有密钥以 SERPAPI_KEY 形式存入服务端密钥管理;
- 通过 Account API 验证访问并仅保留非敏感字段(账户状态、方案名、剩余搜索数、每小时吞吐);
- 处理 401、403、429 及包冲突等错误。
使用方式:官方包为 Python 的 serpapi 与 JavaScript 的 serpapi。经批准后可用 python3 -m pip install serpapi 或 npm install serpapi 安装。仅将变量名和脱敏示例写入受版本控制的文件。验证示例:import os; import serpapi; client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=10); account = client.account(),再打印 account_status、plan_name、plan_searches_left、account_rate_limit_per_hour 等非敏感字段。
适用场景:需要接入 SerpAPI 搜索或 Account API 的新项目初始化与鉴权配置。
限制:密钥必须保存在服务端,禁止提交、暴露给浏览器代码、打印或写入测试夹具,也不要持久化含密钥的命令历史。除非当前账户文档确认,否则不要假设存在 OAuth、作用域或多个独立密钥。仅当操作者明确接受可能消耗额度时才执行真实搜索。Account API 不占用每月搜索额度。收费、价格与具体响应字段等资料未完整提供。