Valyu Search
Search across the world's knowledge.
When to Use
Trigger this skill when the user asks for:
- "search the web", "web search", "look up", "find online", "find papers on..."
- "current news about...", "latest updates on..."
- "research [topic]", "what's happening with...", "deep research on..."
- "extract content from [URL]", "scrape this page", "get the text from..."
- "answer this with sources", "what does the research say about..."
- Fact-checking with citations needed
- Academic, medical, financial, or patent research
- Structured data extraction from web pages
Prerequisites
- Get an API key at valyu.ai
- Set
VALYU_API_KEY in the Gateway environment (recommended) or in ~/.openclaw/.env.
Commands
Run a search across the web:
node {baseDir}/scripts/valyu.mjs search web "<query>"
Search across news, academic papers, financial data, patents and more
node {baseDir}/scripts/valyu.mjs search news "<query>"
Parameters
| Parameter |
Type |
Description |
query |
string |
Search query (required) |
searchType |
string |
"web", "proprietary", "news", or "all" (default: "all") |
maxNumResults |
number |
1-20 (default: 10) |
includedSources |
string[] |
Limit to specific sources (e.g., ["valyu/valyu-arxiv"]) |
excludedSources |
string[] |
Exclude specific sources |
startDate |
string |
Filter from date (YYYY-MM-DD) |
endDate |
string |
Filter to date (YYYY-MM-DD) |
countryCode |
string |
ISO 3166-1 alpha-2 (e.g., "US", "GB") |
responseLength |
string |
"short", "medium", "large", "max" |
fastMode |
boolean |
Reduced latency mode |
category |
string |
Natural language category (e.g., "academic research") |
relevanceThreshold |
number |
0.0-1.0 (default: 0.5) |
Available Proprietary Sources
| Source |
Description |
valyu/valyu-arxiv |
Academic papers from arXiv |
valyu/valyu-pubmed |
Medical and life science literature |
valyu/valyu-stocks |
Global stock market data |
Additional sources: BioRxiv, MedRxiv, clinical trials, FDA drug labels, WHO health data, SEC filings, USPTO patents, Wikipedia, UK Parliament, UK National Rail, maritime vessel tracking, and more.
2. Contents API
Extract clean, structured content from any URL. Converts web pages to markdown or structured data.
Usage
node {baseDir}/scripts/valyu.mjs contents "https://example.com" --summary
Parameters
| Parameter |
Type |
Description |
urls |
string[] |
Array of URLs to extract (required) |
responseLength |
string |
Output length: "short", "medium", "large", "max" |
extractEffort |
string |
"auto", "lightweight", "moderate", "heavy" |
jsonSchema |
object |
JSON Schema for structured extraction |
3. Answer API
Get AI-generated answers grounded in real-time search results with citations.
Usage
node {baseDir}/scripts/valyu.mjs answer "What is quantum computing?" --fast
Parameters
| Parameter |
Type |
Description |
query |
string |
Question or query (required) |
searchType |
string |
Search scope: "web", "proprietary", "news", "all" |
outputSchema |
object |
JSON Schema for structured responses |
4. DeepResearch API
Launch async, multi-step research tasks that produce detailed reports with citations.
Modes
| Mode |
Duration |
Use Case |
fast |
~5 min |
Quick answers, lightweight research |
standard |
~10-20 min |
Balanced research with deeper insights |
heavy |
~90 min |
In-depth, complex analysis |
Usage
node {baseDir}/scripts/valyu.mjs deepresearch create "AI market trends" --mode heavy --pdf
Parameters
| Parameter |
Type |
Description |
query |
string |
Research query (required) |
mode |
string |
"fast", "standard", "heavy" |
outputFormats |
array |
["markdown"], ["pdf"], or JSON Schema object |
files |
array |
File attachments (base64 encoded, max 10) |
urls |
string[] |
URLs to analyze (max 10) |
webhookUrl |
string |
HTTPS URL for completion notification |
Choosing the Right API
| Need |
API |
| Quick facts, current events, citations |
Search |
| Read/parse a specific URL |
Contents |
| AI-synthesized answer with sources |
Answer |
| In-depth analysis or report |
DeepResearch |
References
1---2name: valyu-search3description: Use Valyu (valyu.ai) to search the web, extract content from web pages, answer with sources, and do deepresearch.4---5
6# Valyu Search
7
8Search across the world's knowledge.
9
10## When to Use
11
12Trigger this skill when the user asks for:
13- "search the web", "web search", "look up", "find online", "find papers on..."
14- "current news about...", "latest updates on..."
15- "research [topic]", "what's happening with...", "deep research on..."
16- "extract content from [URL]", "scrape this page", "get the text from..."
17- "answer this with sources", "what does the research say about..."
18- Fact-checking with citations needed
19- Academic, medical, financial, or patent research
20- Structured data extraction from web pages
21
22## Prerequisites
23
24- Get an API key at [valyu.ai](https://www.valyu.ai)
25- Set `VALYU_API_KEY` in the Gateway environment (recommended) or in `~/.openclaw/.env`.
26---
27
28## Commands
29
30Run a search across the web:
31
32```bash
33node {baseDir}/scripts/valyu.mjs search web "<query>"
34```
35
36Search across news, academic papers, financial data, patents and more
37
38```bash
39node {baseDir}/scripts/valyu.mjs search news "<query>"
40```
41
42### Parameters
43
44| Parameter | Type | Description |
45|-----------|------|-------------|
46| `query` | string | Search query (required) |
47| `searchType` | string | `"web"`, `"proprietary"`, `"news"`, or `"all"` (default: `"all"`) |
48| `maxNumResults` | number | 1-20 (default: 10) |
49| `includedSources` | string[] | Limit to specific sources (e.g., `["valyu/valyu-arxiv"]`) |
50| `excludedSources` | string[] | Exclude specific sources |
51| `startDate` | string | Filter from date (YYYY-MM-DD) |
52| `endDate` | string | Filter to date (YYYY-MM-DD) |
53| `countryCode` | string | ISO 3166-1 alpha-2 (e.g., `"US"`, `"GB"`) |
54| `responseLength` | string | `"short"`, `"medium"`, `"large"`, `"max"` |
55| `fastMode` | boolean | Reduced latency mode |
56| `category` | string | Natural language category (e.g., `"academic research"`) |
57| `relevanceThreshold` | number | 0.0-1.0 (default: 0.5) |
58
59### Available Proprietary Sources
60
61| Source | Description |
62|--------|-------------|
63| `valyu/valyu-arxiv` | Academic papers from arXiv |
64| `valyu/valyu-pubmed` | Medical and life science literature |
65| `valyu/valyu-stocks` | Global stock market data |
66
67Additional sources: BioRxiv, MedRxiv, clinical trials, FDA drug labels, WHO health data, SEC filings, USPTO patents, Wikipedia, UK Parliament, UK National Rail, maritime vessel tracking, and more.
68
69## 2. Contents API
70
71Extract clean, structured content from any URL. Converts web pages to markdown or structured data.
72
73### Usage
74
75```bash
76node {baseDir}/scripts/valyu.mjs contents "https://example.com" --summary
77```
78
79### Parameters
80
81| Parameter | Type | Description |
82|-----------|------|-------------|
83| `urls` | string[] | Array of URLs to extract (required) |
84| `responseLength` | string | Output length: `"short"`, `"medium"`, `"large"`, `"max"` |
85| `extractEffort` | string | `"auto"`, `"lightweight"`, `"moderate"`, `"heavy"` |
86| `jsonSchema` | object | JSON Schema for structured extraction |
87
88
89## 3. Answer API
90
91Get AI-generated answers grounded in real-time search results with citations.
92
93### Usage
94
95```bash
96node {baseDir}/scripts/valyu.mjs answer "What is quantum computing?" --fast
97```
98
99### Parameters
100
101| Parameter | Type | Description |
102|-----------|------|-------------|
103| `query` | string | Question or query (required) |
104| `searchType` | string | Search scope: `"web"`, `"proprietary"`, `"news"`, `"all"` |
105| `outputSchema` | object | JSON Schema for structured responses |
106
107
108## 4. DeepResearch API
109
110Launch async, multi-step research tasks that produce detailed reports with citations.
111
112### Modes
113
114| Mode | Duration | Use Case |
115|------|----------|----------|
116| `fast` | ~5 min | Quick answers, lightweight research |
117| `standard` | ~10-20 min | Balanced research with deeper insights |
118| `heavy` | ~90 min | In-depth, complex analysis |
119
120### Usage
121
122```bash
123node {baseDir}/scripts/valyu.mjs deepresearch create "AI market trends" --mode heavy --pdf
124```
125
126### Parameters
127
128| Parameter | Type | Description |
129|-----------|------|-------------|
130| `query` | string | Research query (required) |
131| `mode` | string | `"fast"`, `"standard"`, `"heavy"` |
132| `outputFormats` | array | `["markdown"]`, `["pdf"]`, or JSON Schema object |
133| `files` | array | File attachments (base64 encoded, max 10) |
134| `urls` | string[] | URLs to analyze (max 10) |
135| `webhookUrl` | string | HTTPS URL for completion notification |
136
137## Choosing the Right API
138
139| Need | API |
140|------|-----|
141| Quick facts, current events, citations | **Search** |
142| Read/parse a specific URL | **Contents** |
143| AI-synthesized answer with sources | **Answer** |
144| In-depth analysis or report | **DeepResearch** |
145
146## References
147
148- [Valyu Docs](https://docs.valyu.ai)
149- [Search API Reference](https://docs.valyu.ai/api-reference/endpoint/search)
150- [Contents API Reference](https://docs.valyu.ai/api-reference/endpoint/contents)
151- [Answer API Reference](https://docs.valyu.ai/api-reference/endpoint/answer)
152- [DeepResearch Guide](https://docs.valyu.ai/guides/deepresearch)
modbender