Skip to main content

​
Overview

This is a community-maintained plugin developed by GhouI. For official integrations, see Remote MCP or use the Valyu API directly.
The Valyu Search Plugin for Claude Code provides direct access to Valyu’s search APIs through a simple CLI interface. It enables Claude Code to perform real-time searches across web content, academic papers, financial data, and more. 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 valyu-network/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. 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)

​
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
}

​
Example Queries

  • “Who won the superbowl this year?”
  • “Latest developments in quantum computing”
  • “Best practices for React server components”

​
Academic Research

  • “Find recent papers on transformer architecture improvements”
  • “CRISPR gene editing therapeutic applications”
  • “Climate change mitigation strategies peer-reviewed studies”

​
Financial Analysis

  • “AAPL stock price and recent performance”
  • “Tesla latest quarterly earnings and revenue trends”
  • “Bitcoin price trends this week”

​
SEC Filings

  • “Tesla’s latest 10-K MD&A section”
  • “Apple risk factors from FY2023 annual report”
  • “Microsoft’s business strategy from recent 10-K”

​
Biomedical Research

  • “Find clinical trials for CAR-T therapy in lymphoma”
  • “Latest research on GLP-1 receptor agonists for weight loss”
  • “FDA approvals for mRNA-based therapeutics”
  • “Find patents related to solid-state battery technology”
  • “Machine learning patents filed by Google in 2024”
  • “Prior art search for autonomous vehicle navigation”

​
Economics Data

  • “US unemployment rate trends over the past year”
  • “Federal Reserve interest rate decisions”
  • “World Bank GDP growth data for emerging markets”

​
Requirements

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

​
Additional Resources

GitHub Repository

View source code and contribute

Get API Key

Sign up for free $10 credit

API Reference

Complete Valyu API documentation

Remote MCP

Use Valyu with MCP protocol

​
Support

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