websearch

Execute web searches via Exa MCP with intent-based routing, multi-pass deep research, and structured output with inline citations. **Query**: free-text after the skill name

Modes (mutually exclusive):

• (none) — quick search, single pass, web_search_exa
• --deep — multi-pass deep research with gap-driven iteration (3-5 sub-queries, max 3 passes)
• --code — code examples, API docs, library usage via get_code_context_exa
• --docs <lib> — crawl official documentation for a specific library
• --debug — paste error message, find solutions (Stack Overflow, GitHub issues)
• --news — recent news, category:news filter
• --compare — compare 2+ options side by side via parallel queries
• --research — academic papers, category:research paper
• --similar <url> — find pages similar to a given URL

Filters:

• --after <date> — results published after date (ISO 8601 or natural: "last week")
• --before <date> — results published before date
• --domain <d> — restrict to domain(s), comma-separated
• --exclude <d> — exclude domain(s)
• --fresh — force live crawl (maxAgeHours=0)
• --locale <CC> — country code for localized results
• -n <num> — number of results (default: 5, max: 20)

Output:

• --save <file> — save report to markdown file
• --json — structured JSON output
• --full — full text instead of highlights (more tokens)

Help:

• --info — display detailed tutorial with all modes, flags, and examples

<state_variables>

• {mode}: string — detected search mode (quick|deep|code|docs|debug|news|compare|research|similar)
• {query}: string — cleaned search query
• {filters}: object — parsed Exa filters (dates, domains, locale, numResults)
• {output_opts}: object — save path, json flag, full text flag
• {lib_name}: string — library name if --docs mode
• {similar_url}: string — URL if --similar mode
• {results}: array — accumulated search results across passes
• {pass_count}: number — current iteration for deep mode
• {gaps}: array — identified knowledge gaps for deep iteration </state_variables>

<entry_point> Load steps/step-00-triage.md </entry_point>

<step_files>

Step	File	Purpose
00	steps/step-00-triage.md	Parse flags, classify intent, build Exa params
01	steps/step-01-search.md	Execute search strategy per mode
02	steps/step-02-deep.md	Deep iteration: evaluate, find gaps, re-query
03	steps/step-03-report.md	Synthesize, cite, format, optionally save
</step_files>

| File | Content | |------|---------| | references/domain-presets.md | Curated domain lists per ecosystem/intent | | references/query-patterns.md | Optimal Exa query formulation per search type | | references/info-text.md | Full tutorial displayed by --info flag | ALL web access via Exa MCP only. NEVER use WebSearch, WebFetch, or Context7. Tools: mcp__exa__web_search_exa, mcp__exa__get_code_context_exa, mcp__exa__crawling_exa, mcp__exa__web_search_advanced_exa.