¿Qué es Valyu TypeScript SDK (valyu-js)?
valyu-js es el cliente oficial de TypeScript y JavaScript para Valyu, una API de búsqueda pensada para agentes de IA. Un único objeto `Valyu` cubre la búsqueda en la web y en fuentes propietarias (PubMed, arXiv, documentos de la SEC, patentes y otras), la extracción de contenido de URL, respuestas fundamentadas y DeepResearch, un agente de investigación asíncrono que devuelve informes con citas y, opcionalmente, archivos PDF, CSV y otros.
Se instala con `npm install valyu-js` y se le pasa una `VALYU_API_KEY`. La versión actual es la 2.11.5, publicada en npm el 31 de octubre de 2026. El SDK es MIT; cada llamada que hace se factura en créditos de Valyu.
¿Merece la pena Valyu TypeScript SDK (valyu-js)?
valyu-js es un envoltorio bien mantenido cuyo valor sube o baja con la API de Valyu que tiene detrás. El SDK en sí es gratuito bajo MIT; no hace nada sin una clave, y cada búsqueda, extracción y tarea de investigación se factura en créditos. La pregunta que hay que responder antes de adoptarlo es si los datos de Valyu superan a Exa, Tavily o un rastreador propio para tus consultas, no si el cliente es bueno.
El cliente es bueno. Según nuestra lectura del changelog, publicó de la 2.11.0 a la 2.11.5 en poco tiempo, con un modo de investigación `instant`, reintentos automáticos ante respuestas 429 (2 por defecto, respetando Retry-After hasta 60 segundos), un tiempo límite de 120 segundos en las peticiones de DeepResearch, sondeo basado en ETag y control de caché por página en `contents()`. Varias correcciones eran para opciones que el SDK descartaba sin avisar, como `countryCode` enviado con el formato equivocado; esa franqueza tranquiliza, y es un motivo para mantenerse en la última versión.
DeepResearch se cobra por tarea según el modo: 8 créditos en instant, 25 en fast, 100 en standard, 500 en heavy y 2.500 en max, con búsquedas y lecturas de páginas incluidas. Con la tarifa de pago por uso de 1.600 créditos por 10 $, una tarea fast cuesta unos 0,16 $ y una max unos 15,60 $. El SDK de TypeScript usa fast por defecto, mientras que la API y el SDK de Python usan standard, así que la misma llamada puede costar cuatro veces más desde otro cliente. Cada archivo entregable adicional cuesta 16 créditos a partir del primero. La búsqueda se cobra por cada mil resultados según la fuente: unos 0,31 $ para arXiv y PubMed, 0,63 $ para la web y hasta 30 $ para revistas con licencia.
La pega: las pruebas de adopción son escasas y en su mayoría autorreferenciales. El repositorio tiene 2 estrellas en GitHub; npm contó 19.281 descargas en los 30 días hasta el 2 de noviembre de 2026, y los usuarios visibles de código abierto son apps de demostración de personas cercanas a Valyu, entre ellas Global Threat Map, Global Hack Map y Polyseer. Eso demuestra que la API funciona para esas apps, no que tenga cuota de mercado. La clave es además una credencial de facturación: el SDK está pensado para código de servidor, y un bundle de navegador que incluya `VALYU_API_KEY` entrega tu saldo de créditos a cualquiera que abra las herramientas de desarrollo.
Nuestra opinión: valyu-js es el coste de probar Valyu, que es bajo; a Valyu en sí conviene juzgarlo con una muestra de tus propias consultas antes de meterlo en un producto.
Dónde se gana su sitio
Una startup de dos personas que crea en Next.js un asistente de literatura biotecnológica
Buscar en PubMed y en ensayos clínicos desde el servidor sin mantener scrapers
Llama a `valyu.search()` con `searchType: "proprietary"` e `includedSources` limitado a PubMed desde una ruta de API. Los resultados se cobran por cada mil devueltos, unos 0,31 $ en PubMed, así que un prototipo funciona con los 10 $ de crédito de registro.
Un analista de renta variable en un fondo pequeño
Tener cada mañana un primer borrador con citas sobre una empresa
Encola tareas `deepresearch.create()` mediante `batch` en modo fast a 25 créditos cada una, unos 0,16 $ con pago por uso, y lee la salida en markdown o PDF. El modo heavy cuesta 500 créditos por informe, así que la elección de modo determina la factura.
Un ingeniero de plataforma que añade lectura web a un agente interno
Convertir una lista de URL en texto limpio o campos JSON
`contents()` acepta de 1 a 10 URL de forma síncrona o hasta 50 de forma asíncrona, con un esquema JSON opcional para extracción estructurada y `maxAge` para forzar un rastreo nuevo. Ejecútalo solo en el servidor y guarda la clave en tu gestor de secretos.
Antes de decidirte
- Puesta en marcha
- `npm install valyu-js`, define `VALYU_API_KEY` y llama a `new Valyu(process.env.VALYU_API_KEY)`. Una primera búsqueda lleva minutos; el registro no pide tarjeta.
- Integraciones
- Un SDK de Python cubre la misma API; el README enumera integraciones con el Vercel AI SDK (@valyu/ai-sdk), LangChain y MCP. Se exportan tipos completos de TypeScript para cada petición y respuesta.
- Datos y privacidad
- Las consultas y URL van a la API alojada de Valyu; el SDK no tiene modo autoalojado. La documentación del SDK no cubre las condiciones de retención y entrenamiento de Valyu. Los enlaces de descarga de DeepResearch están firmados y caducan.
- Coste a escala
- Planes mensuales: 29 $ por 5.000 créditos, 99 $ por 18.000, 499 $ por 100.000; los créditos no se acumulan. Con saldo cero, las nuevas peticiones devuelven 402 en lugar de facturar un exceso. La concurrencia de DeepResearch depende del plan: 2 tareas a la vez en pago por uso, 5 en el plan de 29 $, según la documentación.
- Límites
- La búsqueda devuelve como máximo 20 resultados por llamada. Los límites duros de DeepResearch van de 2 minutos (instant) a 90 minutos (max); `wait()` se rinde a las 2 horas. No se publican límites numéricos de peticiones.
Lo bueno
- Búsqueda, contents, answer, DeepResearch, batch y workflows en un cliente tipado
- Reintentos automáticos seguros ante 429, respetando el Retry-After del servidor
- Versiones frecuentes con un changelog detallado y franco
- Licencia MIT
Lo malo
- Inútil sin una cuenta de Valyu de pago y medida
- El modo por defecto en TypeScript (fast) difiere del de la API (standard)
- Poca adopción independiente más allá de apps de demostración cercanas a Valyu
- Varias correcciones recientes eran para opciones que antes se descartaban sin error
Ideal para
Equipos de TypeScript que ya han decidido que las fuentes de datos de Valyu encajan con su agente y quieren el cliente oficial y mantenido.
Alternativas a Valyu TypeScript SDK (valyu-js)
Valyu TypeScript SDK (valyu-js): preguntas frecuentes
- ¿Merece la pena Valyu TypeScript SDK (valyu-js)?
- Un cliente cuidado y en rápida evolución para una sola API de pago; el código es MIT, pero lo que de verdad compras es el contador de créditos de Valyu. Le damos un 3.8 sobre 5.
- ¿Cuánto cuesta Valyu TypeScript SDK (valyu-js)?
- SDK gratuito bajo MIT. La API de Valyu se mide en créditos: pago por uso, 1.600 créditos por 10 $; planes de 29 $, 99 $ y 499 $ al mes; las cuentas nuevas reciben 10 $ en créditos gratis (20 $ con un correo de empresa).
- ¿Qué inconvenientes tiene Valyu TypeScript SDK (valyu-js)?
- Inútil sin una cuenta de Valyu de pago y medida; el modo por defecto en TypeScript (fast) difiere del de la API (standard); poca adopción independiente más allá de apps de demostración cercanas a Valyu; varias correcciones recientes eran para opciones que antes se descartaban sin error.
- ¿Para quién es Valyu TypeScript SDK (valyu-js)?
- Equipos de TypeScript que ya han decidido que las fuentes de datos de Valyu encajan con su agente y quieren el cliente oficial y mantenido.
- ¿Cuánto cuesta Valyu TypeScript SDK (valyu-js) para un equipo o en producción?
- Planes mensuales: 29 $ por 5.000 créditos, 99 $ por 18.000, 499 $ por 100.000; los créditos no se acumulan. Con saldo cero, las nuevas peticiones devuelven 402 en lugar de facturar un exceso. La concurrencia de DeepResearch depende del plan: 2 tareas a la vez en pago por uso, 5 en el plan de 29 $, según la documentación.
- ¿Es Valyu TypeScript SDK (valyu-js) seguro para los datos de la empresa?
- Las consultas y URL van a la API alojada de Valyu; el SDK no tiene modo autoalojado. La documentación del SDK no cubre las condiciones de retención y entrenamiento de Valyu. Los enlaces de descarga de DeepResearch están firmados y caducan.
- ¿Cuáles son las mejores alternativas a Valyu TypeScript SDK (valyu-js)?
- Las alternativas más cercanas que hemos analizado son Firecrawl, Crawl4AI y GPT Researcher.
Respuestas comprobadas el 3 nov 2026.