核心用法
google-web-search 是一款基于 Google Gemini API 的实时搜索 Skill，通过调用 Gemini 的 google_search grounding 工具，为 AI 模型提供联网检索能力。用户可通过 Python API 传入查询文本，Skill 自动调用 Gemini API 并返回带引用来源的答案。
典型调用方式：
from skills.google-web-search.scripts.example import get_grounded_response
response = get_grounded_response("最新市场趋势", model="gemini-2.5-flash-lite")环境变量配置：
GEMINI_API_KEY（必需）：Google AI Studio API 密钥GEMINI_MODEL（可选）：默认gemini-2.5-flash-lite，支持gemini-3-flash-preview、gemini-3-pro-preview等
---
显著优点
1. 官方 API 背书：直接调用 Google 官方 Gemini API，非第三方代理或爬虫，数据合规且稳定性高
2. 引证可靠：返回结果自带可验证引用来源，适合需要事实核查的场景
3. 模型灵活：支持多版本 Gemini 模型，可按需选择速度优先或能力优先
4. 代码极简：仅 78 行 Python，依赖仅 2 个官方库，维护成本低
5. 隐私友好：仅读取必要环境变量，不收集用户额外信息，符合 GDPR/CCPA
---
潜在缺点与局限性
1. 功能单一：仅支持 Gemini grounding 搜索，无多搜索引擎切换、无结果后处理（如去重、摘要优化）
2. 输入无验证：当前代码直接将用户输入透传给 API，缺乏长度/格式校验，存在异常输入风险
3. 无容错机制：未实现超时、重试、降级策略，网络波动时可能长时间阻塞或失败
4. 成本敏感：Gemini API 按 token 计费，高频调用需注意用量控制
5. 地域限制：依赖 Google AI Studio 服务可用性，部分地区可能受限
---
适合人群
- 需要为 AI Agent 快速添加实时信息检索能力的开发者
- 对答案可溯源性有要求的企业知识库、研究分析场景
- 已使用 Gemini 生态，希望标准化搜索 grounding 流程的技术团队
- 追求极简部署、不愿维护复杂爬虫基础设施的个人开发者
---
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| API 密钥泄露 | 中 | 需妥善保管 `GEMINI_API_KEY`，避免硬编码或日志泄露 |
| 搜索偏见 | 低 | Gemini 搜索结果可能受 Google 排序算法影响，关键决策需交叉验证 |
| 成本超支 | 中 | 高频调用可能导致意外账单，建议设置配额告警 |
| 网络依赖 | 低 | 完全依赖 Google 服务可用性，建议设计降级方案 |