mcpField
D
deep-research

deep-research

github.com/sanjay3290Productivity447659 installsUpdated 7w ago
Repository

About deep-research

deep-research is a Gemini-powered skill for autonomous research that plans, searches, reads, and synthesizes findings into reports. It supports progress monitoring, follow-up research, and Markdown, JSON, or raw output.

Key features

  1. 01Autonomous research and report synthesis
  2. 02Real-time progress streaming and status checks
  3. 03Continue research with follow-up queries
  4. 04Markdown, JSON, and raw output

Use cases

  1. 01Market and competitor analysis
  2. 02Technical literature reviews
  3. 03Due diligence research
  4. 04Comparisons of frameworks or products

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sanjay3290/ai-skills --skill deep-research

After installing, type/deep-researchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.env.example
.gitignore
README.md
requirements.txt
scripts/
research.py

Details

From the project README

Gemini Deep Research Skill

Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports.

Requirements

  • Python 3.8+
  • httpx: pip install -r requirements.txt
  • GEMINI_API_KEY environment variable

Setup

  1. Get a Gemini API key from Google AI Studio
  2. Set the environment variable: 
    export GEMINI_API_KEY=your-api-key-here
    Or create a .env file in the skill directory.

Usage

Start a research task
python3 scripts/research.py --query "Research the history of Kubernetes"
With structured output format
python3 scripts/research.py --query "Compare Python web frameworks" \
  --format "1. Executive Summary\n2. Comparison Table\n3. Recommendations"
Stream progress in real-time
python3 scripts/research.py --query "Analyze EV battery market" --stream
Start without waiting
python3 scripts/research.py --query "Research topic" --no-wait
Check status of running research
python3 scripts/research.py --status <interaction_id>
Wait for completion
python3 scripts/research.py --wait <interaction_id>
Continue from previous research
python3 scripts/research.py --query "Elaborate on point 2" --continue <interaction_id>
List recent research
python3 scripts/research.py --list

Output Formats

  • Default: Human-readable markdown report
  • JSON (--json): Structured data for programmatic use
  • Raw (--raw): Unprocessed API response

Cost & Time

MetricValue
Time2-10 minutes per task
Cost$2-5 per task (varies by complexity)
Token usage~250k-900k input, ~60k-80k output

Best Use Cases

  • Market analysis and competitive landscaping
  • Technical literature reviews
  • Due diligence research
  • Historical research and timelines
  • Comparative analysis (frameworks, products, technologies)

Workflow

  1. User requests research → Run --query "..."
  2. Inform user of estimated time (2-10 minutes)
  3. Monitor with --stream or poll with --status
  4. Return formatted results
  5. Use --continue for follow-up questions

Exit Codes

  • 0: Success
  • 1: Error (API error, config issue, timeout)
  • 130: Cancelled by user (Ctrl+C)

Comments

Markdown supported