gpt-researcher

Automate web and local research to produce cited Markdown reports.

Updated Feb 27, 2025
One-click install
npx skills add https://github.com/zpovsic/My-GPTR --skill gpt-researcher-zpovsic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gpt-researcher
Source: https://github.com/zpovsic/My-GPTR/tree/main/.claude
Command: npx skills add https://github.com/zpovsic/My-GPTR --skill gpt-researcher-zpovsic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GPT Researcher automates web and local research to produce comprehensive, cited reports, reducing manual effort and bias in information gathering.

Core Features & Use Cases

  • Autonomous LLM-based research engine using a planner-executor-publisher pattern for fast, structured outputs
  • Supports web sources, local documents, MCP data sources, retrievers, embeddings, and image generation to enrich reports
  • Use Case: developers and researchers who need to understand, extend, debug, or integrate GPT Researcher into their workflows, APIs, or products
  • Example: quickly produce a research report with citations for a given topic, including embeddings-based similarity discovery and optional image assets

Quick Start

To get started, install the package, create a GPTResearcher instance with a task query, run await researcher.conduct_research(), then await researcher.write_report() to obtain a Markdown report.

Frequently Asked Questions about gpt-researcher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate web research to generate cited reports with an LLM agent?

Automated web research generates cited reports by using an LLM agent with a planner-executor-publisher pattern to produce structured Markdown. You instantiate a research agent with a query, execute the research task, and write the final cited report.

What is the planner-executor-publisher pattern in autonomous research agents?

The planner-executor-publisher pattern is an autonomous architecture where the agent plans research strategy, executes web and local data retrieval, and publishes a comprehensive cited report. This structure ensures fast, structured, and less biased information gathering.

Does GPT Researcher support local documents and MCP data sources for report generation?

Yes, autonomous research supports local documents and MCP data sources alongside web sources. The agent integrates these retrievers and embeddings to enrich the final research report, enabling comprehensive similarity discovery across mixed data environments.

Do I need a Python runtime and API keys to run autonomous web research?

Yes, autonomous web research requires a Python runtime with the specific research package installed. You also need access to an LLM provider, configured retrievers, valid API keys, and network access to gather information and generate cited reports.

How do I integrate a research agent API into my existing application workflow?

You integrate a research agent API by installing the package, creating a research instance with a task query, and calling the asynchronous research execution and report writing methods. This returns a Markdown report you can embed into your products.