tavily-research

Generates cited research reports from web sources via the Tavily CLI.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/flemx/salesforce-langgraph-agent --skill tavily-research-flemx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tavily-research
Source: https://github.com/flemx/salesforce-langgraph-agent/tree/main/.agents/skills/tavily-research
Command: npx skills add https://github.com/flemx/salesforce-langgraph-agent --skill tavily-research-flemx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Quick web searches often fall short when you need comprehensive, multi-source analysis with verifiable citations. This Skill runs deep research tasks through the Tavily CLI, gathering sources, synthesizing findings, and producing a structured report grounded in real web content. ## Core Features & Use Cases - Deep Research Reports: Runs tvly research to gather and synthesize multiple web sources into a cited report, with selectable mini, pro, or auto models. - Flexible Output: Supports streaming progress, JSON output for agents, custom output schemas, and citation formats like numbered, MLA, APA, and Chicago. - Async Workflows: Start long-running research with --no-wait, then poll status and retrieve results by request ID. - Use Case: Ask for a comparison of AI agent frameworks, and the Skill runs a pro-model research job, streams progress, and saves a cited markdown report to a file. ## Quick Start Ask the agent to research a topic such as "competitive landscape of AI code assistants" and save the cited report to a file.

Frequently Asked Questions about tavily-research

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

FAQPage Schema
How do I run deep web research with citations from the command line?

Run `tvly research "your topic"` with the Tavily CLI to gather sources and generate a cited report. Add `--model pro` for comprehensive analysis, `--stream` for real-time progress, or `-o report.md` to save the output to a file.

When should I use Tavily research instead of Tavily search?

Use research for multi-source synthesis like comparisons, market reports, or literature reviews that take 30-120 seconds. Use `tvly search` for quick fact-finding and simple lookups where a full cited report is unnecessary.

What is the difference between Tavily research mini and pro models?

The mini model handles single-topic, targeted research in about 30 seconds, while pro handles comprehensive multi-angle analysis in 60-120 seconds. The auto model lets the API choose based on query complexity.

Can I get structured JSON output from Tavily research?

Yes, pass `--json` for structured output suitable for agents, or use `--output-schema` with a path to a JSON schema to constrain the report shape. You can also choose citation formats like numbered, MLA, APA, or Chicago.

How do I run long Tavily research tasks asynchronously?

Start with `tvly research "topic" --no-wait --json` to get a request_id immediately. Then check progress with `tvly research status <request_id>` and retrieve results with `tvly research poll <request_id> --json`.

What should I do if the tvly command is not found?

Install the Tavily CLI first with `curl -fsSL https://cli.tavily.com/install.sh | bash` and then run `tvly login` to authenticate. The Skill requires tvly on PATH and does not fall back to other tools.