gpt-researcher

Run the GPT Researcher autonomous agent to generate comprehensive deep research reports. Requires LLM and Search API keys (e.g., OPENAI_API_KEY, TAVILY_API_KEY).

⭐2stars🔀0forks📁View on GitHub🕐Updated Nov 26, 2025⬇️1downloads

When & Why to Use This Skill

The GPT Researcher skill transforms Claude into a powerful autonomous research agent capable of performing deep-dive investigations across the web. By leveraging advanced LLMs and specialized search APIs like Tavily, it automates the tedious process of manual data collection, information synthesis, and report drafting. It is designed to produce comprehensive, objective, and structured research reports on any given topic, significantly reducing the time required for complex knowledge gathering.

Use Cases

  • Market Intelligence: Conduct exhaustive research on industry trends, competitor landscapes, and emerging market shifts to inform business strategy.
  • Academic & Technical Reviews: Automatically aggregate and summarize information from multiple online sources to create detailed literature reviews or technical backgrounders.
  • Content Foundation: Generate deep-dive reports and structured outlines that serve as a factual basis for long-form articles, whitepapers, or educational content.
  • Investment Due Diligence: Perform comprehensive background checks and data gathering on companies, technologies, or niche sectors to support financial decision-making.
namegpt-researcher
descriptionRun the GPT Researcher autonomous agent to generate comprehensive deep research reports. Requires LLM and Search API keys (e.g., OPENAI_API_KEY, TAVILY_API_KEY).

GPT Researcher Skill

This skill allows you to utilize the GPT Researcher Python package as an autonomous research agent.

Setup

  1. Dependencies: Requires gpt-researcher and its dependencies.

    pip install gpt-researcher python-dotenv
    
  2. Configuration: GPT Researcher needs API keys for an LLM (e.g., OpenAI) and a Search Provider (Tavily is recommended).

    # Prompt user for keys if not set (assuming OpenAI and Tavily)
    if [ -z "$OPENAI_API_KEY" ] || [ -z "$TAVILY_API_KEY" ]; then
        echo "GPT Researcher requires API keys."
        read -p "Enter your OpenAI API key: " OAI_KEY
        read -p "Enter your Tavily API key: " TAVILY_KEY
        echo "OPENAI_API_KEY=$OAI_KEY" >> .env
        echo "TAVILY_API_KEY=$TAVILY_KEY" >> .env
        if [ -f .gitignore ] && ! grep -q ".env" .gitignore; then echo ".env" >> .gitignore; fi
        echo "API keys saved to .env."
    fi
    

Usage

Use the scripts/run_research.py script to initiate a research task.

Command

python3 scripts/run_research.py --query "<query>" [--report-type <type>]

Parameters

  • --query (Required): The topic to research.
  • --report-type (Optional): Default research_report. Options include: research_report, resource_report, outline_report, deep_research_report.

Example

python3 scripts/run_research.py --query "The future of renewable energy sources" --report-type deep_research_report

Output

The script outputs the final report in Markdown format to stdout. The research process (which can take several minutes) is logged to stderr.