Web Search Extension for AgentOS

Professional web search, research aggregation, and fact-checking for AgentOS agents.

Supports multiple providers (Serper.dev, SerpAPI, Brave) with a DuckDuckGo fallback when no API keys are configured.

Installation

npm install @framers/agentos-ext-web-search

Quick Start

import { AgentOS } from '@framers/agentos';

const agentos = await AgentOS.create({
  extensionManifest: {
    packs: [
      {
        package: '@framers/agentos-ext-web-search',
        options: {
          // Any one of these is enough; Serper/SerpAPI/Brave are tried in order.
          serperApiKey: process.env.SERPER_API_KEY,
          serpApiKey: process.env.SERPAPI_API_KEY,
          braveApiKey: process.env.BRAVE_API_KEY,
        },
      },
    ],
  },
});

Environment Variables

• SERPER_API_KEY (optional)
• SERPAPI_API_KEY (optional)
• BRAVE_API_KEY (optional)

If none are set, the extension falls back to DuckDuckGo.

Tools

web_search

Search the web.

research_aggregate

Run multiple searches and aggregate results.

fact_check

Cross-check a claim across sources.

Notes

• Tools are read-only (no side effects).
• Provider selection is automatic based on which keys are configured.

License

Apache-2.0 © Frame.dev