# Tavily Research > Investigación profunda con IA y citas mediante la CLI de Tavily; genera un informe estructurado desde fuentes web. Tarda 30-120s. Para hechos rápidos, usa tavily-search. Fuente: https://skillsagentes.com/skills/tavily-ai/skills/tavily-research Markdown: https://skillsagentes.com/skills/tavily-ai/skills/tavily-research.md Repositorio: https://github.com/tavily-ai/skills Autor: tavily-ai Licencia: MIT Actualizado: hace 5 meses Coste de contexto: 122 tok instalada, 893 tok al activarse, 893 tok con todos los archivos del bundle Bundle: 1 archivo, 3 KB Permisos que pide: bash(tvly *) ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add tavily-ai/skills --skill tavily-research --agent claude-code # Cursor npx -y skills add tavily-ai/skills --skill tavily-research --agent cursor # Codex npx -y skills add tavily-ai/skills --skill tavily-research --agent codex # Gemini CLI npx -y skills add tavily-ai/skills --skill tavily-research --agent gemini # Windsurf npx -y skills add tavily-ai/skills --skill tavily-research --agent windsurf # Cline npx -y skills add tavily-ai/skills --skill tavily-research --agent cline ``` ## Qué hace - Ejecuta investigaciones profundas con IA usando la CLI de Tavily (`tvly research`) - Genera un informe estructurado con citas a partir de múltiples fuentes web - Permite elegir modelo (`mini`, `pro`, `auto`), streaming, formato de citas y salida JSON - Soporta flujo asíncrono con `--no-wait`, `status` y `poll` para investigaciones largas ## Cuándo usarla - El usuario pide investigación profunda, un informe detallado, comparación o revisión de literatura - Se necesita análisis multi-fuente con citas explícitas, no solo una búsqueda rápida - El usuario dice 'research', 'investigate', 'analyze in depth' o 'compare X vs Y' ## Cuándo no - Para búsquedas rápidas de hechos, usar tavily-search en su lugar ## Qué la activa - "Investiga el panorama competitivo de los asistentes de código con IA" - "Compara los frameworks de agentes de IA disponibles en 2025" - "Hazme un informe de mercado sobre vehículos eléctricos usando el modelo pro" ## Antes de instalar - Requiere tener `tvly` instalado y autenticado (`curl -fsSL https://cli.tavily.com/install.sh | bash && tvly login`). - Necesita en el PATH: curl - makes network requests ## Archivos - SKILL.md — 3 KB ## SKILL.md Reproducido tal cual desde tavily-ai/skills bajo MIT. Esta sección es el documento original y está en inglés. # 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: ```bash 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](../tavily-cli/SKILL.md) 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](../tavily-cli/SKILL.md): search → extract → map → crawl → **research** ## Quick start ```bash # 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: ```bash # 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](../tavily-search/SKILL.md) — quick web search for simple lookups - [tavily-crawl](../tavily-crawl/SKILL.md) — bulk extract from a site for your own analysis ## Dónde encaja - Categoría: [Investigación](https://skillsagentes.com/categorias/investigacion.md) — Investigación estructurada, búsqueda de fuentes y síntesis. - Creador: [tavily-ai](https://skillsagentes.com/creators/tavily-ai.md) — 2 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Tavily Dynamic Search](https://skillsagentes.com/skills/tavily-ai/skills/tavily-dynamic-search.md): Búsqueda web programática con aislamiento de contexto: busca, filtra y extrae información sin llenar la ventana de contexto con HTML y ruido bruto. - [Tavily Cli](https://skillsagentes.com/skills/tavily-ai/skills/tavily-cli.md): Búsqueda web, extracción de contenido, crawling de sitios y deep research con la CLI de Tavily; capacidades más allá de lo que el agente puede hacer de forma nativa. - [Tavily Best Practices](https://skillsagentes.com/skills/tavily-ai/skills/tavily-best-practices.md): Construye integraciones de Tavily listas para producción: referencia para implementar búsqueda web, extracción, crawling y research en workflows agentic, RAG o agentes autónomos. - [Tavily Crawl](https://skillsagentes.com/skills/tavily-ai/skills/tavily-crawl.md): Rastrea sitios web y extrae contenido de varias páginas mediante el CLI de Tavily, con control de profundidad/amplitud, filtrado de rutas e instrucciones semánticas, guardando cada página como markdown local. - [Tavily Extract](https://skillsagentes.com/skills/tavily-ai/skills/tavily-extract.md): Extrae markdown o texto limpio de URLs específicas mediante el CLI de Tavily; soporta páginas con JavaScript y extracción enfocada por consulta, hasta 20 URLs por llamada. ## Skills relacionadas - [Tavily Cli](https://skillsagentes.com/skills/tavily-ai/skills/tavily-cli.md): Búsqueda web, extracción de contenido, crawling de sitios y deep research con la CLI de Tavily; capacidades más allá de lo que el agente puede hacer de forma nativa. - [Tavily Dynamic Search](https://skillsagentes.com/skills/tavily-ai/skills/tavily-dynamic-search.md): Búsqueda web programática con aislamiento de contexto: busca, filtra y extrae información sin llenar la ventana de contexto con HTML y ruido bruto. - [Tavily Search](https://skillsagentes.com/skills/tavily-ai/skills/tavily-search.md): Busca en la web con resultados optimizados para LLM usando el CLI de Tavily: snippets, puntuaciones de relevancia y metadatos, con filtros de dominio, tiempo y profundidad. - [Tavily Extract](https://skillsagentes.com/skills/tavily-ai/skills/tavily-extract.md): Extrae markdown o texto limpio de URLs específicas mediante el CLI de Tavily; soporta páginas con JavaScript y extracción enfocada por consulta, hasta 20 URLs por llamada. - [Tavily Map](https://skillsagentes.com/skills/tavily-ai/skills/tavily-map.md): Descubre y lista todas las URLs de un sitio web sin extraer contenido, usando el CLI de Tavily; más rápido que rastrear, ideal cuando conoces el sitio pero no la página exacta. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)