（5317期）google-search – 实时精准的智能搜索助手

实时精准的智能搜索助手 基于 Google Custom Search API 的实时网络搜索工具，通过环境变量安全管理凭证，为 Agent 提供可靠的实时信息检索能力。 使用说明 核心用法 google-search Skill 是一个轻量级的网络搜索工具，专为 OpenClaw Agent 设计，用于在需要实时信息、文档查询或研究场景时执行 Google 搜索。用户需先在 Google Cloud Console 创建项目并启用 Custom Search API，获取 API Key 和 Search Engine ID (CX)，通过环境变量 GOOGLEAPIKEY 和 GOOGLECSEID 配置凭证后即可使用。核心脚本 search.py 接收搜索关键词，向 Google Custom Search API 发送 GET 请求，返回结构化的 JSON 搜索结果，支持自定义返回结果数量（默认 5 条）。 显著优点 该 Skill 的最大优势在于其简洁性和安全性设计。代码结构清晰，仅依赖 Python 标准库和 requests，无冗余功能。安全方面，敏感凭证完全通过环境变量管理，避免了硬编码风险；网络请求固定指向 Google 官方 API 端点，无 SSRF 漏洞；无任何文件操作、子进程执行或动态代码执行等危险操作。此外，作为 Google 官方 API 的封装，搜索结果质量有保障，响应速度快，适合需要权威实时信息的场景。 潜在缺点与局限性 首先，该 Skill 依赖外部 API 服务，用户需自行申请 Google Cloud 账号并配置 API，存在一定的使用门槛。其次，Google Custom Search API 有免费配额限制（每日 100 次查询），高频使用可能产生费用。功能层面，脚本较为基础，缺少输入参数的范围校验（如 num_results 未限制上限）、HTTP 请求超时设置以及详细的错误日志输出，在异常场景下的用户体验有待提升。此外，搜索查询内容会发送至 Google 服务器，对隐私敏感场景需谨慎。 适合的目标群体 该 Skill 适合需要为 AI Agent 集成实时网络搜索能力的开发者、研究人员和内容创作者。具体包括：构建知识问答系统的工程师、需要实时验证信息的科研工作者、以及开发自动化研究工具的产品团队。对于已在使用 Google Cloud 生态或愿意配置 API 凭证的技术用户尤为合适。 使用风险 主要风险集中在 API 凭证管理和外部依赖两方面。用户需妥善保管 .env 文件，避免意外提交至版本控制导致密钥泄露。网络层面，虽然请求目标固定安全，但缺乏超时机制可能导致请求挂起。此外，Google API 的服务可用性和定价策略变化会直接影响 Skill 的稳定性，建议生产环境监控 API 配额使用情况并做好降级方案。 原始说明 Search the web using Google Custom Search Engine (PSE). Use this when you need live information, documentation, or to research topics and the built-in web_search is unavailable.