- name
- gemini-deep-research
- description
- Perform complex, long-running research tasks using Gemini Deep Research Agent. Use when asked to research topics requiring multi-source synthesis, competitive analysis, market research, or comprehensive technical investigations that benefit from systematic web search and analysis.
- metadata
- {"clawdbot":{"emoji":"🔬","requires":{"env":["GEMINI_API_KEY"]},"primaryEnv":"GEMINI_API_KEY"}}
Gemini Deep Research
Use Gemini's Deep Research Agent to perform complex, long-running context gathering and synthesis tasks.
Prerequisites
GEMINI_API_KEYenvironment variable (from Google AI Studio)- Note: This does NOT work with Antigravity OAuth tokens. Requires a direct Gemini API key.
How It Works
Deep Research is an agent that:
- Breaks down complex queries into sub-questions
- Searches the web systematically
- Synthesizes findings into comprehensive reports
- Provides streaming progress updates
Usage
Basic Research
scripts/deep_research.py --query "Research the history of Google TPUs"Custom Output Format
scripts/deep_research.py --query "Research the competitive landscape of EV batteries" \
--format "1. Executive Summary\
2. Key Players (include data table)\
3. Supply Chain Risks"With File Search (optional)
scripts/deep_research.py --query "Compare our 2025 fiscal year report against current public web news" \
--file-search-store "fileSearchStores/my-store-name"Stream Progress
scripts/deep_research.py --query "Your research topic" --streamOutput
The script saves results to timestamped files:
deep-research-YYYY-MM-DD-HH-MM-SS.md- Final report in markdowndeep-research-YYYY-MM-DD-HH-MM-SS.json- Full interaction metadata
API Details
- Endpoint:
https://generativelanguage.googleapis.com/v1beta/interactions - Agent:
deep-research-pro-preview-12-2025 - Auth:
x-goog-api-keyheader (NOT OAuth Bearer token)
Limitations
- Requires Gemini API key (get from Google AI Studio)
- Does NOT work with Antigravity OAuth authentication
- Long-running tasks (minutes to hours depending on complexity)
- May incur API costs depending on your quota