Web search & deep research

Setup

export NINJA_SERPER_API_KEY="..."

Enable tools (default on in example config):

"enabled_tools": {
  "web_search": true,
  "read_url": true,
  "deep_research": true
}

Tools

Tool Purpose
web_search Serper Google search
read_url Extract readable text from a URL
researcher subagent Multi-round search + read only
deep_research Fan out 2–6 queries in parallel

read_url blocks SSRF to private/link-local hosts.

When to use

  • Current library/API docs
  • External facts the model should not invent
  • Multi-angle research before planning

Alternatives

Configure a search MCP in mcp_config.json and disable built-in web tools if you prefer a different provider.