hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Used for installation and distribution of the MCP server package, with support for running the server through npx commands.
Enables web search capabilities through SearXNG, allowing queries to be performed across multiple search engines through a single interface.
Supports installation and execution through shell commands, with environment variable configuration for different search providers and APIs.

🚀 OneSearch MCP 서버: 웹 검색 및 크롤링, 스크래퍼 및 추출

웹 검색, 로컬 브라우저 검색, Firecrawl을 통한 스크래핑 기능을 위해 Searxng/Tavily/DuckDuckGo/Bing과 통합되는 MCP(Model Context Protocol) 서버 구현입니다.

특징

웹 검색, 스크래핑, 크롤링 및 웹사이트의 콘텐츠 추출.
다양한 검색 엔진과 웹 스크래퍼를 지원합니다: SearXNG , Firecrawl , Tavily , DuckDuckGo , Bing 등.
로컬 웹 검색 (브라우저 검색), Bing , Google , Baidu , Sogou 등 다양한 검색 엔진을 지원합니다.
- puppeteer-core 사용하여 웹사이트에서 콘텐츠를 스크래핑합니다.
- Chromium , Google Chrome , Google Chrome Canary 등 로컬 브라우저가 설치되어 있어야 합니다.
- 무료이며 열쇠가 필요하지 않습니다.
활성화된 도구: one_search , one_scrape , one_map
자체 호스팅 지원: SearXNG, Firecrawl 등( 배포 참조)

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 OneSearch를 자동으로 설치하려면:

지엑스피1

수동 설치

# Manually install (Optional)
npm install -g one-search-mcp

# using 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 (선택 사항): 사용할 검색 제공자. searxng , duckduckgo , bing , tavily , local 지원하며 기본값은 local 입니다.
SEARCH_API_URL (선택 사항): searxng 에 필요한 SearxNG API의 URL입니다.
SEARCH_API_KEY (선택 사항): tavily , bing 에 필요한 검색 제공자의 API 키입니다.

// supported search providers
export type SearchProvider = 'searxng' | 'duckduckgo' | 'bing' | 'tavily' | 'local';

파이어크롤:

FIRECRAWL_API_URL(선택 사항): firecrawl 에 필요한 Firecrawl API의 URL입니다.
FIRECRAWL_API_KEY(선택 사항): 클라우드 서비스를 사용하는 경우 firecrawl 에 필요한 Firecrawl API의 API 키입니다.

커서에서 실행

mcp.json 파일은 다음과 같습니다.

{
  "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"
      }
    }
  }
}

윈드서프에서 달리기

./codeium/windsurf/model_config.json 파일에 다음을 추가하세요.

{
  "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"
      }
    }
  }
}

셀프 호스트

SearXNG 및 Firecrawl의 로컬 배포는 배포 를 참조하세요.

문제 해결

[ReferenceError]: __name이 정의되지 않았습니다. 이는 Puppeteer에 tsx , esbuild#1031 문제가 있기 때문입니다.

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

SearXNG, Firecrawl, Tavily를 포함한 다양한 엔진을 통해 웹 검색, 스크래핑, 크롤링 및 콘텐츠 추출을 가능하게 하는 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server

OneSearch MCP Server