{"id":26610458,"url":"https://github.com/yokingma/one-search-mcp","last_synced_at":"2026-02-02T04:26:35.019Z","repository":{"id":283018540,"uuid":"950333812","full_name":"yokingma/one-search-mcp","owner":"yokingma","description":"🚀 OneSearch MCP Server: Web Search \u0026 Scraper \u0026 Extract,  Support Firecrawl, SearXNG, Tavily, DuckDuckGo, Bing, etc.","archived":false,"fork":false,"pushed_at":"2026-01-31T09:27:06.000Z","size":272,"stargazers_count":61,"open_issues_count":1,"forks_count":15,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-31T22:17:37.375Z","etag":null,"topics":["bing-mcp","duckduckgo-mcp","firecrawl-mcp","mcp-server","modelcontextprotocol","searxng-mcp","tavily-mcp"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yokingma.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-18T02:06:27.000Z","updated_at":"2026-01-31T09:27:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"d5eb10a3-63f6-435c-9143-b70cff4f13e5","html_url":"https://github.com/yokingma/one-search-mcp","commit_stats":null,"previous_names":["yokingma/one-search-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yokingma/one-search-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yokingma%2Fone-search-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yokingma%2Fone-search-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yokingma%2Fone-search-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yokingma%2Fone-search-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yokingma","download_url":"https://codeload.github.com/yokingma/one-search-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yokingma%2Fone-search-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29004878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-02T04:25:24.522Z","status":"ssl_error","status_checked_at":"2026-02-02T04:24:51.069Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bing-mcp","duckduckgo-mcp","firecrawl-mcp","mcp-server","modelcontextprotocol","searxng-mcp","tavily-mcp"],"created_at":"2025-03-24T01:47:59.747Z","updated_at":"2026-02-02T04:26:35.011Z","avatar_url":"https://github.com/yokingma.png","language":"TypeScript","funding_links":[],"categories":["Search \u0026 Data Extraction","Data Analytics"],"sub_categories":["How to Submit"],"readme":"# 🚀 OneSearch MCP Server: Web Search \u0026 Crawl \u0026 Scraper \u0026 Extract\n\nA Model Context Protocol (MCP) server implementation that integrates with multiple search providers for web search, local browser search, and scraping capabilities with agent-browser.\n\n## Features\n\n- Web Search, scrape, crawl and extract content from websites.\n- Support multiple search engines and web scrapers: **SearXNG**, **Tavily**, **DuckDuckGo**, **Bing**, **Google**, **Zhipu (智谱)**, **Exa**, **Bocha (博查)**, etc.\n- **Local web search** (browser search), support multiple search engines: **Bing**, **Google**, **Baidu**, **Sogou**, etc.\n  - Use `agent-browser` for browser automation.\n  - Free, no API keys required.\n- **Enabled tools:** `one_search`, `one_scrape`, `one_map`, `one_extract`\n\n## Migration from v1.1.0 and Earlier\n\n**Breaking Changes in v1.1.0:**\n\n- **Firecrawl Removed**: The Firecrawl integration has been removed in favor of `agent-browser`, which provides similar functionality without requiring external API services.\n- **New Browser Requirement**: You must install Chromium browser (see Prerequisites section).\n- **Environment Variables**: `FIRECRAWL_API_URL` and `FIRECRAWL_API_KEY` are no longer used.\n\n**What Changed:**\n\n- `one_scrape` and `one_map` now use `agent-browser` instead of Firecrawl\n- `one_extract` tool is now fully implemented for structured data extraction from multiple URLs\n- All browser-based operations are now handled locally, providing better privacy and no API costs\n\n**Migration Steps:**\n\n1. Install Chromium browser (see Prerequisites)\n2. Remove `FIRECRAWL_API_URL` and `FIRECRAWL_API_KEY` from your environment variables\n3. Update to the latest version: `npm install -g one-search-mcp@latest`\n\n## Prerequisites\n\n**Browser Requirement**: This server uses `agent-browser` for web scraping and local search, which requires a Chromium-based browser.\n\n**Good News**: The server will automatically detect and use browsers already installed on your system:\n\n- ✅ Google Chrome\n- ✅ Microsoft Edge\n- ✅ Chromium\n- ✅ Google Chrome Canary\n\n**If you don't have any of these browsers installed**, you can:\n\n```bash\n# Option 1: Install Google Chrome (Recommended)\n# Download from: https://www.google.com/chrome/\n\n# Option 2: Install Microsoft Edge\n# Download from: https://www.microsoft.com/edge\n\n# Option 3: Install Chromium via agent-browser\nnpx agent-browser install\n\n# Option 4: Install Chromium directly\n# Download from: https://www.chromium.org/getting-involved/download-chromium/\n```\n\n## Installation\n\n### Using Claude Code CLI (Recommended)\n\n```bash\n# Add to Claude Code with default settings (local search)\nclaude mcp add one-search-mcp -- npx -y one-search-mcp\n\n# Add with custom search provider (e.g., SearXNG)\nclaude mcp add -e SEARCH_PROVIDER=searxng -e SEARCH_API_URL=http://127.0.0.1:8080 one-search-mcp -- npx -y one-search-mcp\n\n# Add with Tavily API\nclaude mcp add -e SEARCH_PROVIDER=tavily -e SEARCH_API_KEY=your_api_key one-search-mcp -- npx -y one-search-mcp\n```\n\n### Manual Installation\n\n```bash\n# Install globally (Optional)\nnpm install -g one-search-mcp\n\n# Or run directly with npx\nnpx -y one-search-mcp\n```\n\n## Environment Variables\n\n**Search Engine:**\n\n- **SEARCH_PROVIDER** (Optional): The search provider to use, supports `searxng`, `duckduckgo`, `bing`, `tavily`, `google`, `zhipu`, `exa`, `bocha`, `local`, default is `local`.\n- **SEARCH_API_URL** (Optional): The URL of the SearxNG API, or Google Custom Search Engine ID for `google`.\n- **SEARCH_API_KEY** (Optional): The API key for the search provider, required for `tavily`, `bing`, `google`, `zhipu`, `exa`, `bocha`.\n\n```ts\n// supported search providers\nexport type SearchProvider = 'searxng' | 'duckduckgo' | 'bing' | 'tavily' | 'google' | 'zhipu' | 'exa' | 'bocha' | 'local';\n```\n\n### Search Provider Configuration\n\n| Provider | API Key Required | API URL Required | Notes |\n|----------|-----------------|------------------|-------|\n| `local` | No | No | Free, uses browser automation |\n| `duckduckgo` | No | No | Free, no API key needed |\n| `searxng` | Optional | Yes | Self-hosted meta search engine |\n| `bing` | Yes | No | [Bing Search API](https://learn.microsoft.com/en-us/previous-versions/bing/search-apis/bing-web-search/create-bing-search-service-resource) |\n| `tavily` | Yes | No | [Tavily API](https://tavily.com/) |\n| `google` | Yes | Yes (Search Engine ID) | [Google Custom Search](https://developers.google.com/custom-search/v1/overview) |\n| `zhipu` | Yes | No | [智谱 AI](https://bigmodel.cn/dev/api/search-tool/web-search) |\n| `exa` | Yes | No | [Exa AI](https://exa.ai/) |\n| `bocha` | Yes | No | [博查 AI](https://open.bochaai.com/) |\n\n## Configuration for Other MCP Clients\n\n### Claude Desktop\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"one-search-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"one-search-mcp\"],\n      \"env\": {\n        \"SEARCH_PROVIDER\": \"local\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to your `mcp.json` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"one-search-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"one-search-mcp\"],\n      \"env\": {\n        \"SEARCH_PROVIDER\": \"local\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to your `./codeium/windsurf/model_config.json` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"one-search-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"one-search-mcp\"],\n      \"env\": {\n        \"SEARCH_PROVIDER\": \"local\"\n      }\n    }\n  }\n}\n```\n\n## Self-hosting SearXNG (Optional)\n\nIf you want to use SearXNG as your search provider, you can deploy it locally using Docker:\n\n**Prerequisites:**\n\n- Docker installed and running (version 20.10.0 or higher)\n- At least 4GB of RAM available\n\n**Quick Start:**\n\n```bash\n# Clone SearXNG Docker repository\ngit clone https://github.com/searxng/searxng-docker.git\ncd searxng-docker\n\n# Start SearXNG\ndocker compose up -d\n```\n\nAfter deployment, SearXNG will be available at `http://127.0.0.1:8080` by default.\n\n**Configure OneSearch to use SearXNG:**\n\n```bash\n# Set environment variables\nexport SEARCH_PROVIDER=searxng\nexport SEARCH_API_URL=http://127.0.0.1:8080\n```\n\nFor more details, see the [official SearXNG Docker documentation](https://github.com/searxng/searxng-docker).\n\n## Troubleshooting\n\n### Browser not found error\n\nIf you see an error like \"Browser not found\", the server couldn't detect any installed Chromium-based browser. Please install one of the following:\n\n- **Google Chrome**: \u003chttps://www.google.com/chrome/\u003e\n- **Microsoft Edge**: \u003chttps://www.microsoft.com/edge\u003e\n- **Chromium**: \u003chttps://www.chromium.org/getting-involved/download-chromium/\u003e\n\nOr install via agent-browser:\n\n```bash\nnpx agent-browser install\n```\n\n## License\n\nMIT License - see [LICENSE](./LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyokingma%2Fone-search-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyokingma%2Fone-search-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyokingma%2Fone-search-mcp/lists"}