# Send Valyu Search to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "valyu-search",
    "name": "Valyu Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/unicodeveloper/valyu-search",
    "canonicalUrl": "https://clawhub.ai/unicodeveloper/valyu-search",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/valyu-search",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=valyu-search",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/valyu.mjs"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/valyu-search"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/valyu-search",
    "downloadUrl": "https://openagent3.xyz/downloads/valyu-search",
    "agentUrl": "https://openagent3.xyz/skills/valyu-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/valyu-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/valyu-search/agent.md"
  }
}
```
## Documentation

### 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

ParameterTypeDescriptionquerystringSearch query (required)searchTypestring"web", "proprietary", "news", or "all" (default: "all")maxNumResultsnumber1-20 (default: 10)includedSourcesstring[]Limit to specific sources (e.g., ["valyu/valyu-arxiv"])excludedSourcesstring[]Exclude specific sourcesstartDatestringFilter from date (YYYY-MM-DD)endDatestringFilter to date (YYYY-MM-DD)countryCodestringISO 3166-1 alpha-2 (e.g., "US", "GB")responseLengthstring"short", "medium", "large", "max"fastModebooleanReduced latency modecategorystringNatural language category (e.g., "academic research")relevanceThresholdnumber0.0-1.0 (default: 0.5)

### Available Proprietary Sources

SourceDescriptionvalyu/valyu-arxivAcademic papers from arXivvalyu/valyu-pubmedMedical and life science literaturevalyu/valyu-stocksGlobal 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

ParameterTypeDescriptionurlsstring[]Array of URLs to extract (required)responseLengthstringOutput length: "short", "medium", "large", "max"extractEffortstring"auto", "lightweight", "moderate", "heavy"jsonSchemaobjectJSON 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

ParameterTypeDescriptionquerystringQuestion or query (required)searchTypestringSearch scope: "web", "proprietary", "news", "all"outputSchemaobjectJSON Schema for structured responses

### 4. DeepResearch API

Launch async, multi-step research tasks that produce detailed reports with citations.

### Modes

ModeDurationUse Casefast~5 minQuick answers, lightweight researchstandard~10-20 minBalanced research with deeper insightsheavy~90 minIn-depth, complex analysis

### Usage

node {baseDir}/scripts/valyu.mjs deepresearch create "AI market trends" --mode heavy --pdf

### Parameters

ParameterTypeDescriptionquerystringResearch query (required)modestring"fast", "standard", "heavy"outputFormatsarray["markdown"], ["pdf"], or JSON Schema objectfilesarrayFile attachments (base64 encoded, max 10)urlsstring[]URLs to analyze (max 10)webhookUrlstringHTTPS URL for completion notification

### Choosing the Right API

NeedAPIQuick facts, current events, citationsSearchRead/parse a specific URLContentsAI-synthesized answer with sourcesAnswerIn-depth analysis or reportDeepResearch

### References

Valyu Docs
Search API Reference
Contents API Reference
Answer API Reference
DeepResearch Guide
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: unicodeveloper
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/valyu-search)
- [Send to Agent page](https://openagent3.xyz/skills/valyu-search/agent)
- [JSON manifest](https://openagent3.xyz/skills/valyu-search/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/valyu-search/agent.md)
- [Download page](https://openagent3.xyz/downloads/valyu-search)