pi-skill-tavily

Tavily web search, extract, crawl, and research skills for the pi coding agent.

Powered by Tavily — an LLM-optimized search API.

Installation

npm install pi-skill-tavily

Or add to your project's package.json:

{
  "devDependencies": {
    "pi-skill-tavily": "^1.0.0"
  }
}

Setup

Get an API key at https://tavily.com and configure it:

Option 1: Environment variable

export TAVILY_API_KEY="tvly-your-api-key-here"

Option 2: Pi settings (~/.pi/settings.json)

{
  "env": {
    "TAVILY_API_KEY": "tvly-your-api-key-here"
  }
}

Available Skills

Skill	Command	Description
Search	/skill:tavily-search	Web search with relevance scores, domain filtering, time ranges
Extract	/skill:tavily-extract	Extract clean markdown/text from specific URLs
Crawl	/skill:tavily-crawl	Crawl websites, save pages as local markdown files
Research	/skill:tavily-research	Comprehensive multi-source research with citations
Best Practices	/skill:tavily-best-practices	Reference docs for building Tavily integrations

Usage Examples

Search

# The agent will automatically use the skill, or invoke directly:
/skill:tavily-search AI news this week

# Script usage:
./skills/tavily-search/scripts/search.sh '{"query": "AI news", "time_range": "week"}'

Extract

/skill:tavily-extract https://docs.python.org/3/tutorial/classes.html

# Script usage:
./skills/tavily-extract/scripts/extract.sh '{"urls": ["https://example.com"]}'

Crawl

/skill:tavily-crawl download docs from https://docs.example.com

# Script usage:
./skills/tavily-crawl/scripts/crawl.sh '{"url": "https://docs.example.com", "max_depth": 2}' ./docs

Research

/skill:tavily-research Compare React vs Vue for enterprise apps in 2025

# Script usage:
./skills/tavily-research/scripts/research.sh '{"input": "React vs Vue comparison", "model": "pro"}' report.md

Requirements

• curl (pre-installed on macOS/Linux)
• jq — install with brew install jq (macOS) or apt-get install jq (Linux)
• A Tavily API key

License

MIT