O que é Valyu TypeScript SDK (valyu-js)?
valyu-js é o cliente oficial em TypeScript e JavaScript da Valyu, uma API de busca feita para agentes de IA. Um único objeto `Valyu` cobre a busca na web e em fontes proprietárias (PubMed, arXiv, documentos da SEC, patentes e outras), a extração de conteúdo de URLs, respostas fundamentadas e o DeepResearch, um agente de pesquisa assíncrono que devolve relatórios com citações e, opcionalmente, arquivos PDF, CSV e outros.
A instalação é com `npm install valyu-js`, passando uma `VALYU_API_KEY`. A versão atual é a 2.11.5, publicada no npm em 31 de outubro de 2026. O SDK é MIT; cada chamada que ele faz é cobrada em créditos da Valyu.
Valyu TypeScript SDK (valyu-js) vale a pena?
valyu-js é um wrapper bem mantido cujo valor sobe ou desce junto com a API da Valyu por trás dele. O SDK em si é gratuito sob MIT; não faz nada sem uma chave, e cada busca, extração e tarefa de pesquisa é cobrada em créditos. A pergunta a responder antes de adotá-lo é se os dados da Valyu superam Exa, Tavily ou um crawler próprio para as suas consultas, não se o cliente é bom.
O cliente é bom. Na nossa leitura do changelog, as versões 2.11.0 a 2.11.5 saíram em sequência rápida, com um modo de pesquisa `instant`, novas tentativas automáticas em respostas 429 (2 por padrão, respeitando o Retry-After até 60 segundos), um tempo limite de 120 segundos nas requisições de DeepResearch, polling baseado em ETag e controle de cache por página em `contents()`. Várias correções foram para opções que o SDK descartava em silêncio, como `countryCode` enviado no formato errado; essa franqueza tranquiliza e é um motivo para ficar na versão mais recente.
O DeepResearch é cobrado por tarefa conforme o modo: 8 créditos no instant, 25 no fast, 100 no standard, 500 no heavy e 2.500 no max, com buscas e leituras de páginas incluídas. Na tarifa de pagamento por uso de 1.600 créditos por US$ 10, uma tarefa fast sai por cerca de US$ 0,16 e uma max por cerca de US$ 15,60. O SDK de TypeScript usa fast por padrão, enquanto a API e o SDK de Python usam standard, então a mesma chamada pode custar quatro vezes mais a partir de outro cliente. Cada arquivo de entrega adicional custa 16 créditos depois do primeiro. A busca é cobrada por mil resultados conforme a fonte: cerca de US$ 0,31 para arXiv e PubMed, US$ 0,63 para a web e até US$ 30 para periódicos licenciados.
O porém: as evidências de adoção são poucas e quase todas autorreferentes. O repositório tem 2 estrelas no GitHub; o npm contou 19.281 downloads nos 30 dias até 2 de novembro de 2026, e os usuários visíveis em código aberto são apps de demonstração de pessoas próximas da Valyu, entre eles Global Threat Map, Global Hack Map e Polyseer. Isso mostra que a API funciona para esses apps, não que ela tenha participação de mercado. A chave também é uma credencial de cobrança: o SDK foi feito para código de servidor, e um bundle de navegador que inclua `VALYU_API_KEY` entrega o seu saldo de créditos a qualquer um que abra as ferramentas de desenvolvedor.
Nossa opinião: valyu-js é o custo de experimentar a Valyu, que é baixo; a Valyu em si deve ser julgada com uma amostra das suas próprias consultas antes de entrar em um produto.
Onde ele se destaca
Uma startup de duas pessoas criando em Next.js um assistente de literatura de biotecnologia
Buscar no PubMed e em ensaios clínicos a partir do servidor sem manter scrapers
Chame `valyu.search()` com `searchType: "proprietary"` e `includedSources` limitado ao PubMed a partir de uma rota de API. Os resultados são cobrados por mil devolvidos, cerca de US$ 0,31 no PubMed, então um protótipo roda com os US$ 10 de crédito do cadastro.
Um analista de ações em um fundo pequeno
Receber toda manhã um primeiro rascunho com citações sobre uma empresa
Enfileire tarefas `deepresearch.create()` via `batch` no modo fast a 25 créditos cada, cerca de US$ 0,16 no pagamento por uso, e leia a saída em markdown ou PDF. O modo heavy custa 500 créditos por relatório, então a escolha do modo define a conta.
Um engenheiro de plataforma adicionando leitura da web a um agente interno
Transformar uma lista de URLs em texto limpo ou campos JSON
`contents()` aceita de 1 a 10 URLs de forma síncrona ou até 50 de forma assíncrona, com um esquema JSON opcional para extração estruturada e `maxAge` para forçar um novo rastreamento. Rode só no servidor e guarde a chave no seu cofre de segredos.
Antes de decidir
- Configuração
- `npm install valyu-js`, defina `VALYU_API_KEY` e chame `new Valyu(process.env.VALYU_API_KEY)`. Uma primeira busca leva minutos; o cadastro não pede cartão.
- Integrações
- Um SDK de Python cobre a mesma API; o README lista integrações com o Vercel AI SDK (@valyu/ai-sdk), LangChain e MCP. Tipos completos de TypeScript são exportados para cada requisição e resposta.
- Dados e privacidade
- Consultas e URLs vão para a API hospedada da Valyu; o SDK não tem modo auto-hospedado. A documentação do SDK não trata dos termos de retenção e treinamento da Valyu. Os links de download do DeepResearch são assinados e expiram.
- Custo em escala
- Planos mensais: US$ 29 por 5.000 créditos, US$ 99 por 18.000, US$ 499 por 100.000; os créditos não acumulam. Com saldo zero, novas requisições retornam 402 em vez de cobrar excedente. A concorrência do DeepResearch depende do plano: 2 tarefas ao mesmo tempo no pagamento por uso, 5 no plano de US$ 29, segundo a documentação.
- Limites
- A busca devolve no máximo 20 resultados por chamada. Os limites rígidos do DeepResearch vão de 2 minutos (instant) a 90 minutos (max); `wait()` desiste após 2 horas. Não há limites numéricos de requisições publicados.
O que é bom
- Busca, contents, answer, DeepResearch, batch e workflows em um cliente tipado
- Novas tentativas automáticas seguras em 429, respeitando o Retry-After do servidor
- Lançamentos frequentes com changelog detalhado e franco
- Licença MIT
O que não é
- Inútil sem uma conta paga e medida da Valyu
- O modo padrão no TypeScript (fast) difere do padrão da API (standard)
- Pouca adoção independente além de apps de demonstração pr óximos da Valyu
- Várias correções recentes foram para opções antes descartadas sem erro
Ideal para
Equipes de TypeScript que já decidiram que as fontes de dados da Valyu servem para o seu agente e querem o cliente oficial e mantido.
Alternativas ao Valyu TypeScript SDK (valyu-js)
Valyu TypeScript SDK (valyu-js): perguntas frequentes
- Valyu TypeScript SDK (valyu-js) vale a pena?
- Um cliente cuidadoso e em rápida evolução para uma única API paga; o código é MIT, mas o que você está comprando de fato é o medidor de créditos da Valyu. Damos nota 3.8 de 5.
- Quanto custa Valyu TypeScript SDK (valyu-js)?
- SDK gratuito sob MIT. A API da Valyu é medida em créditos: pagamento por uso, 1.600 créditos por US$ 10; planos de US$ 29, US$ 99 e US$ 499 por mês; contas novas recebem US$ 10 em créditos grátis (US$ 20 com e-mail corporativo).
- Quais são as desvantagens de Valyu TypeScript SDK (valyu-js)?
- Inútil sem uma conta paga e medida da Valyu; o modo padrão no TypeScript (fast) difere do padrão da API (standard); pouca adoção independente além de apps de demonstração próximos da Valyu; várias correções recentes foram para opções antes descartadas sem erro.
- Para quem Valyu TypeScript SDK (valyu-js) é indicado?
- Equipes de TypeScript que já decidiram que as fontes de dados da Valyu servem para o seu agente e querem o cliente oficial e mantido.
- Quanto custa Valyu TypeScript SDK (valyu-js) para uma equipe ou em produção?
- Planos mensais: US$ 29 por 5.000 créditos, US$ 99 por 18.000, US$ 499 por 100.000; os créditos não acumulam. Com saldo zero, novas requisições retornam 402 em vez de cobrar excedente. A concorrência do DeepResearch depende do plano: 2 tarefas ao mesmo tempo no pagamento por uso, 5 no plano de US$ 29, segundo a documentação.
- Valyu TypeScript SDK (valyu-js) é seguro para dados da empresa?
- Consultas e URLs vão para a API hospedada da Valyu; o SDK não tem modo auto-hospedado. A documentação do SDK não trata dos termos de retenção e treinamento da Valyu. Os links de download do DeepResearch são assinados e expiram.
- Quais são as melhores alternativas ao Valyu TypeScript SDK (valyu-js)?
- As alternativas mais próximas que analisamos são Firecrawl, Crawl4AI e GPT Researcher.
Respostas verificadas em 3 de nov. de 2026.