Was macht tavily-search?
Durchsuche das Web mit für LLMs optimierten Ergebnissen über die Tavily CLI. Nutze diese Fähigkeit, wenn der Nutzer nach aktuellen Informationen suchen, Nachrichten finden, Quellen entdecken oder nach 'Suche nach', 'Finde mir', 'Schlage nach', 'Was gibt es Neues zu', 'Finde Artikel über' fragt. Liefert relevante Ergebnisse mit Inhaltsausschnitten, Relevanzbewertungen und Metadaten – optimiert für LLM-Konsum. Unterstützt Domain-Filterung, Zeiträume und mehrere Suchtiefen.
Verwendung
Führe den Befehl tavily search mit deiner Suchanfrage aus. Optional kannst du folgende Parameter angeben:
--query(erforderlich): Deine Suchanfrage.--depth(optional):basicoderadvanced(Standard:basic).--max-results(optional): Maximale Anzahl der Ergebnisse (Standard: 5).--time-range(optional):day,week,month,year.--domains(optional): Kommagetrennte Liste von Domains, auf die die Suche beschränkt werden soll.--exclude-domains(optional): Kommagetrennte Liste von Domains, die von der Suche ausgeschlossen werden sollen.
Beispiel
tavily search --query "neueste KI-Durchbrüche 2025" --depth advanced --time-range month --max-results 10
Ausgabeformat
Die Ergebnisse werden als JSON-Array ausgegeben, wobei jedes Objekt die folgenden Felder enthält:
title: Der Titel des Ergebnisses.url: Die URL des Ergebnisses.content: Ein kurzer Inhaltsausschnitt.score: Ein Relevanzwert (0-1).published_date: Das Veröffentlichungsdatum (falls verfügbar).
Beispielausgabe
[
{
"title": "KI-Durchbrüche verändern die Technologie im Jahr 2025",
"url": "https://example.com/ki-durchbrueche-2025",
"content": "Neueste Fortschritte im Bereich Künstliche Intelligenz ...",
"score": 0.95,
"published_date": "2025-03-15"
}
]
Fehlerbehandlung
- Falls der
TAVILY_API_KEYnicht gesetzt ist, wird eine Fehlermeldung ausgegeben. - Bei Netzwerkfehlern oder ungültigen Abfragen wird ein entsprechender Fehler zurückgegeben.
Konfiguration
Setze den Umgebungsvariablen TAVILY_API_KEY mit deinem Tavily-API-Schlüssel. Dies kann in deiner .env-Datei oder direkt in der Shell erfolgen:
export TAVILY_API_KEY="dein-api-schluessel"
Weitere Informationen findest du unter Tavily Dokumentation.