# Gemini Search

> 使用 Gemini 3.5 Flash 的 Google Search grounding 进行联网搜索问答。当需要实时信息、最新新闻、最新文档/版本号、价格行情，或任何超出知识截止日期的内容时使用。Real-time web search with citations via Gemini 3.5 Flash. Use for current events, latest docs, news, or anything beyond the knowledge cutoff.

- Skill: `comet966/gemini-search` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add comet966/gemini-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/comet966/gemini-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Comet966 (https://skillmd.com/u/comet966)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/comet966/gemini-search

---


# gemini-search

调用 Gemini 3.5 Flash 的联网搜索（Google Search grounding），返回带引用来源的归纳回答。零第三方依赖，仅需 Python 3。

## 使用方法

1. 把需求整理成一个**清晰、具体、自包含**的问题（包含必要的上下文，如年份、版本、地区），不要用碎片关键词。
2. 运行本 skill 目录下的脚本（`<skill目录>` 即本 SKILL.md 所在目录）：

```bash
python3 <skill目录>/scripts/gemini_search.py "你的问题"
```

3. 输出结构：回答正文 → `--- 来源 ---` 编号列表（标题+URL）→ `--- 实际搜索词 ---`（如有）。向用户转述结论时，**保留关键来源链接**。

## 可选参数

- `--model MODEL`：覆盖默认模型（默认 `gemini-3.5-flash`）
- `--style gemini|openai|auto`：API 接口格式（默认 auto，自动探测）
- `--raw`：打印原始 JSON，排查兼容性问题时使用

## 出错处理

- 提示 `[配置缺失]`：把报错中的配置步骤转告用户（创建 `~/.config/gemini-search/.env`，填入 `GEMINI_SEARCH_BASE_URL` 和 `GEMINI_SEARCH_API_KEY`），不要替用户编造 key。详见本目录 README.md。
- 提示 `[鉴权失败]`：让用户检查 key 及模型权限。
- 输出末尾建议固定 `GEMINI_SEARCH_API_STYLE=openai`：可转告用户写入配置以加速后续调用。