Tavily CLI
Recherche web, extraction de contenu, crawling de sites, découverte d'URLs et recherche approfondie. Retourne du JSON optimisé pour la consommation par LLM.
Exécute tvly --help ou tvly <command> --help pour tous les détails des options.
Prérequis
Doit être installé et authentifié. Vérifiez avec tvly --status.
tavily v0.1.0
> Authenticated via OAuth (tvly login)Si ce n'est pas prêt :
curl -fsSL https://cli.tavily.com/install.sh | bashOu manuellement : uv tool install tavily-cli / pip install tavily-cli
Puis authentifiez-vous :
tvly login --api-key tvly-YOUR_KEY
# or: export TAVILY_API_KEY=tvly-YOUR_KEY
# or: tvly login (opens browser for OAuth)Workflow
Suivez ce modèle d'escalade — commencez simple, montez en charge quand nécessaire :
- Search — Aucune URL spécifique. Trouvez des pages, répondez aux questions, découvrez des sources.
- Extract — Vous avez une URL. Extrayez son contenu directement.
- Map — Grand site, besoin de trouver la bonne page. Découvrez d'abord les URLs.
- Crawl — Besoin de contenu en masse depuis une section entière du site.
- Research — Besoin d'une analyse multi-source complète avec citations.
| Besoin | Commande | Quand |
|---|---|---|
| Trouver des pages sur un sujet | tvly search |
Pas encore d'URL spécifique |
| Obtenir le contenu d'une page | tvly extract |
Vous avez une URL |
| Trouver des URLs au sein d'un site | tvly map |
Besoin de localiser une sous-page spécifique |
| Extraire en masse une section du site | tvly crawl |
Besoin de nombreuses pages (p. ex., tous les /docs/) |
| Recherche approfondie avec citations | tvly research |
Besoin de synthèse multi-source |
Pour une référence de commande détaillée, utilisez le skill individuel pour chaque commande (p. ex., tavily-search, tavily-crawl) ou exécutez tvly <command> --help.
Output
Toutes les commandes supportent --json pour une sortie structurée et lisible par machine, et -o pour enregistrer dans un fichier.
tvly search "react hooks" --json -o results.json
tvly extract "https://example.com/docs" -o docs.md
tvly crawl "https://docs.example.com" --output-dir ./docs/Tips
- Mettez toujours les URLs entre guillemets — le shell interprète
?et&comme des caractères spéciaux. - Utilisez
--jsonpour les workflows d'agents — chaque commande le supporte. - Lisez depuis stdin avec
-—echo "query" | tvly search - - Codes de sortie : 0 = succès, 2 = mauvaise entrée, 3 = erreur d'auth, 4 = erreur API.