pi-web-search

Provider-native web search for pi, across Google Gemini, OpenAI, and Anthropic, plus Gemini-only URL Context analysis.

Tools

web_search

Search the web using your currently selected model. Automatically picks the right provider API:

Provider	API
Google Gemini	Grounding with Google Search
OpenAI	Responses API web search
OpenAI Codex	Codex Responses API web search
Anthropic	Messages API web search

Supports passing up to 20 additional URLs to analyze alongside the query.

url_context

Gemini-only. Analyze up to 20 public URLs — web pages, documents, images, and YouTube videos. Uses Gemini's native URL Context retrieval with verified metadata.

When using google-generative-ai, YouTube URLs are passed as file_data for native video understanding.

Install

pi install npm:pi-web-search

Usage

No extra config needed. Select a supported current model in pi and the tools auto-detect the matching provider API.

web_search will not scan configured models and pick one automatically when the current model does not support native search. To use a dedicated search model, opt in explicitly with ~/.pi/agent/web-search.json:

{
  "provider": "openai",
  "model": "gpt-5.1"
}

When this file exists, web_search uses the configured provider/model first. If it is missing, web_search uses the current conversation model. If the selected model does not support native search, the tool returns an error instead of falling back.

url_context is automatically removed from active tools when using a non-Gemini model.

Test

cp .env.example .env   # edit with your models
npm test               # unit tests
npm run test:real:web-search
npm run test:real:url-context

License

MIT