Web Search Tool: Tavily & Brave Search Integration

The web search tool enables PocketPaw to search the internet for real-time information.

Providers

Two search providers are supported:

Tavily is an AI-optimized search API that returns clean, structured results.

Terminal window
export POCKETPAW_WEB_SEARCH_PROVIDER="tavily"
export POCKETPAW_TAVILY_API_KEY="tvly-your-key"

Brave Search offers a privacy-focused search API.

Terminal window
export POCKETPAW_WEB_SEARCH_PROVIDER="brave"
export POCKETPAW_BRAVE_SEARCH_API_KEY="your-key"

Usage

The agent can use web search automatically when it needs to find information:

User: What's the latest version of Python?
Agent: [uses web_search tool] → Python 3.13 is the latest stable version...

Tool Schema

{
  "name": "web_search",
  "description": "Search the web for current information",
  "input_schema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "The search query"
      },
      "max_results": {
        "type": "integer",
        "description": "Maximum number of results (default: 5)"
      }
    },
    "required": ["query"]
  }
}

Policy Group

The web search tool belongs to group:search. To control access:

Terminal window
# Allow web search
export POCKETPAW_TOOLS_ALLOW="group:search"


# Or deny it
export POCKETPAW_TOOLS_DENY="web_search"

Research Tool

Chain web search with content fetching and LLM summarization for deeper answers.

Browser Automation

Navigate and interact with web pages directly using Playwright.

Tools Overview

Browse all 50+ built-in tools available in PocketPaw.

Last updated: April 29, 2026
1 min read
Edit this page