Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/zeroclaw-labs/zeroclaw/llms.txt

Use this file to discover all available pages before exploring further.

The web search tool enables agents to search the internet and retrieve information.

​
Overview

The web search tool provides:
  • Multiple search engine backends
  • Result aggregation and ranking
  • Web page content extraction
  • Rate limiting and caching

​
Parameters

​
query
string
required
Search query string
​
num_results
integer
Number of results to return (default: 5, max: 10)
​
fetch_content
boolean
Whether to fetch full page content (default: false)

​
Example

{
  "query": "ZeroClaw Rust agent framework",
  "num_results": 5,
  "fetch_content": true
}

​
Response

​
results
array
Array of search results

​
Example Response

{
  "results": [
    {
      "title": "ZeroClaw - GitHub",
      "url": "https://github.com/zeroclaw-labs/zeroclaw",
      "snippet": "Fast, small, and fully autonomous AI agent framework",
      "content": "ZeroClaw is a lightweight Rust framework..."
    }
  ]
}

​
Search Backends

Privacy-focused search with no API key required.Features:
  • No tracking
  • No API key needed
  • Good for general queries
  • Rate limited

​
Configuration

[tools]
web_search_enabled = true
search_backend = "duckduckgo"  # or "google", "brave"
max_search_results = 10

[tools.search]
cache_ttl_seconds = 3600
request_timeout_seconds = 10
user_agent = "ZeroClaw/0.1.8"

​
Rate Limiting

To avoid overwhelming search engines:
  • DuckDuckGo: 1 request per second
  • Google: 100 queries per day (free tier)
  • Brave: 2000 queries per month (free tier)
Results are cached for 1 hour by default.

​
Content Extraction

When fetch_content=true, the tool:
  1. Fetches the full HTML page
  2. Extracts main content (removes ads, navigation)
  3. Converts HTML to plain text or markdown
  4. Truncates to 10,000 characters
Fetching content significantly increases response time and may trigger rate limits.

​
Security

  • HTTPS enforcement
  • Domain allowlist (optional)
  • Content size limits
  • Request timeouts
  • XSS prevention in extracted content
[security]
web_search_allowed_domains = [
    "*.github.com",
    "*.wikipedia.org",
    "docs.rs"
]

​
Examples

zeroclaw agent -m "Search for Rust async best practices"
The agent will use web_search tool automatically.

​
Fetch Full Content

zeroclaw agent -m "Find and summarize the latest Rust 1.87 release notes"

​
Source Code

Implementation: src/tools/web_search.rs