# 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). Use when this capability is needed.

- Skill: `tomevault-io/gpt-researcher-5` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/gpt-researcher-5`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/gpt-researcher-5/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/gpt-researcher-5

---


# 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.

    ```bash
    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).

    ```bash
    # 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

```bash
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

```bash
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.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/closedloop-technologies) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->