Was ist Valyu TypeScript SDK (valyu-js)?
valyu-js ist der offizielle TypeScript- und JavaScript-Client für Valyu, eine Such-API für KI-Agenten. Ein einziges `Valyu`-Objekt deckt die Suche im Web und in proprietären Quellen ab (PubMed, arXiv, SEC-Einreichungen, Patente und weitere), die Extraktion von Inhalten aus URLs, belegte Antworten und DeepResearch, einen asynchronen Recherche-Agenten, der Berichte mit Quellenangaben und optional PDF-, CSV- und andere Dateien liefert.
Installiert wird es mit `npm install valyu-js`, dazu kommt ein `VALYU_API_KEY`. Die aktuelle Version ist 2.11.5, auf npm veröffentlicht am 31. Oktober 2026. Das SDK steht unter MIT; jeder Aufruf wird in Valyu-Credits abgerechnet.
Lohnt sich Valyu TypeScript SDK (valyu-js)?
valyu-js ist ein gut gepflegter Wrapper, dessen Wert mit der Valyu-API dahinter steigt oder fällt. Das SDK selbst ist unter MIT kostenlos; ohne Schlüssel tut es nichts, und jede Suche, Extraktion und Rechercheaufgabe wird in Credits abgerechnet. Vor der Einführung ist zu klären, ob Valyus Daten für deine Anfragen besser sind als Exa, Tavily oder ein selbst betriebener Crawler, nicht ob der Client etwas taugt.
Der Client taugt etwas. Nach unserer Lektüre des Changelogs kamen 2.11.0 bis 2.11.5 kurz hintereinander, mit einem `instant`-Recherchemodus, automatischen Wiederholungen bei 429-Antworten (standardmäßig 2, mit Beachtung von Retry-After bis 60 Sekunden), einem Timeout von 120 Sekunden für DeepResearch-Anfragen, ETag-basiertem Polling und Cache-Steuerung pro Seite in `contents()`. Mehrere Korrekturen betrafen Optionen, die das SDK stillschweigend verworfen hatte, etwa `countryCode` in falscher Schreibweise; diese Offenheit beruhigt und ist ein Grund, auf der neuesten Version zu bleiben.
DeepResearch wird pro Aufgabe nach Modus berechnet: 8 Credits für instant, 25 für fast, 100 für standard, 500 für heavy und 2.500 für max, Suchen und Seitenabrufe inklusive. Beim Pay-as-you-go-Satz von 1.600 Credits pro 10 $ kostet eine fast-Aufgabe etwa 0,16 $ und eine max-Aufgabe etwa 15,60 $. Das TypeScript-SDK nutzt standardmäßig fast, die API und das Python-SDK dagegen standard, sodass derselbe Aufruf aus einem anderen Client das Vierfache kosten kann. Jede weitere Ergebnisdatei nach der ersten kostet 16 Credits. Die Suche wird pro tausend Ergebnisse nach Quelle berechnet: etwa 0,31 $ für arXiv und PubMed, 0,63 $ für das Web, bis zu 30 $ für lizenzierte Fachzeitschriften.
Der Haken: Belege für die Verbreitung sind dünn und meist selbstbezüglich. Das Repository hat 2 GitHub-Sterne; npm zählte 19.281 Downloads in den 30 Tagen bis zum 2. November 2026, und die sichtbaren Open-Source-Nutzer sind Demo-Apps von Leuten aus dem Umfeld von Valyu, darunter Global Threat Map, Global Hack Map und Polyseer. Das belegt, dass die API für diese Apps funktioniert, nicht einen Marktanteil. Der Schlüssel ist zudem ein Abrechnungszugang: Das SDK ist für Servercode gedacht, und ein Browser-Bundle mit `VALYU_API_KEY` überlässt dein Credit-Guthaben jedem, der die Entwicklerwerkzeuge öffnet.
Unser Fazit: valyu-js ist der Preis dafür, Valyu auszuprobieren, und der ist gering; Valyu selbst solltest du an einer Stichprobe deiner eigenen Anfragen messen, bevor es in ein Produkt wandert.
Wo es sich lohnt
Ein Zwei-Personen-Startup, das in Next.js einen Assistenten für Biotech-Fachliteratur baut
PubMed und klinische Studien aus Servercode durchsuchen, ohne Scraper zu pflegen
Rufe `valyu.search()` mit `searchType: "proprietary"` und auf PubMed begrenzten `includedSources` aus einer API-Route auf. Ergebnisse werden pro tausend zurückgegebene berechnet, etwa 0,31 $ für PubMed, also läuft ein Prototyp mit dem Start-Guthaben von 10 $.
Ein Aktienanalyst in einem kleinen Fonds
Jeden Morgen einen belegten ersten Entwurf zu einem Unternehmen bekommen
Stelle `deepresearch.create()`-Aufträge über `batch` im fast-Modus zu je 25 Credits ein, etwa 0,16 $ im Pay-as-you-go, und lies die Ausgabe als Markdown oder PDF. Der heavy-Modus kostet 500 Credits pro Bericht, die Moduswahl bestimmt also die Rechnung.
Ein Platform Engineer, der einem internen Agenten Web-Lesen beibringt
Eine Liste von URLs in sauberen Text oder JSON-Felder umwandeln
`contents()` nimmt 1 bis 10 URLs synchron oder bis zu 50 asynchron, mit optionalem JSON-Schema für strukturierte Extraktion und `maxAge`, um einen frischen Crawl zu erzwingen. Nur serverseitig ausführen und den Schlüssel im Secret Store halten.
Bevor du dich festlegst
- Einrichtung
- `npm install valyu-js`, `VALYU_API_KEY` setzen und `new Valyu(process.env.VALYU_API_KEY)` aufrufen. Eine erste Suche dauert Minuten; die Anmeldung braucht keine Karte.
- Integrationen
- Ein Python-SDK deckt dieselbe API ab; das README nennt Integrationen für das Vercel AI SDK (@valyu/ai-sdk), LangChain und MCP. Vollständige TypeScript-Typen werden für jede Anfrage und Antwort exportiert.
- Daten und Datenschutz
- Anfragen und URLs gehen an Valyus gehostete API; das SDK hat keinen Self-Hosting-Modus. Valyus Aufbewahrungs- und Trainingsbedingungen behandelt die SDK-Dokumentation nicht. DeepResearch-Downloadlinks sind signiert und laufen ab.
- Kosten im großen Maßstab
- Monatspläne: 29 $ für 5.000 Credits, 99 $ für 18.000, 499 $ für 100.000; Credits werden nicht in den nächsten Monat übertragen. Bei Guthaben null liefern neue Anfragen 402, statt Mehrverbrauch abzurechnen. Die DeepResearch-Parallelität hängt vom Plan ab: 2 Aufgaben gleichzeitig bei Pay-as-you-go, 5 im 29-$-Plan, laut Dokumentation.
- Grenzen
- Die Suche liefert höchstens 20 Ergebnisse pro Aufruf. Die harten DeepResearch-Grenzen reichen von 2 Minuten (instant) bis 90 Minuten (max); `wait()` gibt nach 2 Stunden auf. Numerische Ratenlimits für Anfragen sind nicht veröffentlicht.
Was gut ist
- Suche, contents, answer, DeepResearch, batch und workflows in einem typisierten Client
- Sichere automatische Wiederholung bei 429, mit Beachtung des Retry-After des Servers
- Häufige Releases mit ausführlichem, offenem Changelog
- MIT-Lizenz
Was nicht
- Ohne kostenpflichtiges, abgerechnetes Valyu-Konto nutzlos
- Standardmodus in TypeScript (fast) weicht vom API-Standard (standard) ab
- Wenig unabhängige Verbreitung jenseits von Demo-Apps aus Valyus Umfeld
- Mehrere jüngere Korrekturen betrafen Optionen, die zuvor ohne Fehler verworfen wurden
Am besten für
TypeScript-Teams, die bereits entschieden haben, dass Valyus Datenquellen zu ihrem Agenten passen, und den offiziellen, gepflegten Client wollen.
Alternativen zu Valyu TypeScript SDK (valyu-js)
Valyu TypeScript SDK (valyu-js): häufige Fragen
- Lohnt sich Valyu TypeScript SDK (valyu-js)?
- Ein sorgfältiger, schnell weiterentwickelter Client für eine einzige kostenpflichtige API; der Code ist MIT, aber was du tatsächlich kaufst, ist Valyus Credit-Zähler. Wir bewerten es mit 3.8 von 5.
- Was kostet Valyu TypeScript SDK (valyu-js)?
- SDK kostenlos unter MIT. Die Valyu-API wird in Credits abgerechnet: Pay-as-you-go 1.600 Credits pro 10 $; Pläne für 29 $, 99 $ und 499 $ im Monat; neue Konten erhalten 10 $ Gratis-Credits (20 $ mit einer Firmen-E-Mail).
- Welche Nachteile hat Valyu TypeScript SDK (valyu-js)?
- Ohne kostenpflichtiges, abgerechnetes Valyu-Konto nutzlos; Standardmodus in TypeScript (fast) weicht vom API-Standard (standard) ab; Wenig unabhängige Verbreitung jenseits von Demo-Apps aus Valyus Umfeld; Mehrere jüngere Korrekturen betrafen Optionen, die zuvor ohne Fehler verworfen wurden.
- Für wen eignet sich Valyu TypeScript SDK (valyu-js)?
- TypeScript-Teams, die bereits entschieden haben, dass Valyus Datenquellen zu ihrem Agenten passen, und den offiziellen, gepflegten Client wollen.
- Was kostet Valyu TypeScript SDK (valyu-js) für ein Team oder im Produktivbetrieb?
- Monatspläne: 29 $ für 5.000 Credits, 99 $ für 18.000, 499 $ für 100.000; Credits werden nicht in den nächsten Monat übertragen. Bei Guthaben null liefern neue Anfragen 402, statt Mehrverbrauch abzurechnen. Die DeepResearch-Parallelität hängt vom Plan ab: 2 Aufgaben gleichzeitig bei Pay-as-you-go, 5 im 29-$-Plan, laut Dokumentation.
- Ist Valyu TypeScript SDK (valyu-js) sicher für Firmendaten?
- Anfragen und URLs gehen an Valyus gehostete API; das SDK hat keinen Self-Hosting-Modus. Valyus Aufbewahrungs- und Trainingsbedingungen behandelt die SDK-Dokumentation nicht. DeepResearch-Downloadlinks sind signiert und laufen ab.
- Was sind die besten Alternativen zu Valyu TypeScript SDK (valyu-js)?
- Die nächsten Alternativen, die wir getestet haben, sind Firecrawl, Crawl4AI und GPT Researcher.
Antworten geprüft am 3. Nov. 2026.