@valyu/ai-sdk weekly downloads statistics

@valyu/ai-sdk

AI SDK tools for Valyu search API, compatible with Vercel AI SDK v5 and v6.

Installation

npm install @valyu/ai-sdk

Quick Start

Get started with web search in seconds:

import { webSearch } from "@valyu/ai-sdk"; 
import { openai } from "@ai-sdk/openai";
// Available specialised search tools: financeSearch, paperSearch, 
// bioSearch, patentSearch, secSearch, economicsSearch, companyResearch

const { text } = await generateText({
  model: openai('gpt-5'),
  prompt: 'Latest data center projects for AI inference workloads?',
  tools: {
    webSearch: webSearch(),
  },
});

console.log(text);

That's it! Get your free API key from the Valyu Platform - $10 in free credits when you sign up.

Need Specialized Search?

Beyond general web search, Valyu provides domain-specific tools for specialized research where you can plug directly into:

• financeSearch - Stock prices, earnings, insider transactions, dividends, balance sheets, income statements, and more
• paperSearch - Full-text search of PubMed, arXiv, bioRxiv, medRxiv, and other scholarly articles
• bioSearch - Clinical trials, FDA drug labels, peer-reviewed biomedical research, PubMed, medRxiv, bioRxiv
• patentSearch - USPTO full-text patent search and related intellectual property
• secSearch - SEC filings including 10-K, 10-Q, 8-K, and regulatory disclosures
• economicsSearch - Economic indicators from BLS, FRED, World Bank, USAspending, and more
• companyResearch - Comprehensive company research and intelligence reports

Or create your own custom search tool using the same API!

Table of Contents

• Installation
• Quick Start
• Setup
• Available Tools
  • webSearch
  • financeSearch
  • paperSearch
  • bioSearch
  • patentSearch
  • secSearch
  • economicsSearch
  • companyResearch
• Create Your Own Tool
• Configuration Options
• Examples
• TypeScript Support
• Links
• License

Setup

1. Get your API key from the Valyu Platform
2. Add it to your .env file:

VALYU_API_KEY=your-api-key-here

That's it! The package reads it automatically.

Available Tools

webSearch

Search the web for current information, news, articles, and general content.

import { generateText, stepCountIs } from "ai";
import { webSearch } from "@valyu/ai-sdk";
import { openai } from "@ai-sdk/openai";

const { text } = await generateText({
  model: openai('gpt-5'),
  prompt: 'Latest data center projects for AI inference workloads?',
  tools: {
    webSearch: webSearch(),
  },
  stopWhen: stepCountIs(3),
});

Best for: Real-time information, news, current events, general web content

financeSearch

Search financial data including stock prices, market data, earnings reports, and financial metrics.

import { generateText, stepCountIs } from "ai";
import { financeSearch } from "@valyu/ai-sdk";
import { openai } from "@ai-sdk/openai";

const { text } = await generateText({
  model: openai('gpt-5'),
  prompt: 'What was the stock price of Apple from the beginning of 2020 to 14th feb?',
  tools: {
    financeSearch: financeSearch(),
  },
  stopWhen: stepCountIs(10),
});

Best for: Stock prices, earnings reports, financial statements, market data, economic indicators

paperSearch

Search academic research papers, scholarly articles, and textbooks across all disciplines.

import { generateText, stepCountIs } from "ai";
import { paperSearch } from "@valyu/ai-sdk";
import { openai } from "@ai-sdk/openai";

const { text } = await generateText({
  model: openai('gpt-5'),
  prompt: 'Psilocybin effects on cellular lifespan and longevity in mice?',
  tools: {
    paperSearch: paperSearch(),
  },
  stopWhen: stepCountIs(10),
});

Best for: Academic research, scientific papers, scholarly articles, arXiv papers

bioSearch

Search biomedical literature including PubMed articles, clinical trials, and FDA drug information.

import { generateText, stepCountIs } from "ai";
import { bioSearch } from "@valyu/ai-sdk";
import { openai } from "@ai-sdk/openai";

const { text } = await generateText({
  model: openai('gpt-5'),
  prompt: 'Summarise top completed Phase 3 metastatic melanoma trial comparing nivolumab+ipilimumab vs monotherapy',
  tools: {
    bioSearch: bioSearch(),
  },
  stopWhen: stepCountIs(10),
});

Best for: Medical research, clinical trials, drug information, disease studies, FDA labels

patentSearch

Search patent databases for inventions, innovations, and intellectual property.

import { generateText, stepCountIs } from "ai";
import { patentSearch } from "@valyu/ai-sdk";
import { openai } from "@ai-sdk/openai";

const { text } = await generateText({
  model: openai('gpt-5'),
  prompt: 'Find patents published in 2025 for high energy laser weapon systems',
  tools: {
    patentSearch: patentSearch({ maxNumResults: 2 }),
  },
  stopWhen: stepCountIs(10),
});

Best for: Patent information, prior art, inventions, intellectual property

secSearch

Search SEC filings including 10-K, 10-Q, 8-K, and other regulatory documents.

import { generateText, stepCountIs } from "ai";
import { secSearch } from "@valyu/ai-sdk";
import { openai } from "@ai-sdk/openai";

const { text } = await generateText({
  model: openai('gpt-5'),
  prompt: 'Summarise MD&A section of Tesla\'s latest 10-k filling',
  tools: {
    secSearch: secSearch(),
  },
  stopWhen: stepCountIs(10),
});
```…