Claude Code Plugin

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).

Automatic Setup (Recommended)

Just start using the plugin! On first use, Claude will:

Detect that no API key is configured
Ask you to paste your API key
Save it automatically to ~/.valyu/config.json
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:

Environment Variable
Config File
VSCode Settings

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

mkdir -p ~/.valyu
echo '{"apiKey": "your-api-key-here"}' > ~/.valyu/config.json

Add to your settings.json:

{
  "terminal.integrated.env.osx": {
    "VALYU_API_KEY": "your-api-key-here"
  }
}

Key Lookup Priority:

VALYU_API_KEY environment variable
~/.valyu/config.json file

Usage

You can use the plugin with either natural language or the structured syntax:

Natural Language
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.

Use the explicit syntax for precise control:

Valyu(searchType, "query", maxResults)

Search Types: web, finance, paper, bio, patent, sec, economics, news

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)

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

Type	Description	Data Sources
`web`	General web search	Real-time web content
`finance`	Financial data	Stocks, earnings, SEC filings, crypto
`paper`	Academic papers	arXiv, PubMed, scholarly journals
`bio`	Biomedical research	PubMed, clinical trials, FDA drug labels
`patent`	Patent databases	USPTO, global patent data
`sec`	SEC regulatory filings	10-K, 10-Q, 8-K documents
`economics`	Economic indicators	BLS, FRED, World Bank
`news`	News articles	Real-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

API Reference

Complete Valyu API documentation

Remote MCP

Use Valyu with MCP protocol

Support

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

GitHub Issues: Report issues or request features
Discord: Join the Valyu community

Agents & MCP

Automation Platforms

Work Platforms

Framework SDKs

Community SDKs

LLM Providers

Claude Code Plugin

Installation

API Key Setup

Automatic Setup (Recommended)

Manual Setup (Alternative)

Usage

Search Examples

Answer

Contents

DeepResearch

Search Types

Output Format

Requirements

Additional Resources

GitHub Repository

Get API Key

API Reference

Remote MCP

Support

​Installation

​API Key Setup

​Automatic Setup (Recommended)

​Manual Setup (Alternative)

​Usage

​Search Examples

​Answer

​Contents

​DeepResearch

​Search Types

​Output Format

​Requirements

​Additional Resources

GitHub Repository

Get API Key

API Reference

Remote MCP

​Support

Installation

API Key Setup

Automatic Setup (Recommended)

Manual Setup (Alternative)

Usage

Search Examples

Answer

Contents

DeepResearch

Search Types

Output Format

Requirements

Additional Resources

Support