Files
pocketpaw/docs/tools/web-search.mdx
Prakash 57b807c117 docs(seo): optimize titles, descriptions, headings, and cross-links
Comprehensive SEO optimization across 80 documentation pages:

Title optimization (all pages):
- Replaced generic titles like "Architecture", "Discord", "Slack"
  with search-intent titles like "PocketPaw Architecture: Event-Driven
  Message Bus", "Discord Bot Setup: Add PocketPaw to Your Server"
- All titles now 50-70 characters with qualifying keywords

Meta descriptions:
- Expanded 7 short descriptions (under 145 chars) to 150-160 chars
- Roadmap description expanded from 76 to 196 chars
- Troubleshooting, Codex CLI, OpenCode, WebMCP all expanded

H1 heading fixes:
- Ensured single H1 per page matching the frontmatter title
- All H1 headings updated to match new optimized titles

Internal cross-links:
- Added Related CardGroup sections to 60+ individual pages
- Each links to 2-3 related pages within and across sections
- Channels link to channel guides, backends link to Ollama guide, etc.

Em dash cleanup:
- Replaced em dashes with colons, periods, or double hyphens
  across multiple files in tools/, channels/, integrations/

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 17:41:36 +05:30

93 lines
2.4 KiB
Plaintext

---
title: "Web Search Tool: Tavily & Brave Search Integration"
description: "Search the web from PocketPaw using Tavily or Brave Search APIs. Returns structured results the agent can reason over. Configure your preferred search provider with a single environment variable."
section: Tools
ogType: article
keywords: ["web search", "tavily", "brave search", "search api", "internet search"]
tags: ["tools", "search"]
---
# 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 (Recommended)
[Tavily](https://tavily.com) is an AI-optimized search API that returns clean, structured results.
```bash
export POCKETPAW_WEB_SEARCH_PROVIDER="tavily"
export POCKETPAW_TAVILY_API_KEY="tvly-your-key"
```
### Brave Search
[Brave Search](https://brave.com/search/api/) offers a privacy-focused search API.
```bash
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
```json
{
"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:
```bash
# Allow web search
export POCKETPAW_TOOLS_ALLOW="group:search"
# Or deny it
export POCKETPAW_TOOLS_DENY="web_search"
```
## Related
<CardGroup>
<Card title="Research Tool" icon="lucide:book-open" href="/tools/research">
Chain web search with content fetching and LLM summarization for deeper answers.
</Card>
<Card title="Browser Automation" icon="lucide:globe" href="/tools/browser">
Navigate and interact with web pages directly using Playwright.
</Card>
<Card title="Tools Overview" icon="lucide:wrench" href="/tools">
Browse all 50+ built-in tools available in PocketPaw.
</Card>
</CardGroup>