free_search_advanced
Read-onlyIdempotent
Perform filtered multi-source searches with domain control and confidence scoring. Supports Chinese content and waterfall progressive search to reduce engine calls.
Instructions
Advanced search with filters and quality control.
Best for: Domain filtering, high-confidence only, Chinese content. Not recommended for: Simple queries — use free_search instead.
@readOnly true @idempotent true — runs waterfall progressive search across policy-allowed engines. Makes outbound HTTP requests to search engines and optionally to Jina Reader for content enrichment.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of results (1-20) | |
| query | Yes | Search query | |
| enrich | No | Enable content enrichment (extract full page for low-confidence results) | |
| language | No | Language preference | auto |
| waterfall | No | Enable waterfall progressive search (saves engine calls) | |
| enrich_max | No | Max results to enrich per search | |
| time_range | No | Deprecated compatibility field; returns UNSUPPORTED_FILTER because general-search recency is not enforced end to end | |
| min_confidence | No | Minimum source-reliability confidence (0-1). Legacy values 2-3 are treated as min_source_count. | |
| exclude_domains | No | Exclude these domains | |
| include_domains | No | Only search these domains | |
| min_source_count | No | Minimum independent upstream provider families; current adapters expose at most 12 | |
| waterfall_min_results | No | Minimum results per phase for waterfall confidence check | |
| waterfall_min_confidence | No | Minimum average confidence to stop waterfall early |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | Yes | ||
| query | Yes | ||
| engines | Yes | ||
| results | Yes | ||
| cache_hit | No | ||
| rate_limits | No | ||
| security_note | Yes | ||
| partialFailures | No | ||
| detected_language | No |