Web Search SOP
Layer Rules
- Layer: sop — wraps MCP tools directly
- Called by: Any tactic or strategy requiring quick web orientation
- Calls: configured web-search MCP tools (never calls other SOPs)
Purpose
Fast orientation search. Understand what pages and sources exist on a topic. Suitable for quick fact-checking, getting an overview of a landscape, or finding URLs for deeper research via web-research.
Use this when you need to:
- Find what pages exist on a topic
- Get a rough overview of available information
- Discover URLs for deeper research (via web-research)
- Quick fact-check with snippet-level confidence
- Monitor recent news on a topic
This skill returns snippets only. For full-page content analysis, use web-research.
Provider Selection
Use whichever web-search MCP is configured — check availability yourself.
If more than one is active, try them in the order listed below. This order
is just the writing order, not a hard priority — any active provider is
equally valid.
- Brave — see Provider Details § Brave
- Tavily — see Provider Details § Tavily
Set the result count to ~10 per call (provider-specific parameter named in
each Provider Details subsection).
HARD-GATE
Snippets are NOT authoritative content. They are orientation signals.
PROHIBITED:
- Drawing substantive conclusions from snippets alone
- Treating snippet content as verified facts
- Completing a research task using only search results
- Presenting snippet summaries as thorough analysis
REQUIRED:
- Label all results as "snippets for orientation"
- For any analysis requiring full content, escalate to
web-research
- Make clear to the user that snippets provide direction, not answers
Workflow
Step 1: Formulate Query
- Use specific, targeted keywords
- Consider time filters if the provider supports them
- Consider result count: 5-20 results (default ~10)
- For news: use news-specific search if available
- For location-based: use local search if available
Step 2: Execute Search
Call the configured provider's search tool with ~10 results per call.
See Provider Details for exact tool name and parameters.
Step 3: Return Structured Results
For each result, present:
- Title — page title
- URL — full URL (for reference or escalation to web-research)
- Snippet — 1-3 sentence description (orientation only, not authoritative)
- Date — when available (especially for news)
Provider Details
Brave
Available tools:
| Tool |
Purpose |
Returns |
brave_web_search |
General web search |
URL, title, description snippet |
brave_news_search |
Recent news articles |
URL, title, snippet, date |
brave_video_search |
Video content discovery |
URL, title, description, duration |
brave_image_search |
Image search |
URL, title, image properties |
brave_local_search |
Local businesses/places |
Name, address, rating, hours |
brave_summarizer |
AI-generated summary (Pro only) |
Summarized text with references |
Key parameters:
brave_web_search:
query (required): search terms, max 400 chars
count: 1-20 results (default 10)
offset: pagination, 0-9 (default 0)
freshness: pd (24h), pw (7d), pm (31d), py (365d), or YYYY-MM-DDtoYYYY-MM-DD
safesearch: off / moderate / strict (default moderate)
search_lang: language code (default en)
country: 2-letter country code (default US)
result_filter: array of types to include (web, news, videos, etc.)
brave_news_search: same core parameters, better for time-sensitive queries
brave_video_search: returns duration and thumbnail_url
brave_image_search: count 1-200 (default 50)
brave_local_search: for "near me" queries, returns business details
brave_summarizer: requires Pro plan, must first run brave_web_search with summary=true
Examples:
Quick fact check:
brave_web_search(query="Claude 3.5 Sonnet release date", count=5)
News monitoring:
brave_news_search(query="transformer architecture breakthroughs", freshness="pm", count=10)
Landscape scan:
brave_web_search(query="MCP server frameworks comparison 2025", count=15)
Tavily
Available tools:
| Tool |
Purpose |
Returns |
tavily_search |
LLM-optimized web search |
URL, title, content snippet, score |
Key parameters:
tavily_search:
query (required): search terms
max_results: number of results (default 10)
search_depth: basic or advanced (default basic)
include_domains: restrict to specific domains
exclude_domains: exclude specific domains
Examples:
Quick fact check:
tavily_search(query="Claude 3.5 Sonnet release date", max_results=5)
Landscape scan:
tavily_search(query="MCP server frameworks comparison 2025", max_results=10)
1---2name: web-search-33description: Quick web scanning — discover pages, get snippets, find URLs. For orientation only, not substantive analysis.4---56# Web Search SOP78## Layer Rules9- **Layer**: sop — wraps MCP tools directly10- **Called by**: Any tactic or strategy requiring quick web orientation11- **Calls**: configured web-search MCP tools (never calls other SOPs)1213## Purpose1415Fast orientation search. Understand what pages and sources exist on a topic. Suitable for quick fact-checking, getting an overview of a landscape, or finding URLs for deeper research via web-research.1617Use this when you need to:18- Find what pages exist on a topic19- Get a rough overview of available information20- Discover URLs for deeper research (via web-research)21- Quick fact-check with snippet-level confidence22- Monitor recent news on a topic2324**This skill returns snippets only.** For full-page content analysis, use `web-research`.2526## Provider Selection2728Use whichever web-search MCP is configured — check availability yourself.29If more than one is active, try them in the order listed below. This order30is just the writing order, not a hard priority — any active provider is31equally valid.3233- Brave — see Provider Details § Brave34- Tavily — see Provider Details § Tavily3536Set the result count to ~10 per call (provider-specific parameter named in37each Provider Details subsection).3839## HARD-GATE4041<HARD-GATE>42**Web search returns snippets only (1-3 sentences per result).**4344Snippets are NOT authoritative content. They are orientation signals.4546**PROHIBITED:**47- Drawing substantive conclusions from snippets alone48- Treating snippet content as verified facts49- Completing a research task using only search results50- Presenting snippet summaries as thorough analysis5152**REQUIRED:**53- Label all results as "snippets for orientation"54- For any analysis requiring full content, escalate to `web-research`55- Make clear to the user that snippets provide direction, not answers56</HARD-GATE>5758## Workflow5960### Step 1: Formulate Query6162- Use specific, targeted keywords63- Consider time filters if the provider supports them64- Consider result count: 5-20 results (default ~10)65- For news: use news-specific search if available66- For location-based: use local search if available6768### Step 2: Execute Search6970Call the configured provider's search tool with ~10 results per call.71See Provider Details for exact tool name and parameters.7273### Step 3: Return Structured Results7475For each result, present:76- **Title** — page title77- **URL** — full URL (for reference or escalation to web-research)78- **Snippet** — 1-3 sentence description (orientation only, not authoritative)79- **Date** — when available (especially for news)8081## Provider Details8283### Brave8485**Available tools:**8687| Tool | Purpose | Returns |88|------|---------|---------|89| `brave_web_search` | General web search | URL, title, description snippet |90| `brave_news_search` | Recent news articles | URL, title, snippet, date |91| `brave_video_search` | Video content discovery | URL, title, description, duration |92| `brave_image_search` | Image search | URL, title, image properties |93| `brave_local_search` | Local businesses/places | Name, address, rating, hours |94| `brave_summarizer` | AI-generated summary (Pro only) | Summarized text with references |9596**Key parameters:**9798- `brave_web_search`:99 - `query` (required): search terms, max 400 chars100 - `count`: 1-20 results (default 10)101 - `offset`: pagination, 0-9 (default 0)102 - `freshness`: `pd` (24h), `pw` (7d), `pm` (31d), `py` (365d), or `YYYY-MM-DDtoYYYY-MM-DD`103 - `safesearch`: off / moderate / strict (default moderate)104 - `search_lang`: language code (default en)105 - `country`: 2-letter country code (default US)106 - `result_filter`: array of types to include (web, news, videos, etc.)107108- `brave_news_search`: same core parameters, better for time-sensitive queries109- `brave_video_search`: returns `duration` and `thumbnail_url`110- `brave_image_search`: `count` 1-200 (default 50)111- `brave_local_search`: for "near me" queries, returns business details112- `brave_summarizer`: requires Pro plan, must first run `brave_web_search` with `summary=true`113114**Examples:**115116Quick fact check:117```118brave_web_search(query="Claude 3.5 Sonnet release date", count=5)119```120121News monitoring:122```123brave_news_search(query="transformer architecture breakthroughs", freshness="pm", count=10)124```125126Landscape scan:127```128brave_web_search(query="MCP server frameworks comparison 2025", count=15)129```130131### Tavily132133**Available tools:**134135| Tool | Purpose | Returns |136|------|---------|---------|137| `tavily_search` | LLM-optimized web search | URL, title, content snippet, score |138139**Key parameters:**140141- `tavily_search`:142 - `query` (required): search terms143 - `max_results`: number of results (default 10)144 - `search_depth`: `basic` or `advanced` (default basic)145 - `include_domains`: restrict to specific domains146 - `exclude_domains`: exclude specific domains147148**Examples:**149150Quick fact check:151```152tavily_search(query="Claude 3.5 Sonnet release date", max_results=5)153```154155Landscape scan:156```157tavily_search(query="MCP server frameworks comparison 2025", max_results=10)158```