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).
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.
| name | gpt-researcher |
|---|---|
| description | 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). |
GPT Researcher Skill
This skill allows you to utilize the GPT Researcher Python package as an autonomous research agent.
Setup
Dependencies: Requires
gpt-researcherand its dependencies.pip install gpt-researcher python-dotenvConfiguration: 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): Defaultresearch_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.