Web Search 技能(Serper API 版本)
概述
此技能使用 Serper API 进行实时互联网搜索,基于 Google Search 结果。
- ✅ 国内可直接访问,无需梯子
- ✅ 免费额度:每月 2,500 次搜索
- ✅ 无需绑定信用卡
配置
1. 获取 API Key
- 访问 Serper 官网:https://serper.dev/
- 点击 "Get API Key" 或 "Sign Up"
- 使用邮箱注册(支持 GitHub/Google 快捷登录)
- 登录后在 API Keys 页面复制你的 API Key
2. 配置 API Key
编辑 web_search.py 文件,在顶部找到以下行:
SERPER_API_KEY = "替换成你的 Serper API_KEY"
将 替换成你的 Serper API_KEY 替换为你实际的 API Key。
3. 安装依赖
确保已安装 Python requests 库:
pip install requests
使用方法
直接调用
python web_search.py "搜索关键词"
python web_search.py "今日天气" 5
在 OpenClaw 中使用
对 OpenClaw 说:
- "搜索今天的新闻"
- "搜索 AI 最新发展"
- "搜索北京天气"
免费额度与限制
- 免费额度: 每月 2,500 次搜索
- 限流: 每秒 1 次请求(1 QPS)
- 适用场景: 实时新闻、天气、股票、金价、油价、技术文档等
技术细节
- API 端点:
https://google.serper.dev/search - 协议: RESTful API
- 数据清洗: 自动提取 title、snippet 和 link,避免 Token 浪费
故障排除
问题:返回 "请安装 requests 库"
解决: 运行 pip install requests
问题:返回 "网络错误"
解决: 检查网络连接,确认能访问外网
问题:返回 "未授权" 或 "API Key 无效"
解决: 检查 web_search.py 中的 API Key 是否正确填写
问题:搜索结果为空
解决: 尝试更换搜索关键词,或检查 API Key 额度是否用完