search
Perform web searches to locate relevant pages, returning titles, URLs, and snippets for quick discovery.
Instructions
Find information across web, academic sources, X/Twitter, or library docs. Returns search result listings (titles, URLs, snippets) -- NOT full page content. To read full content from a URL, use the extract tool instead.
Actions:
search: Web search via SearXNG. Example: search(action="search", query="python async patterns")
research: Academic/scientific search (Google Scholar, arXiv, PubMed). Example: search(action="research", query="transformer attention mechanism")
x: X/Twitter search via xAI. Returns a SYNTHESIZED answer with citations (NOT a link list for extract() -- X blocks direct extraction). Bills ~$0.032/query (grok-4.3). Requires XAI_API_KEY. Example: search(action="x", query="latest reactions to the GPT-5 launch", handles=["OpenAI"], time_range="week")
docs: Search library documentation with auto-indexing. Example: search(action="docs", query="how to create routes", library="fastapi")
docs_resolve: Free-form library name to ranked library_id list. Example: search(action="docs_resolve", query="react")
docs_query: Version-aware library docs query honoring project lock + token cap. Example: search(action="docs_query", library="react", version="latest", topic="useState", query="how to set initial state")
docs_lock_project: Detect project manifests (pyproject/package.json/go.mod/Cargo.toml) and lock the library set for Cabinets isolation. Example: search(action="docs_lock_project", project_path="/repo/my-app")
similar: Find pages similar to a URL (pass URL as query). Example: search(action="similar", query="https://example.com/article")
Key parameters:
query (required for all actions): Search terms or URL (for similar)
library (required for docs): Library name, e.g. "react", "fastapi"
language: Programming language for disambiguation in docs, e.g. "python", "java"
expand: Enable LLM query expansion for broader coverage (default: false)
enrich: Fetch actual page content for richer snippets (default: false, adds latency)
max_results: Number of results (default: 10)
time_range: Recency filter -- day, week, month, year
include_domains / exclude_domains: Domain filters
handles / exclude_handles (x only): Restrict to / exclude up to 20 X handles (mutually exclusive), e.g. handles=["nasa"]
from_date / to_date (x only): ISO8601 date bounds; override time_range for precise windows
video (x only): Enable video understanding of linked X media (default: false)
Use help tool with tool_name="search" for full parameter documentation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | ||
| topic | No | ||
| video | No | ||
| action | Yes | ||
| enrich | No | ||
| expand | No | ||
| handles | No | ||
| library | No | ||
| to_date | No | ||
| version | No | ||
| language | No | ||
| from_date | No | ||
| categories | No | general | |
| time_range | No | ||
| max_results | No | ||
| project_path | No | ||
| exclude_domains | No | ||
| exclude_handles | No | ||
| include_domains | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||