调用 Gemini 官方 API 实现实时网络搜索，输出带引证的可靠答案，代码规范安全。
说明：
## 核心用法
`google-web-search` 是一款基于 Google Gemini API 的实时搜索 Skill，通过调用 Gemini 的 `google_search` grounding 工具，为 AI 模型提供联网检索能力。用户可通过 Python API 传入查询文本，Skill 自动调用 Gemini API 并返回带引用来源的答案。
**典型调用方式：**
“`python
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 服务可用性，建议设计降级方案 |
会员专属
