🌐 @yylan/pi-web-tools

Web search & content tools for pi — powered by Tavily and Jina AI.

📦 Tools Included

Tavily Search

| Tool | Description | |------|-------------| | search | Web search via Tavily API, with AI-generated summaries |

Jina AI Tools

| Tool | Description | |------|-------------| | jina_read_url | Fetch a URL and convert to clean Markdown | | jina_read_urls | Batch-fetch multiple URLs at once | | jina_search | Web search via Jina AI | | jina_embed | Convert text to vector embeddings | | jina_rerank | Re-rank documents by relevance to a query |

🔧 Installation

pi install npm:@yylan/pi-web-tools

Then reload pi (/reload) or restart.

🔑 API Key Configuration

This package requires no hardcoded API keys. Configure your keys through environment variables:

Option 1: Configure in ~/.pi/agent/settings.json

{
  "env": {
    "TAVILY_API_KEY": "tvly-your-key-here",
    "JINA_API_KEY": "jina-your-key-here"
  }
}

Option 2: Set environment variables

export TAVILY_API_KEY="tvly-your-key-here"
export JINA_API_KEY="jina-your-key-here"

Get your free API keys:

• Tavily: https://tavily.com
• Jina AI: https://jina.ai

📋 Usage

Once installed and configured, pi will automatically load all tools. You can then ask pi to:

• "Search for the latest AI news"
• "Fetch the content from https://example.com"
• "Generate embeddings for these documents"
• "Re-rank these search results"

📁 Package Structure

pi-web-tools/
├── package.json           # Pi package manifest
├── README.md
├── extensions/
│   ├── search-tool.ts     # Tavily search extension
│   └── jina-tools.ts      # Jina AI tools extension (5 tools)