Gemini Deep Research

Run long-form research queries through Google's Gemini Deep Research via browser automation (Playwright CDP). Produces 40k+ char markdown reports with source citations.

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

Prerequisites

1. Chrome with debug port: Must be running with --remote-debugging-port=9222
2. Gemini Advanced subscription: Logged into gemini.google.com in the debug Chrome
3. playwright-core: bun add -g playwright-core (or project-local)
4. Runtime: Use npx tsx (not bun run) — Bun's CDP connectOverCDP times out; Node.js connects in <1s

Launch Chrome (if not running)

Use the shared port script from the chrome-profiles plugin (the SSoT for browser routes). It pins a separate profile, which Chrome 136+ requires for a debug port, and down closes exactly that port: