> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Valyu Search

> Domain-specific search tools for finance, research, patents, and more

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
    U[Input] --> A[Agent]
    A --> T[Tool]
    T --> O[Output]

    classDef agent fill:#8B0000,color:#fff
    classDef tool fill:#189AB4,color:#fff

    class A agent
    class U,O tool
    class T tool
```

# Valyu Search Tools

Valyu provides powerful domain-specific search tools including web search, finance, academic papers, biomedical, patents, SEC filings, economics data, and company research.

## Installation

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
npm install @valyu/ai-sdk
```

## Environment Variables

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
VALYU_API_KEY=your-valyu-api-key
```

## Available Tools

| Tool                   | Description                              |
| ---------------------- | ---------------------------------------- |
| `valyuWebSearch`       | General web search                       |
| `valyuFinanceSearch`   | Stock prices, earnings, financials       |
| `valyuPaperSearch`     | Academic papers (PubMed, arXiv, bioRxiv) |
| `valyuBioSearch`       | Clinical trials, FDA labels, biomedical  |
| `valyuPatentSearch`    | USPTO patents                            |
| `valyuSecSearch`       | SEC filings (10-K, 10-Q, 8-K)            |
| `valyuEconomicsSearch` | BLS, FRED, World Bank data               |
| `valyuCompanyResearch` | Comprehensive company reports            |

## Quick Start

<Steps>
  <Step title="Simple Usage">
    ```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    import { Agent } from 'praisonai';
    import { valyuFinanceSearch, valyuSecSearch } from 'praisonai/tools';

    const agent = new Agent({
      name: 'FinanceAnalyst',
      instructions: 'You analyze financial data and SEC filings.',
      tools: [valyuFinanceSearch(), valyuSecSearch()],
    });

    const result = await agent.run('What is Apple\'s latest quarterly revenue?');
    console.log(result.text);
    ```
  </Step>

  <Step title="With Configuration">
    Adjust agent instructions, tool options, and provider settings for production — see the Configuration section below.
  </Step>
</Steps>

## Finance Search

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { valyuFinanceSearch } from 'praisonai/tools';

const financeTool = valyuFinanceSearch({
  // Data types to include
  includeStockPrices: true,
  includeEarnings: true,
  includeIncomeStatements: true,
  includeCashFlows: true,
});

const agent = new Agent({
  name: 'StockAnalyst',
  tools: [financeTool],
});
```

## Academic Paper Search

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { valyuPaperSearch } from 'praisonai/tools';

const paperTool = valyuPaperSearch({
  // Sources to search
  sources: ['arxiv', 'pubmed', 'biorxiv', 'medrxiv'],
  // Full text search
  fullText: true,
});

const agent = new Agent({
  name: 'ResearchAssistant',
  tools: [paperTool],
});
```

## Biomedical Search

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { valyuBioSearch } from 'praisonai/tools';

const bioTool = valyuBioSearch({
  // Include clinical trials
  includeClinicalTrials: true,
  // Include FDA drug labels
  includeFDALabels: true,
});
```

## Patent Search

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { valyuPatentSearch } from 'praisonai/tools';

const patentTool = valyuPatentSearch({
  // USPTO patents
  database: 'uspto',
});
```

## SEC Filings Search

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { valyuSecSearch } from 'praisonai/tools';

const secTool = valyuSecSearch({
  // Filing types
  filingTypes: ['10-K', '10-Q', '8-K'],
});
```

## Economics Data Search

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { valyuEconomicsSearch } from 'praisonai/tools';

const econTool = valyuEconomicsSearch({
  // Data sources
  sources: ['bls', 'fred', 'worldbank'],
});
```

## Company Research

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { valyuCompanyResearch } from 'praisonai/tools';

const companyTool = valyuCompanyResearch({
  // Comprehensive reports
  includeFinancials: true,
  includeNews: true,
  includeFilings: true,
});
```

## Advanced Example

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Agent } from 'praisonai';
import { 
  valyuFinanceSearch, 
  valyuSecSearch, 
  valyuCompanyResearch 
} from 'praisonai/tools';

const agent = new Agent({
  name: 'InvestmentAnalyst',
  instructions: `You are an investment analyst.
    Use financial data, SEC filings, and company research
    to provide comprehensive investment analysis.`,
  tools: [
    valyuFinanceSearch(),
    valyuSecSearch(),
    valyuCompanyResearch(),
  ],
});

const result = await agent.run(`
  Analyze Tesla's financial health:
  1. Recent stock performance
  2. Latest 10-K highlights
  3. Revenue trends
`);
console.log(result.text);
```

## Response Format

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
interface ValyuSearchResult {
  results: Array<{
    title: string;
    url?: string;
    content: string;
    source: string;
    date?: string;
    metadata?: Record<string, unknown>;
  }>;
  query: string;
}
```

## Best Practices

<AccordionGroup>
  <Accordion title="Guidelines">
    1. **Use specific tools** - Choose the right tool for your domain
    2. **Combine tools** - Use multiple tools for comprehensive analysis
    3. **Filter by source** - Narrow down to relevant data sources
    4. **Check dates** - Financial data is time-sensitive
  </Accordion>
</AccordionGroup>

## Related Tools

* [Exa](/docs/js/tools/exa) - General web search
* [Perplexity](/docs/js/tools/perplexity) - Real-time search