tavily search

Recherche web retournant des résultats optimisés pour LLM avec extraits de contenu et scores de pertinence.

Avant d'exécuter une commande

Si tvly ne se trouve pas dans PATH, installez-le d'abord :

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

Ne sautez pas cette étape ni ne vous rabattez sur d'autres outils.

Voir tavily-cli pour les méthodes d'installation alternatives et les options d'authentification.

Quand l'utiliser

Vous devez trouver des informations sur n'importe quel sujet
Vous n'avez pas encore d'URL spécifique
Première étape du workflow : search → extract → map → crawl → research

Démarrage rapide

# Recherche basique
tvly search "votre requête" --json

# Recherche avancée avec plus de résultats
tvly search "quantum computing" --depth advanced --max-results 10 --json

# Actualités récentes
tvly search "AI news" --time-range week --topic news --json

# Filtrée par domaine
tvly search "SEC filings" --include-domains sec.gov,reuters.com --json

# Inclure le contenu complet de la page dans les résultats
tvly search "react hooks tutorial" --include-raw-content --max-results 3 --json

Options

Option	Description
`--depth`	`ultra-fast`, `fast`, `basic` (par défaut), `advanced`
`--max-results`	Nombre max de résultats, 0-20 (par défaut : 5)
`--topic`	`general` (par défaut), `news`, `finance`
`--time-range`	`day`, `week`, `month`, `year`
`--start-date`	Résultats après la date (YYYY-MM-DD)
`--end-date`	Résultats avant la date (YYYY-MM-DD)
`--include-domains`	Domaines à inclure, séparés par des virgules
`--exclude-domains`	Domaines à exclure, séparés par des virgules
`--country`	Favoriser les résultats du pays
`--include-answer`	Inclure la réponse IA (`basic` ou `advanced`)
`--include-raw-content`	Inclure le contenu complet de la page (`markdown` ou `text`)
`--include-images`	Inclure les résultats d'images
`--include-image-descriptions`	Inclure les descriptions d'images IA
`--chunks-per-source`	Chunks par source (profondeur avancée/rapide uniquement)
`-o, --output`	Sauvegarder la sortie dans un fichier
`--json`	Sortie JSON structurée

Profondeur de recherche

Profondeur	Vitesse	Pertinence	Optimal pour
`ultra-fast`	La plus rapide	Faible	Chat temps réel, autocomplétion
`fast`	Rapide	Bonne	Chunks nécessaires, latence importante
`basic`	Moyen	Élevée	Usage général (par défaut)
`advanced`	Plus lent	La plus élevée	Précision, faits spécifiques

Conseils

Limitez les requêtes à moins de 400 caractères — pensez requête de recherche, pas prompt.
Divisez les requêtes complexes en sous-requêtes pour de meilleurs résultats.
Utilisez --include-raw-content quand vous avez besoin du texte complet de la page (économise un appel extract distinct).
Utilisez --include-domains pour vous concentrer sur des sources fiables.
Utilisez --time-range pour les informations récentes.
Lire depuis stdin : echo "query" | tvly search - --json

Voir aussi

tavily-extract — extraire le contenu d'URLs spécifiques
tavily-research — recherche multi-source complète

tavily-search