One Search
🚀 OneSearch MCP Server: Web Search & Scraper & Extract, Support agent-browser, SearXNG, Tavily, DuckDuckGo, Bing, etc.
What is One Search?
One Search is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 🚀 onesearch mcp server: web search & scraper & extract, support agent-browser, searxng, tavily, duckduckgo, bing, etc.
🚀 OneSearch MCP Server: Web Search & Scraper & Extract, Support agent-browser, SearXNG, Tavily, DuckDuckGo, Bing, etc.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- one_search
- one_extract
- one_scrape
- one_map
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx one-searchConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use One Search
OneSearch MCP Server is a unified web search and scraping gateway that routes AI search requests through multiple configurable providers—including DuckDuckGo (free), Bing, Tavily, SearXNG, and Google—while also providing browser-based web scraping, content extraction, and local search capabilities through a single interface. It exposes four core tools: one_search for querying the web, one_scrape for extracting page content via a Chromium browser, one_extract for batch multi-URL content processing, and one_map for browser-based local search. Developers and researchers use it to give AI assistants flexible, provider-agnostic web access without locking into a single search API.
Prerequisites
- Node.js 18 or later and npm
- A Chromium-based browser (Chrome, Edge, or Chromium) installed locally for scraping features
- An MCP-compatible client such as Claude Desktop or Claude Code
- Optional: API key for paid providers (SEARCH_API_KEY for Bing, Tavily, Google, etc.) — DuckDuckGo and local browser search are free
Add the server to Claude Code
The simplest installation is via the Claude Code CLI. This automatically downloads and runs the package.
claude mcp add one-search-mcp -- npx -y one-search-mcpInstall the browser for scraping (first-time setup)
OneSearch uses agent-browser for web scraping, which requires a Chromium installation. Run this command to install it if you don't already have Chrome or Chromium.
npx agent-browser installChoose your search provider
Set the SEARCH_PROVIDER environment variable. DuckDuckGo requires no API key and is a good default. For better results or higher rate limits, use a paid provider with a SEARCH_API_KEY.
# Free providers (no API key needed):
export SEARCH_PROVIDER=duckduckgo
# Paid providers:
export SEARCH_PROVIDER=tavily
export SEARCH_API_KEY=your_tavily_keyConfigure Claude Desktop
Add the OneSearch server to your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json.
{
"mcpServers": {
"one-search-mcp": {
"command": "npx",
"args": ["-y", "one-search-mcp"],
"env": {
"SEARCH_PROVIDER": "duckduckgo"
}
}
}
}Restart your MCP client and verify
Restart Claude Desktop. Ask Claude to search for something to confirm all four tools (one_search, one_scrape, one_extract, one_map) are available.
One Search Examples
Client configuration for Claude Desktop (DuckDuckGo, free)
Zero-cost configuration using DuckDuckGo as the search provider. No API key required.
{
"mcpServers": {
"one-search-mcp": {
"command": "npx",
"args": ["-y", "one-search-mcp"],
"env": {
"SEARCH_PROVIDER": "duckduckgo"
}
}
}
}Client configuration with Tavily (paid, higher quality)
Configuration using Tavily for AI-optimized search results. Requires a Tavily API key.
{
"mcpServers": {
"one-search-mcp": {
"command": "npx",
"args": ["-y", "one-search-mcp"],
"env": {
"SEARCH_PROVIDER": "tavily",
"SEARCH_API_KEY": "tvly-your-key-here"
}
}
}
}Prompts to try
Example prompts that exercise the search, scrape, and extract capabilities of OneSearch.
- "Search the web for the latest news about Claude AI updates"
- "Scrape the content from https://example.com and summarize it"
- "Search DuckDuckGo for Python async best practices and show the top 5 results"
- "Extract and compare content from these three URLs about serverless architecture"
- "Find local coffee shops near downtown Seattle using the map search tool"Troubleshooting One Search
one_scrape fails with browser not found error
Run 'npx agent-browser install' to install Chromium. If you have Chrome or Edge installed, agent-browser should auto-detect them. On Linux, you may need to install additional dependencies: sudo apt-get install -y libgbm-dev libnss3 libatk-bridge2.0-0
Search returns no results or errors with a paid provider
Confirm SEARCH_API_KEY is set correctly in your environment config and the key is active. Each provider has a different key format: Tavily keys start with 'tvly-', Bing keys are from Azure Cognitive Services. Verify SEARCH_PROVIDER matches exactly: 'tavily', 'bing', 'google', etc. (all lowercase).
SearXNG searches fail or return errors
SearXNG requires a self-hosted instance. Set SEARCH_API_URL to your SearXNG instance URL (e.g., http://localhost:8080). Public SearXNG instances may rate-limit or block automated requests. Deploy your own instance using the official SearXNG Docker image.
Frequently Asked Questions about One Search
What is One Search?
One Search is a Model Context Protocol (MCP) server that 🚀 onesearch mcp server: web search & scraper & extract, support agent-browser, searxng, tavily, duckduckgo, bing, etc. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install One Search?
Follow the installation instructions on the One Search GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with One Search?
One Search works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is One Search free to use?
Yes, One Search is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
One Search Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to One Search? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up One Search in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use One Search?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.