Deep research on a topic using Gemini Deep Research. Use when needing comprehensive multi-source analysis.
Use Gemini Deep Research for comprehensive multi-source research via browser automation.
/research [topic]
| Scenario | Tool |
|---|---|
| Need 10+ sources, comprehensive analysis | Deep Research |
| Quick lookup, 2-3 sources enough | WebSearch |
| Willing to wait 5-20 minutes | Deep Research |
| Need real-time info | WebSearch |
Structure your research prompts using CODO for best results:
| Element | Description | Example |
|---|---|---|
| Context | Define persona & scenario | "You are a market analyst researching..." |
| Objective | Specific questions (not open-ended) | "What are the top 5 competitors by revenue?" |
| Depth | Source hierarchy & constraints | "Prioritize 2024-2025 data, peer-reviewed sources" |
| Output | Format & structure | "Provide a comparison table with citations" |
cd "skills/Research"
python3 gemini-web-research.py "AI agents market landscape 2026"
python3 gemini-web-research.py "topic competitors" \
-o ~/Documents/Obsidian\ Vault/Vault/2\ -\ Projects/Research/2026-01-16-topic-competitors.md
| Flag | Description | Default |
|---|---|---|
-o, --output | Output file path | Auto-generated in Research folder |
--timeout | Max wait time (minutes) | 20 |
--model | pro or fast | pro |
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
--remote-debugging-port=9222 \
--user-data-dir="$HOME/chrome-automation-profile" \
--no-first-run &
Open chrome://version in that browser, sign in with your Google account.
Navigate to gemini.google.com and confirm you can access Deep Research.
cd "skills/Research"
pip3 install -r requirements.txt
Default: Vault/2 - Projects/Research/{YYYY-MM-DD}-{topic-slug}.md
Gemini supports up to 3 parallel Deep Research sessions.
Only if browser automation fails:
source ~/Documents/Obsidian\ Vault/Dev/Ops/.env # needs GOOGLE_API_KEY
python3 run-deep-research.py "topic"
| Issue | Solution |
|---|---|
| Chrome not found | Ensure Chrome is at standard macOS path |
| Port 9222 in use | lsof -i :9222 to check, kill stale process |
| Not logged in | Open Chrome automation profile, login to Google |
| Timeout | Increase --timeout, or check Gemini quota |
Skill added: 2026-01-16