🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Tavily Research
πŸ¦€ ClawHub

Tavily Research

by @abigale-cyber

Conduct comprehensive AI-powered research with citations via the Tavily CLI. Use this skill when the user wants deep research, a detailed report, a compariso...

Versionv1.0.0
Downloads467
#research#legal
TERMINAL
clawhub install content-system-tavily-research

πŸ“– About This Skill

name: tavily-research description: | Conduct comprehensive AI-powered research with citations via the Tavily CLI. Use this skill when the user wants deep research, a detailed report, a comparison, market analysis, literature review, or says "research", "investigate", "analyze in depth", "compare X vs Y", "what does the market look like for", or needs multi-source synthesis with explicit citations. Returns a structured report grounded in web sources. Takes 30-120 seconds. For quick fact-finding, use tavily-search instead. allowed-tools: Bash(tvly *)

tavily research

AI-powered deep research that gathers sources, analyzes them, and produces a cited report. Takes 30-120 seconds.

Before running any command

If tvly is not found on PATH, install it first:

curl -fsSL https://cli.tavily.com/install.sh | bash && tvly login

Do not skip this step or fall back to other tools.

See tavily-cli for alternative install methods and auth options.

When to use

  • You need comprehensive, multi-source analysis
  • The user wants a comparison, market report, or literature review
  • Quick searches aren't enough β€” you need synthesis with citations
  • Step 5 in the workflow: search β†’ extract β†’ map β†’ crawl β†’ research

    • Quick start

    # Basic research (waits for completion)
tvly research "competitive landscape of AI code assistants"
    Pro model for comprehensive analysis
    
tvly research "electric vehicle market analysis" --model pro
    Stream results in real-time
    
tvly research "AI agent frameworks comparison" --stream
    Save report to file
    
tvly research "fintech trends 2025" --model pro -o fintech-report.md
    JSON output for agents
    
tvly research "quantum computing breakthroughs" --json

    Options

    | Option | Description | |--------|-------------| | --model | mini, pro, or auto (default) | | --stream | Stream results in real-time | | --no-wait | Return request_id immediately (async) | | --output-schema | Path to JSON schema for structured output | | --citation-format | numbered, mla, apa, chicago | | --poll-interval | Seconds between checks (default: 10) | | --timeout | Max wait seconds (default: 600) | | -o, --output | Save output to file | | --json | Structured JSON output |

    Model selection

    | Model | Use for | Speed | |-------|---------|-------| | mini | Single-topic, targeted research | ~30s | | pro | Comprehensive multi-angle analysis | ~60-120s | | auto | API chooses based on complexity | Varies |

    Rule of thumb: "What does X do?" β†’ mini. "X vs Y vs Z" or "best way to..." β†’ pro.

    Async workflow

    For long-running research, you can start and poll separately:

    # Start without waiting
tvly research "topic" --no-wait --json    # returns request_id
    Check status
    
tvly research status  --json
    Wait for completion
    
tvly research poll  --json -o result.json

    Tips

  • Research takes 30-120 seconds β€” use --stream to see progress in real-time.
  • Use --model pro for complex comparisons or multi-faceted topics.
  • Use --output-schema to get structured JSON output matching a custom schema.
  • For quick facts, use tvly search instead β€” research is for deep synthesis.
  • Read from stdin: echo "query" | tvly research - --json

    • See also

  • tavily-search β€” quick web search for simple lookups
  • tavily-crawl β€” bulk extract from a site for your own analysis

    • ⚑ When to Use

    TriggerAction
    - The user wants a comparison, market report, or literature review
    - Quick searches aren't enough β€” you need synthesis with citations
    - Step 5 in the [workflow](../tavily-cli/SKILL.md): search β†’ extract β†’ map β†’ crawl β†’ **research**

    πŸ’‘ Examples

    # Basic research (waits for completion)
tvly research "competitive landscape of AI code assistants"
    Pro model for comprehensive analysis
    
tvly research "electric vehicle market analysis" --model pro
    Stream results in real-time
    
tvly research "AI agent frameworks comparison" --stream
    Save report to file
    
tvly research "fintech trends 2025" --model pro -o fintech-report.md
    JSON output for agents
    
tvly research "quantum computing breakthroughs" --json

    βš™οΈ Configuration

    | Option | Description | |--------|-------------| | --model | mini, pro, or auto (default) | | --stream | Stream results in real-time | | --no-wait | Return request_id immediately (async) | | --output-schema | Path to JSON schema for structured output | | --citation-format | numbered, mla, apa, chicago | | --poll-interval | Seconds between checks (default: 10) | | --timeout | Max wait seconds (default: 600) | | -o, --output | Save output to file | | --json | Structured JSON output |

    πŸ“‹ Tips & Best Practices

  • Research takes 30-120 seconds β€” use --stream to see progress in real-time.
  • Use --model pro for complex comparisons or multi-faceted topics.
  • Use --output-schema to get structured JSON output matching a custom schema.
  • For quick facts, use tvly search instead β€” research is for deep synthesis.
  • Read from stdin: echo "query" | tvly research - --json