OneSearch MCP Server

Name: OneSearch MCP Server
Author: yokingma

yokingma

Get started Repository

Web search, scraping and content extraction backed by SearXNG, Tavily, DuckDuckGo, Bing and agent-browser.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add onesearch --env SEARCH_API_KEY='<SEARCH_API_KEY>' --env YDC_API_KEY='<YDC_API_KEY>' --env SEARCH_PROVIDER='<SEARCH_PROVIDER>' --env SEARCH_API_URL='<SEARCH_API_URL>' --env FIRECRAWL_API_URL='<FIRECRAWL_API_URL>' --env FIRECRAWL_API_KEY='<FIRECRAWL_API_KEY>' -- npx -y one-search-mcp

~/.codex/config.toml

[mcp_servers.onesearch]
command = "npx"
args = ["-y", "one-search-mcp"]
env = { SEARCH_API_KEY = "<SEARCH_API_KEY>", YDC_API_KEY = "<YDC_API_KEY>", SEARCH_PROVIDER = "<SEARCH_PROVIDER>", SEARCH_API_URL = "<SEARCH_API_URL>", FIRECRAWL_API_URL = "<FIRECRAWL_API_URL>", FIRECRAWL_API_KEY = "<FIRECRAWL_API_KEY>" }

# codex mcp add onesearch --env SEARCH_API_KEY='<SEARCH_API_KEY>' --env YDC_API_KEY='<YDC_API_KEY>' --env SEARCH_PROVIDER='<SEARCH_PROVIDER>' --env SEARCH_API_URL='<SEARCH_API_URL>' --env FIRECRAWL_API_URL='<FIRECRAWL_API_URL>' --env FIRECRAWL_API_KEY='<FIRECRAWL_API_KEY>' -- npx -y one-search-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "onesearch": {
      "command": "npx",
      "args": [
        "-y",
        "one-search-mcp"
      ],
      "env": {
        "SEARCH_API_KEY": "<SEARCH_API_KEY>",
        "YDC_API_KEY": "<YDC_API_KEY>",
        "SEARCH_PROVIDER": "<SEARCH_PROVIDER>",
        "SEARCH_API_URL": "<SEARCH_API_URL>",
        "FIRECRAWL_API_URL": "<FIRECRAWL_API_URL>",
        "FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "onesearch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "one-search-mcp"
      ],
      "env": {
        "SEARCH_API_KEY": "<SEARCH_API_KEY>",
        "YDC_API_KEY": "<YDC_API_KEY>",
        "SEARCH_PROVIDER": "<SEARCH_PROVIDER>",
        "SEARCH_API_URL": "<SEARCH_API_URL>",
        "FIRECRAWL_API_URL": "<FIRECRAWL_API_URL>",
        "FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "onesearch": {
      "command": "npx",
      "args": [
        "-y",
        "one-search-mcp"
      ],
      "env": {
        "SEARCH_API_KEY": "<SEARCH_API_KEY>",
        "YDC_API_KEY": "<YDC_API_KEY>",
        "SEARCH_PROVIDER": "<SEARCH_PROVIDER>",
        "SEARCH_API_URL": "<SEARCH_API_URL>",
        "FIRECRAWL_API_URL": "<FIRECRAWL_API_URL>",
        "FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "onesearch": {
      "command": "npx",
      "args": [
        "-y",
        "one-search-mcp"
      ],
      "env": {
        "SEARCH_API_KEY": "<SEARCH_API_KEY>",
        "YDC_API_KEY": "<YDC_API_KEY>",
        "SEARCH_PROVIDER": "<SEARCH_PROVIDER>",
        "SEARCH_API_URL": "<SEARCH_API_URL>",
        "FIRECRAWL_API_URL": "<FIRECRAWL_API_URL>",
        "FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "onesearch": {
      "command": "npx",
      "args": [
        "-y",
        "one-search-mcp"
      ],
      "env": {
        "SEARCH_API_KEY": "<SEARCH_API_KEY>",
        "YDC_API_KEY": "<YDC_API_KEY>",
        "SEARCH_PROVIDER": "<SEARCH_PROVIDER>",
        "SEARCH_API_URL": "<SEARCH_API_URL>",
        "FIRECRAWL_API_URL": "<FIRECRAWL_API_URL>",
        "FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
      }
    }
  }
}

Environment variables

SEARCH_API_KEY
YDC_API_KEY
SEARCH_PROVIDER
SEARCH_API_URL
FIRECRAWL_API_URL
FIRECRAWL_API_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related