web_search
web_search
Search the web using the Google Custom Search API. Results are filtered for quality and summarized for voice delivery.
Tools: web_search
Requirements: Google Custom Search API key + Search Engine ID
Multi-instance: Yes (use different tool_name and search_engine_id per instance)
api_key
Google API key with Custom Search JSON API enabled.
search_engine_id
Programmable Search Engine ID from Google.
num_results
Number of search results to return (1-10).
delay
Delay between scraping pages in seconds. Ignored when parallel_scrape is True.
max_content_length
Maximum total response size in characters.
oversample_factor
How many extra results to fetch for quality filtering (e.g., 2.5 fetches 2.5x the
requested number). Range: 1.0-3.5.
min_quality_score
Quality threshold for filtering results (0.0-1.0).
no_results_message
Message to show when no quality results are found. Use {query} as a placeholder
for the search query.
per_page_timeout
Maximum seconds to wait on a single page scrape. Minimum 0.1.
overall_deadline
Wall-clock budget in seconds for the whole tool call. In-flight scrapes are abandoned
past this point so the response beats the webhook timeout. Minimum 1.0.
parallel_scrape
Scrape all candidate pages concurrently in a thread pool instead of sequentially.
snippets_only
Skip page scraping entirely and return Google CSE snippets only. Fastest mode (sub-second).
response_prefix
Optional text prepended to every non-empty search result.
response_postfix
Optional text appended to every non-empty search result.
tool_name
Custom function name.