Execute a search and return ranked Markdown results (title, URL, snippet).
## Two modes
### Mode 1 — General web search (no list_domains needed)
Omit domain and sub_domain entirely. Use when the query is open-ended and does not target a specific structured data source.
Example: search(query="what is quantum computing")
### Mode 2 — Vertical search (call list_domains first)
Use when the query targets a specific domain: stocks, patents, flights, CVEs, weather, academic papers, etc.
Steps:
1. Call list_domains to get the sub_domain and mandatory query format for the target domain.
2. Pass domain + sub_domain from list_domains output. Never guess them.
3. Format query exactly as specified in the query_format column — wrong format = wrong results.
**IMPORTANT: For any query that may belong to a supported vertical domain, ALWAYS call list_domains first — vertical search produces significantly better results than general web search.**
## Decision rule — which mode to use
Use Mode 2 (vertical) when ANY of these apply:
- Query involves a ticker, DOI, CVE, IATA code, patent number, address, or other structured identifier
- Query targets a specific vertical: finance, legal, academic, security, travel, geo, environment, etc.
- User asks for real-time or specialized data (stock price, weather, flight status, drug info, etc.)
Use Mode 1 (general) when the query is purely conversational or open-ended with no structured lookup.
## After getting results — when to call extract
Search returns titles + snippets only. Call extract when:
- The snippet is truncated or insufficient to answer the question
- User asks to read, summarize, or get details from a specific URL
- You need to verify a claim or fact from the source page
- The answer requires data only visible in the page body (tables, sections not in snippet)
## Query decomposition
One intent per search call. For 2–5 independent queries use batch_search instead.
WRONG: search(query="AAPL price and earnings and analyst rating")
RIGHT: batch_search(queries=[{query:"AAPL price",...}, {query:"AAPL earnings",...}])