Gemini 实时搜索·引证可溯

调用 Gemini 官方 API 实现实时网络搜索，输出带引证的可靠答案，代码规范安全。

基本信息

• 技能名称?Google Web Search
• 中文名称?Gemini 实时搜索·引证可溯
• 作者?theoseo
• 分类?专业技能
• 版本?1.0.3
• 标签?web-search, gemini, google-api, grounding, real-time-data, citation, official-api

使用方法

使用说明
核心用法
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

   潜在缺点与局限性

6. 功能单一 ：仅支持 Gemini grounding 搜索，无多搜索引擎切换、无结果后处理（如去重、摘要优化）
7. 输入无验证 ：当前代码直接将用户输入透传给 API，缺乏长度/格式校验，存在异常输入风险
8. 无容错机制 ：未实现超时、重试、降级策略，网络波动时可能长时间阻塞或失败
9. 成本敏感 ：Gemini API 按 token 计费，高频调用需注意用量控制

10. 地域限制 ：依赖 Google AI Studio 服务可用性，部分地区可能受限

    适合人群
    需要为 AI Agent 快速添加 实时信息检索 能力的开发者
    对 答案可溯源性 有要求的企业知识库、研究分析场景
    已使用 Gemini 生态，希望标准化搜索 grounding 流程的技术团队

    追求 极简部署 、不愿维护复杂爬虫基础设施的个人开发者

    常规风险
    | 风险类型 | 等级 | 说明 | |---------|------|------| | API 密钥泄露 | 中 | 需妥善保管 GEMINI_API_KEY，避免硬编码或日志泄露 | | 搜索偏见 | 低 | Gemini 搜索结果可能受 Google 排序算法影响，关键决策需交叉验证 | | 成本超支 | 中 | 高频调用可能导致意外账单，建议设置配额告警 | | 网络依赖 | 低 | 完全依赖 Google 服务可用性，建议设计降级方案 |