核心功能
google-search 是一个双引擎搜索工具，集成 Gemini Search Grounding（主引擎）与 Google Custom Search JSON API（备用引擎），提供三种输出模式：
- search 模式（推荐）：使用 Gemini 2.5 Flash 生成带编号引用的综合答案，适合问答、时事查询及希伯来语内容，输出包含置信度评分与溯源链接
- raw 模式：返回原始搜索结果的标题、链接与摘要片段，适用于研究、参考文献整理及需要实际 URL 的场景
- image 模式：专用图片搜索，返回图片 URL 与标题
显著优势
1. 智能摘要与引用：Grounding 技术自动生成结构化答案，减少人工筛选结果的时间
2. 希伯来语深度优化：默认语言设为希伯来语（he），对希伯来语查询的语义理解优于通用搜索工具
3. 双引擎冗余设计：Gemini API 与 Custom Search API 互补，配额耗尽时可自动降级
4. 灵活输出格式：支持人类可读的文本输出与机器友好的 JSON 格式，便于集成工作流
5. 健壮的错误处理：含 429 限流自动重试、30 秒超时保护、清晰的错误提示
局限性与注意事项
- API 配额限制：Custom Search JSON API 免费版仅 100 次/天，Gemini API 免费版约 15 RPM，高频场景需付费升级
- 配置复杂度：需同时配置
GOOGLE_API_KEY与GOOGLE_CSE_CX（用于 raw/image 模式），并在 Google Cloud Console 启用多项服务 - 地域默认值：默认国家码为以色列（IL），非希伯来语/以色列用户需显式覆盖
--country参数 - 环境依赖：需安装
google-genaiPython 包，不适用于纯离线环境
适用人群
- 需要带引用来源的智能搜索答案，而非原始链接列表的用户
- 希伯来语内容研究者或以色列地区用户
- 需要将搜索结果结构化集成到自动化工作流的开发者
- 对 Perplexity 内置搜索质量不满，寻求替代方案的用户
潜在风险
- API 密钥泄露：
GOOGLE_API_KEY需妥善保管，硬编码或日志泄露可能导致配额滥用 - 成本失控：Gemini Pro 与 Custom Search 付费层级若未设置预算警报，可能产生意外费用
- 结果偏差：Gemini Grounding 生成的摘要可能遗漏冷门观点或呈现过度自信的合成答案，关键决策仍需人工核验原始来源
- 服务可用性：Google API 服务条款变更或区域限制可能影响可用性