One Search MCP server

🚀 OneSearch MCP Server: Web Search, URL Discovery, Scraper & Content Prep

A Model Context Protocol (MCP) server implementation that integrates with multiple search providers for web search, local browser search, URL discovery, and scraping capabilities with agent-browser.

Features

• Web search, scrape, discover URLs, and preprocess content from websites.
• Support multiple search engines and web scrapers: SearXNG, Tavily, DuckDuckGo, Bing, Google, Zhipu (智谱), Exa, Bocha (博查), You.com, etc.
• Local web search (browser search), support multiple search engines: Bing, Google, Baidu, Sogou, etc.
• Use agent-browser for browser automation.
• Free, no API keys required.
• Enabled tools: onesearch, onescrape, onemap, oneextract

Current Tool Surface

• one_search
• Returns search results from the configured provider.
• one_map
• Discovers links from a starting URL by loading the page in the browser and extracting links from its HTML.
• Supported input fields: url, search, includeSubdomains, limit.
• This is not a sitemap crawler; removed fields such as ignoreSitemap and sitemapOnly are rejected at the schema boundary.
• one_scrape
• Scrapes one page and returns content selected by formats.
• Supported input fields: url, formats, waitFor, timeout, skipTlsVerification, allowExecuteJavascript, actions.
• Supported formats: markdown, html, rawHtml, links, screenshot, screenshot@fullPage.
• Supported bounded pre-scrape actions: wait, click, write, press, scroll.
• Advanced pre-scrape action: executeJavascript. If actions contains executeJavascript, you must set allowExecuteJavascript: true.

Migration from v1.1.0 and Earlier

Breaking Changes in v1.1.0:

• Firecrawl Removed: The Firecrawl integration has been removed in favor of agent-browser, which provides similar functionality without requiring external API services.
• New Browser Requirement: You must install Chromium browser (see Prerequisites section).
• Environment Variables: FIRECRAWLAPIURL and FIRECRAWLAPIKEY are no longer used.

What Changed:

• onescrape and onemap now use agent-browser instead of Firecrawl
• one_extract now preprocesses multi-URL page content for downstream analysis instead of performing built-in LLM extraction
• All browser-based operations are now handled locally, providing better privacy and no API costs

Migration Steps:

1. Install Chromium browser (see Prerequisites)
2. Remove FIRECRAWLAPIURL and FIRECRAWLAPIKEY from your environment variables
3. Update to the latest version: npm install -g one-search-mcp@latest

Prerequisites

Browser Requirement: This server uses agent-browser for web scraping and local search, which requires a Chromium-based browser.

Good News: The server will automatically detect and use browsers already installed on your system:

• ✅ Google Chrome
• ✅ Microsoft Edge
• ✅ Chromium
• ✅ Google Chrome Canary

If you don't have any of these browsers installed, you can:

# Option 1: Install Google Chrome (Recommended)
# Download from: https://www.google.com/chrome/

# Option 2: Install Microsoft Edge
# Download from: https://www.microsoft.com/edge

# Option 3: Install Chromium via agent-browser
npx agent-browser install

# Option 4: Install Chromium directly
# Download from: https://www.chromium.org/getting-involved/download-chromium/

Installation

Using Claude Code CLI (Recommended)

Shortened. The full README is on GitHub.