research

Installation
Summary

Comprehensive research on any topic with automatic source gathering, analysis, and citations.

  • Conducts multi-source web research with explicit citations, ideal for comparisons, current events, market analysis, and detailed reports
  • Offers three model options: mini for targeted single-topic research (~30s), pro for comprehensive multi-angle analysis (~60-120s), and auto for API-driven complexity detection
  • Authenticates via OAuth through Tavily MCP server with automatic browser-based login on first run, or supports API key configuration as an alternative
  • Accepts research input and optional model selection, with output saveable to file for report generation
SKILL.md

Research Skill

Conduct comprehensive research on any topic with automatic source gathering, analysis, and response generation with citations.

Authentication

The script uses OAuth via the Tavily MCP server. No manual setup required - on first run, it will:

  1. Check for existing tokens in ~/.mcp-auth/
  2. If none found, automatically open your browser for OAuth authentication

Note: You must have an existing Tavily account. The OAuth flow only supports login — account creation is not available through this flow. Sign up at tavily.com first if you don't have an account.

Alternative: API Key

If you prefer using an API key, get one at https://tavily.com and add to ~/.claude/settings.json:

{
  "env": {
    "TAVILY_API_KEY": "tvly-your-api-key-here"
  }
Related skills
Installs
6.6K
GitHub Stars
288
First Seen
Jan 25, 2026