🚀 OneSearch MCP Server: Web Search & Crawl & Scraper & Extract

基本能力

产品定位

OneSearch MCP Server 是一个多功能网页搜索和抓取工具，旨在为用户提供灵活的网页内容获取和处理能力。

核心功能

• 网页搜索、抓取、爬取和内容提取
• 支持多种搜索引擎和网页抓取工具：SearXNG、Firecrawl、Tavily、DuckDuckGo、Bing 等
• 本地网页搜索（浏览器搜索），支持多种搜索引擎：Bing、Google、Baidu、Sogou 等
• 使用 puppeteer-core 从网站抓取内容
• 需要本地安装浏览器，如 Chromium、Google Chrome、Google Chrome Canary 等
• 免费使用，无需密钥

适用场景

• 需要从多个搜索引擎获取信息的场景
• 需要自动化抓取网页内容的场景
• 需要本地浏览器搜索功能的场景

工具列表

• one_search: 提供网页搜索功能
• one_scrape: 提供网页抓取功能
• one_map: 提供地图相关功能

常见问题解答

• [ReferenceError]: __name is not defined: 这是因为 Puppeteer 与 tsx 存在问题，esbuild#1031

使用教程

使用依赖

• 需要本地安装浏览器，如 Chromium、Google Chrome、Google Chrome Canary 等

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @yokingma/one-search --client claude

手动安装

# 手动安装（可选）
npm install -g one-search-mcp

# 使用 npx
env SEARCH_API_URL=http://127.0.0.1:8080 FIRECRAWL_API_URL=http://127.0.0.1:3002 npx -y one-search-mcp

调试方式

• 确保环境变量设置正确：
• SEARCH_PROVIDER: 使用的搜索提供商
• SEARCH_API_URL: SearxNG API 的 URL
• SEARCH_API_KEY: 搜索提供商的 API 密钥
• FIRECRAWL_API_URL: Firecrawl API 的 URL

• FIRECRAWL_API_KEY: Firecrawl API 的密钥

• 运行配置示例（Cursor）:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "searxng",
        "SEARCH_API_URL": "http://127.0.0.1:8080",
        "SEARCH_API_KEY": "YOUR_API_KEY",
        "FIRECRAWL_API_URL": "http://127.0.0.1:3002",
        "FIRECRAWL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

• 运行配置示例（Windsurf）:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "searxng",
        "SEARCH_API_URL": "http://127.0.0.1:8080",
        "SEARCH_API_KEY": "YOUR_API_KEY",
        "FIRECRAWL_API_URL": "http://127.0.0.1:3002",
        "FIRECRAWL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。