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