Internet Search
Queries a self-hosted SearXNG instance aggregating multiple search engines.
Category Routing
Always set category based on the nature of the query.
| Category |
When to use |
Engines |
general |
Default. Facts, how-tos, products, people, broad web. |
Brave, Bing, DDG, Startpage, Qwant, Wikipedia… |
news |
Recent events, breaking news, anything time-sensitive. |
Bing News, DDG News |
academic |
Research papers, studies, medical literature, preprints. |
arXiv, Google Scholar, PubMed |
social |
Opinions, community recommendations, "what do people think about X". |
Reddit |
Query Formulation
Write queries as a search engine expects — keywords, not full sentences:
# Bad
"what is the fastest async runtime for rust"
# Good
"rust async runtime benchmarks 2025"
- news: include a time anchor —
"OpenAI o3 release 2025" not just "OpenAI o3"
- academic: use field terminology —
"transformer attention efficiency survey"
- social: phrase as community search —
"reddit best mechanical keyboard 2025"
Count
count=5 (default) — sufficient for most tasks
count=10 — comparing many options, checking consensus
count=3 — quick fact checks
Multi-Search Strategy
Fire multiple focused searches rather than one broad one:
# Bad: one vague search
internet_search("best way to deploy Node.js")
# Good: three targeted searches
internet_search("Node.js Docker deployment best practices 2025")
internet_search("Node.js PM2 vs Docker production", category="social")
internet_search("Node.js zero-downtime deployment strategies")
Combine general + social for factual + sentiment coverage:
internet_search("Bun runtime performance vs Node.js benchmarks")
internet_search("Bun runtime production experience", category="social")
When NOT to Use
- Things you already know with high confidence
- Stable API docs or well-known syntax — use training knowledge
- Repeating a search that already answered the question
Common Mistakes
| Mistake |
Fix |
general for a research paper |
Use category="academic" |
| Searching "what happened today" |
Use category="news" with a specific topic |
| One broad search for a multi-part question |
Break into 2–3 focused searches |
| Repeating a failed search verbatim |
Rephrase with different keywords |
count=20 for a simple fact |
Default count=5 is almost always enough |
1---2name: internet-search3description: How to use the internet_search tool effectively — category routing, query formulation, and multi-search strategies. Use whenever web search is needed: current events, research papers, community opinions, or any information beyond training knowledge.4---56# Internet Search78Queries a self-hosted SearXNG instance aggregating multiple search engines.910## Category Routing1112Always set `category` based on the nature of the query.1314| Category | When to use | Engines |15|------------|---------------------------------------------------------------------|--------------------------------------------------|16| `general` | Default. Facts, how-tos, products, people, broad web. | Brave, Bing, DDG, Startpage, Qwant, Wikipedia… |17| `news` | Recent events, breaking news, anything time-sensitive. | Bing News, DDG News |18| `academic` | Research papers, studies, medical literature, preprints. | arXiv, Google Scholar, PubMed |19| `social` | Opinions, community recommendations, "what do people think about X".| Reddit |2021## Query Formulation2223Write queries as a search engine expects — keywords, not full sentences:2425```26# Bad27"what is the fastest async runtime for rust"2829# Good30"rust async runtime benchmarks 2025"31```3233- **news**: include a time anchor — `"OpenAI o3 release 2025"` not just `"OpenAI o3"`34- **academic**: use field terminology — `"transformer attention efficiency survey"`35- **social**: phrase as community search — `"reddit best mechanical keyboard 2025"`3637## Count3839- `count=5` (default) — sufficient for most tasks40- `count=10` — comparing many options, checking consensus41- `count=3` — quick fact checks4243## Multi-Search Strategy4445Fire multiple focused searches rather than one broad one:4647```48# Bad: one vague search49internet_search("best way to deploy Node.js")5051# Good: three targeted searches52internet_search("Node.js Docker deployment best practices 2025")53internet_search("Node.js PM2 vs Docker production", category="social")54internet_search("Node.js zero-downtime deployment strategies")55```5657Combine `general` + `social` for factual + sentiment coverage:5859```60internet_search("Bun runtime performance vs Node.js benchmarks")61internet_search("Bun runtime production experience", category="social")62```6364## When NOT to Use6566- Things you already know with high confidence67- Stable API docs or well-known syntax — use training knowledge68- Repeating a search that already answered the question6970## Common Mistakes7172| Mistake | Fix |73|-------------------------------------------|-----------------------------------------------|74| `general` for a research paper | Use `category="academic"` |75| Searching "what happened today" | Use `category="news"` with a specific topic |76| One broad search for a multi-part question| Break into 2–3 focused searches |77| Repeating a failed search verbatim | Rephrase with different keywords |78| `count=20` for a simple fact | Default `count=5` is almost always enough |