Tavily

Tavily es una API de búsqueda diseñada para aplicaciones de IA. OpenClaw la expone de dos maneras:

como el proveedor web_search para la herramienta de búsqueda genérica
como herramientas de complemento explícitas: tavily_search y tavily_extract

Tavily devuelve resultados estructurados optimizados para el consumo de LLM con profundidad de búsqueda configurable, filtrado de temas, filtros de dominio, resúmenes de respuestas generados por IA y extracción de contenido de URL (incluidas las páginas renderizadas con JavaScript).

Propiedad	Valor
ID del complemento	`tavily`
Autenticación	`TAVILY_API_KEY` o configuración `apiKey`
URL base	`https://api.tavily.com` (predeterminado)
Herramientas incluidas	`tavily_search`, `tavily_extract`

Para comenzar

Obtén una clave de API
Crea una cuenta de Tavily en tavily.com, luego genera una clave de API en el panel de control.

Configura el complemento y el proveedor

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}

Verifica las ejecuciones de búsqueda
Activa un web_search desde cualquier agente, o llama a tavily_search directamente.

Referencia de herramientas

`tavily_search`

Úsalo cuando quieras controles de búsqueda específicos de Tavily en lugar de web_search genérico.

Parámetro	Tipo	Restricciones / predeterminado	Descripción
`query`	cadena	requerido	Cadena de consulta de búsqueda. Manténgala por debajo de 400 caracteres.
`search_depth`	enumeración	`basic` (predeterminado), `advanced`	`advanced` es más lento pero con mayor relevancia.
`topic`	enumeración	`general` (predeterminado), `news`, `finance`	Filtrar por familia de temas.
`max_results`	entero	1-20	Número de resultados.
`include_answer`	booleano	por defecto `false`	Incluir un resumen de respuesta generado por IA de Tavily.
`time_range`	enum	`day`, `week`, `month`, `year`	Filtrar resultados por actualidad.
`include_domains`	matriz de cadenas	(ninguno)	Incluir solo resultados de estos dominios.
`exclude_domains`	matriz de cadenas	(ninguno)	Excluir resultados de estos dominios.

Compensación de profundidad de búsqueda:

Profundidad	Velocidad	Relevancia	Mejor para
`basic`	Más rápido	Alta	Consultas de propósito general (por defecto).
`advanced`	Más lento	La más alta	Investigación de precisión y verificación de datos.

`tavily_extract`

Úselo para extraer contenido limpio de una o más URL. Maneja páginas renderizadas con JavaScript y admite la fragmentación centrada en consultas para una extracción específica.

Parámetro	Tipo	Restricciones / por defecto	Descripción
`urls`	matriz de cadenas	requerido, 1-20	URL de las que extraer contenido.
`query`	cadena	(opcional)	Volver a ordenar los fragmentos extraídos por relevancia para esta consulta.
`extract_depth`	enum	`basic` (por defecto), `advanced`	Use `advanced` para páginas con mucho JS, SPA o tablas dinámicas.
`chunks_per_source`	entero	1-5; requiere `query`	Fragmentos devueltos por URL. Da error si se establece sin `query`.
`include_images`	booleano	por defecto `false`	Incluir URL de imágenes en los resultados.

Compensación de profundidad de extracción:

Profundidad	Cuándo usar
`basic`	Páginas simples. Pruebe esto primero.
`advanced`	SPA renderizadas con JS, contenido dinámico, tablas.

Elegir la herramienta correcta

Necesidad	Herramienta
Búsqueda web rápida, sin opciones especiales	`web_search`
Buscar con profundidad, tema, respuestas de IA	`tavily_search`
Extraer contenido de URL específicas	`tavily_extract`

Configuración avanzada

Orden de resolución de la clave de API

El cliente Tavily busca su clave de API en este orden:

plugins.entries.tavily.config.webSearch.apiKey (resuelto a través de SecretRefs).
TAVILY_API_KEY del entorno de la puerta de enlace.

tavily_extract genera un error de configuración si ninguno está presente.

URL base personalizada

Anule plugins.entries.tavily.config.webSearch.baseUrl si gestiona Tavily a través de un proxy. El valor predeterminado es https://api.tavily.com.

`chunks_per_source` requiere `query`

tavily_extract rechaza las llamadas que pasan chunks_per_source sin un query. Tavily clasifica los fragmentos por relevancia de la consulta, por lo que el parámetro no tiene sentido sin uno.

Relacionado

Resumen de búsqueda web

Todos los proveedores y reglas de detección automática.

Firecrawl

Búsqueda más extracción con extracción de contenido.

Búsqueda Exa

Búsqueda neuronal con extracción de contenido.

Configuración

Esquema de configuración completo para entradas de complemento y enrutamiento de herramientas.