Skip to main content

Why Use This Plugin?

Claude Code is beloved for being infinitely hackable, but Anthropic’s built-in web_search and web_fetch tools are limited with zero configurability. The Tavily plugin gives developers low-level control to build custom web tooling directly in their terminal. This plugin brings Tavily’s services (research, parallel web crawling, and search) right where you work. The real-time context these tools provide significantly enhances Claude’s capabilities for development tasks. Most importantly, the tavily-api-expert skill turns Claude into a true Tavily expert. Instead of reading API docs, just ask Claude how to integrate Tavily into your project. All API best practices are baked in, dramatically accelerating your build process.

What You Can Build

Copy-paste these prompts into Claude Code and start building:
Build an autonomous agent that monitors competitors and surfaces insights.Try these prompts:
/tavily-api-expert Help me build an agent that researches competitor pricing
and feature updates. I want it to run weekly and output a structured report.
/tavily-api-expert Create a competitive analysis tool that tracks product
launches from a list of companies and alerts me to changes.
/research What are the latest product announcements from Notion in the last 30 days?
Ground your AI responses with real-time verification against live sources.Try these prompts:
/tavily-api-expert I need to add a fact-checking layer to my chatbot. When users
ask about current events or statistics, I want to verify claims against live web data.
/tavily-api-expert Build a verification pipeline that cross-references LLM
outputs with authoritative sources before responding to users.
/tavily-api-expert How do I integrate Tavily search into my chatbot so it can
call the tool when it needs up-to-date web information?
Create automated news tracking for your industry with smart filtering.Try these prompts:
/tavily-api-expert Help me build a news monitoring agent that tracks AI
industry news, filters for relevance, and sends daily Slack summaries.
/tavily-api-expert Create a news pipeline that monitors specific topics,
deduplicates stories, and ranks by importance before alerting my team.
/research What are the major AI announcements from the past week?
The /tavily-api-expert skill is your fastest path to production. Describe what you want to build and Claude generates working code with best practices baked in.

Installation

Prerequisites

Step 1: Configure Your API Key

Add your Tavily API key to your Claude Code settings file:
# Open your Claude settings file
open -e "$HOME/.claude/settings.json"

# Or with VS Code
code "$HOME/.claude/settings.json"
Add the following configuration:
{
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR_API_KEY"
  }
}
Replace tvly-YOUR_API_KEY with your actual Tavily API key from app.tavily.com

Step 2: Install the Plugin

Step 3: Restart Claude Code

After installation, restart Claude Code to load the plugin:
/clear
Then press Ctrl+C to exit and restart Claude Code.

Available Skills

Tavily API Expert

Skip the docs—Claude becomes your Tavily expert. This skill contains all API best practices and implementation patterns, so you can build integrations through conversation instead of documentation.Invoke explicitly:
/tavily-api-expert
Example prompts:
  • “Add Tavily search to my agent so it can look up current information”
  • “What parameters does the Tavily extract API accept?”
  • “Help me implement Tavily in a RAG pipeline”
Get AI-synthesized research on any topic with citations directly in your terminal. Supports structured JSON output for integration into pipelines.Invoke explicitly:
/research
Example prompts:
  • “Research the latest developments in quantum computing”
  • “What are the current best practices for React Server Components?”
  • “Research the competitive landscape for AI coding assistants”
Crawl any website and save pages as local markdown files. Perfect for downloading documentation, knowledge bases, or web content for offline access or analysis.Invoke explicitly:
/crawl-url
Example prompts:
  • “Crawl the Stripe API docs and save them locally”
  • “Download the Next.js documentation for offline reference”
  • “Crawl this knowledge base: https://docs.example.com
Find the best current deals and coupons for any product. Searches the web for promotions and returns results for analysis.Invoke explicitly:
/deal-hunt
Example prompts:
  • “Find the best deals on AirPods Pro right now”
  • “Search for discounts on MacBook Pro M3”
  • “What are the current promotions for GitHub Copilot?”

Usage Examples

Automatic Skill Invocation

Claude Code will automatically use Tavily skills when appropriate. Simply describe what you need:
Research the latest developments in AI agents and summarize the key trends
I need to build an agent with web search - help me integrate Tavily
Download the Prisma documentation so I can reference it offline

Explicit Skill Invocation

You can also invoke skills directly using slash commands:
/research What are the best practices for building LLM-powered applications in 2024?
/crawl-url https://docs.tavily.com

Troubleshooting

If skills don’t appear after installation:
  1. Run /clear to refresh the session
  2. Exit Claude Code with Ctrl+C
  3. Restart Claude Code
  4. Verify installation with /plugin list