tavily-search
por tavily-ai
Búsqueda web con resultados optimizados para LLM, fragmentos de contenido y puntuaciones de relevancia. Admite cuatro profundidades de búsqueda (ultrarrápida, rápida, básica, avanzada) con recuentos de resultados configurables de hasta 20, además de filtrado por dominio y restricciones de rango temporal. Devuelve una salida JSON estructurada con fragmentos de contenido, puntuaciones de relevancia y metadatos optimizados para el consumo de LLM. Incluye modos de búsqueda especializados para temas de noticias y finanzas, con respuestas generadas por IA opcionales y extracción completa del contenido de la página. Se integra en...
npx skills add https://github.com/tavily-ai/skills --skill tavily-searchtavily search
Web search returning LLM-optimized results with content snippets and relevance scores.
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 to find information on any topic
- You don't have a specific URL yet
- First step in the workflow: search → extract → map → crawl → research
Quick start
# Basic search
tvly search "your query" --json
# Advanced search with more results
tvly search "quantum computing" --depth advanced --max-results 10 --json
# Recent news
tvly search "AI news" --time-range week --topic news --json
# Domain-filtered
tvly search "SEC filings" --include-domains sec.gov,reuters.com --json
# Include full page content in results
tvly search "react hooks tutorial" --include-raw-content --max-results 3 --json
Options
| Option | Description |
|---|---|
--depth | ultra-fast, fast, basic (default), advanced |
--max-results | Max results, 0-20 (default: 5) |
--topic | general (default), news, finance |
--time-range | day, week, month, year |
--start-date | Results after date (YYYY-MM-DD) |
--end-date | Results before date (YYYY-MM-DD) |
--include-domains | Comma-separated domains to include |
--exclude-domains | Comma-separated domains to exclude |
--country | Boost results from country |
--include-answer | Include AI answer (basic or advanced) |
--include-raw-content | Include full page content (markdown or text) |
--include-images | Include image results |
--include-image-descriptions | Include AI image descriptions |
--chunks-per-source | Chunks per source (advanced/fast depth only) |
-o, --output | Save output to file |
--json | Structured JSON output |
Search depth
| Depth | Speed | Relevance | Best for |
|---|---|---|---|
ultra-fast | Fastest | Lower | Real-time chat, autocomplete |
fast | Fast | Good | Need chunks, latency matters |
basic | Medium | High | General-purpose (default) |
advanced | Slower | Highest | Precision, specific facts |
Tips
- Keep queries under 400 characters — think search query, not prompt.
- Break complex queries into sub-queries for better results.
- Use
--include-raw-contentwhen you need full page text (saves a separate extract call). - Use
--include-domainsto focus on trusted sources. - Use
--time-rangefor recent information. - Read from stdin:
echo "query" | tvly search - --json
See also
- tavily-extract — extract content from specific URLs
- tavily-research — comprehensive multi-source research
Más skills de tavily-ai
crawl
tavily-ai
Extrae y guarda el contenido de sitios web como archivos markdown para acceso y análisis sin conexión. Admite profundidad de rastreo configurable (1-5 niveles), límites de amplitud y topes de páginas para equilibrar la cobertura con el rendimiento. Incluye filtrado de rutas mediante patrones regex para enfocarse en secciones específicas y excluir contenido irrelevante. Ofrece dos modos: extracción de página completa para recopilación de datos, o fragmentación semántica con instrucciones en lenguaje natural para alimentar resultados en el contexto de un LLM. Proporciona una API de mapa complementaria para URL...
official
extract
tavily-ai
Extrae contenido limpio de URLs específicas usando la API de extracción de Tavily. Admite hasta 20 URLs por solicitud con reordenamiento opcional basado en consultas para enfocarse en fragmentos de contenido relevantes. Dos modos de extracción: básico para extracción rápida de texto, avanzado para páginas renderizadas con JavaScript y datos estructurados. Autenticación automática OAuth mediante navegador en la primera ejecución, o configuración manual de clave API en ajustes. Devuelve formato markdown o texto plano con URLs de imágenes opcionales y tiempo de espera configurable de hasta 60 segundos.
official
research
tavily-ai
Investigación exhaustiva sobre cualquier tema con recopilación automática de fuentes, análisis y citas. Realiza investigación web de múltiples fuentes con citas explícitas, ideal para comparaciones, eventos actuales, análisis de mercado e informes detallados. Ofrece tres opciones de modelo: mini para investigación dirigida de un solo tema (~30s), pro para análisis integral de múltiples ángulos (~60-120s) y auto para detección de complejidad impulsada por API. Se autentica mediante OAuth a través del servidor MCP de Tavily con inicio de sesión automático basado en navegador en...
official
search
tavily-ai
Búsqueda web con resultados optimizados para LLM, puntuación de relevancia y filtrado flexible. Compatible con cuatro modos de profundidad de búsqueda (ultrarrápido, rápido, básico, avanzado) con compensaciones configurables entre latencia y relevancia. Incluye filtrado por dominio, restricciones de rango temporal, rangos de fechas, priorización por país y extracción de contenido sin procesar. Devuelve resultados con título, URL, fragmento de contenido y puntuación de relevancia; resultados de imágenes opcionales y favicons. Autenticación OAuth automática a través del servidor MCP de Tavily o configuración de clave API;...
official
tavily-best-practices
tavily-ai
API de búsqueda web para LLMs con acceso a datos en tiempo real, extracción de contenido, rastreo de sitios e investigación impulsada por IA. Cinco métodos principales: search() para resultados web, extract() para contenido de URL, crawl() para extracción en todo el sitio, map() para descubrimiento de URL y research() para síntesis de IA de extremo a extremo. Compatible con SDKs de Python y JavaScript con clientes asíncronos para consultas paralelas y profundidad de búsqueda configurable (ultra-rápida/rápida/básica/avanzada). El método crawl acepta instrucciones semánticas para enfocar la extracción en...
official
tavily-cli
tavily-ai
Búsqueda web, extracción de contenido, rastreo de sitios e investigación profunda a través de Tavily CLI. Cinco modos de comando que cubren búsqueda, extracción, descubrimiento de URL, rastreo masivo e investigación multifuente con citas. Todos los comandos admiten salida JSON y guardado en archivos para flujos de trabajo estructurados y agentivos. Un patrón de escalamiento te guía desde la búsqueda simple hasta la extracción, mapeo, rastreo e investigación exhaustiva según tus necesidades. Requiere instalación de tavily-cli y autenticación mediante clave API a través de tvly login.
official
tavily-crawl
tavily-ai
Rastreador de sitios web multipágina con filtrado semántico y exportación a Markdown. Rastrea secciones completas del sitio con control de profundidad y amplitud; filtra por expresión regular de ruta, dominio o instrucciones en lenguaje natural para enfocar los resultados. Guarda cada página como archivos Markdown locales mediante --output-dir, o devuelve JSON estructurado para procesamiento agéntico. Usa instrucciones semánticas con extracción por fragmentos para evitar la saturación de contexto al alimentar resultados a LLMs; usa extracción de página completa para descargas de documentación sin conexión. Compatible con...
official
tavily-dynamic-search
tavily-ai
Busca en la web, filtra resultados y extrae contenido para que los datos de búsqueda sin procesar nunca entren en tu ventana de contexto. Solo tu salida curada de print() regresa.
official