Skip to main content
Best for: using Valyu yourself. Search, answer, extract, and research directly inside Claude Code. This is a community-maintained plugin by GhouI - for official integrations, see Remote MCP or the Valyu API directly.
Direct access to Valyu’s search APIs from Claude Code over a zero-dependency CLI - real-time web, academic, financial, biomedical, patent, SEC, economics, and news search, plus answers, content extraction, and deep research.

Paste into Claude Code to install and use the Valyu search plugin.

Open in Cursor
Key features:
  • Zero dependencies - Direct API calls using Node.js built-in fetch
  • 8 search types - Web, finance, academic, biomedical, patents, SEC, economics, and news
  • AI-powered answers - Get answers with source citations
  • Content extraction - Extract clean content from any URL
  • Deep research - Async research reports for complex topics

​
Installation

Install the plugin from the Claude Code marketplace: 
# Add the marketplace
/plugin marketplace add valyuAI/valyu-search-plugin

# Install the plugin
/plugin install valyu-search-plugin@valyu-marketplace

​
API Key Setup

Get your API key from platform.valyu.ai with $10 free credits ($20 with a work email). Just start using the plugin! On first use, Claude will:
  1. Detect that no API key is configured
  2. Ask you to paste your API key
  3. Save it automatically to ~/.valyu/config.json
  4. Retry your search
You: Valyu(web, "AI news 2025")
Claude: "To use Valyu search, I need your API key. Get one free at https://platform.valyu.ai"
You: val_abc123...
Claude: [saves key and runs search]

​
Manual Setup (Alternative)

If you prefer to set up manually:
For Zsh (macOS default):
echo 'export VALYU_API_KEY="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc
For Bash:
echo 'export VALYU_API_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc
Key Lookup Priority:
  1. VALYU_API_KEY environment variable
  2. ~/.valyu/config.json file

​
Usage

You can use the plugin with either natural language or the structured syntax:
Simply ask Claude to search for what you need:
Search the web for AI developments in 2025
Find academic papers on transformer neural networks
Look up Apple's Q4 2024 earnings
Search for clinical trials on cancer immunotherapy
Claude will automatically use the appropriate Valyu search tool based on your query.

​
Search Examples

Valyu(web, "AI developments 2025", 10)

Valyu(bio, "cancer immunotherapy clinical trials")

Valyu(finance, "Apple Q4 2024 earnings", 8)

Valyu(paper, "transformer neural networks", 15)

Valyu(patent, "renewable energy storage battery")

Valyu(sec, "Tesla 10-K risk factors")

Valyu(economics, "US unemployment rate trends")

Valyu(news, "tech industry layoffs 2025")

​
Answer

Get AI-powered answers with source citations: 
Valyu(answer, "What is quantum computing?")
Valyu(answer, "Latest AI news", --fast)

​
Contents

Extract clean content from URLs: 
Valyu(contents, "https://example.com/article")
Valyu(contents, "https://example.com", --summary)

​
DeepResearch

Create async research reports for complex topics: 
# Create a new research task
Valyu(deepresearch, create, "AI market trends 2025")

# Check status of a research task
Valyu(deepresearch, status, "task-id-here")

​
Search Types

TypeDescriptionData Sources
webGeneral web searchReal-time web content
financeFinancial dataStocks, earnings, SEC filings, crypto
paperAcademic papersarXiv, PubMed, scholarly journals
bioBiomedical researchPubMed, clinical trials, FDA drug labels
patentPatent databasesUSPTO, global patent data
secSEC regulatory filings10-K, 10-Q, 8-K documents
economicsEconomic indicatorsBLS, FRED, World Bank
newsNews articlesReal-time news sources

​
Output Format

All commands return structured JSON results: 
{
  "success": true,
  "type": "search",
  "searchType": "web",
  "query": "AI news",
  "resultCount": 10,
  "results": [
    {
      "title": "Article Title",
      "url": "https://example.com",
      "content": "Full content...",
      "source": "web",
      "relevance_score": 0.95
    }
  ],
  "cost": 0.025
}

​
Requirements

  • Node.js 18+ (for built-in fetch API)
  • Valyu API key (get $10 free credits ($20 with a work email) at platform.valyu.ai)

​
Additional Resources

GitHub Repository

View source code and contribute

Get API Key

Sign up for $10 free credits ($20 with a work email)

API Reference

Complete Valyu API documentation

Remote MCP

Use Valyu with MCP protocol

​
Support

This is a community-maintained plugin. For issues or contributions: