🚀 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: one_search, one_scrape, one_map, one_extract

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.
  • actions run serially before content capture and fail fast on the first action error.
  • Removed fields such as onlyMainContent, extract, and location are rejected at the schema boundary.
• one_extract
  • Accepts only urls and returns preprocessed text blocks for downstream tools or models.

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: FIRECRAWL_API_URL and FIRECRAWL_API_KEY are no longer used.

What Changed:

• one_scrape and one_map 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 FIRECRAWL_API_URL and FIRECRAWL_API_KEY 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: