🚀 OneSearch MCPサーバー: ウェブ検索 & クロール & スクレイパー & コンテンツ準備

ウェブ検索、ローカルブラウザ検索、および agent-browser を使用したスクレイピング機能のために、複数の検索プロバイダーと統合するModel Context Protocol (MCP) サーバーの実装です。

機能

• ウェブサイトからのウェブ検索、スクレイピング、クロール、およびコンテンツの事前処理。

• 複数の検索エンジンとウェブスクレイパーをサポート: SearXNG、Tavily、DuckDuckGo、Bing、Google、Zhipu (智谱)、Exa、Bocha (博查) など。

• ローカルウェブ検索 (ブラウザ検索)、複数の検索エンジンをサポート: Bing、Google、Baidu、Sogou など。

  • ブラウザ自動化に agent-browser を使用。

  • 無料、APIキー不要。

• 有効なツール: one_search, one_scrape, one_map, one_extract

Related MCP server: Firecrawl MCP Server

v1.1.0以前からの移行

v1.1.0での破壊的変更:

• Firecrawlの削除: Firecrawl統合は削除されました。代わりに、外部APIサービスを必要とせずに同様の機能を提供する agent-browser が採用されました。

• 新しいブラウザ要件: Chromiumブラウザをインストールする必要があります（「前提条件」セクションを参照）。

• 環境変数: FIRECRAWL_API_URL および FIRECRAWL_API_KEY は使用されなくなりました。

変更点:

• one_scrape および one_map は、Firecrawlの代わりに agent-browser を使用するようになりました。

• one_extract は、組み込みのLLM抽出を実行する代わりに、ダウンストリーム分析のためにマルチURLページコンテンツを事前処理するようになりました。

• すべてのブラウザベースの操作がローカルで処理されるようになり、プライバシーが向上し、APIコストもかかりません。

移行手順:

1. Chromiumブラウザをインストールする（「前提条件」を参照）

2. 環境変数から FIRECRAWL_API_URL と FIRECRAWL_API_KEY を削除する

3. 最新バージョンに更新する: npm install -g one-search-mcp@latest

前提条件

ブラウザ要件: このサーバーはウェブスクレイピングとローカル検索に agent-browser を使用しており、Chromiumベースのブラウザが必要です。

朗報: サーバーはシステムにインストール済みのブラウザを自動的に検出して使用します:

• ✅ Google Chrome

• ✅ Microsoft Edge

• ✅ Chromium

• ✅ Google Chrome Canary

これらのブラウザがインストールされていない場合は、以下を行ってください:

# Option 1: Install Google Chrome (Recommended)
# Download from: https://www.google.com/chrome/

# Option 2: Install Microsoft Edge
# Download from: https://www.microsoft.com/edge

# Option 3: Install Chromium via agent-browser
npx agent-browser install

# Option 4: Install Chromium directly
# Download from: https://www.chromium.org/getting-involved/download-chromium/

インストール

Claude Code CLIを使用する場合 (推奨)

# Add to Claude Code with default settings (local search)
claude mcp add one-search-mcp -- npx -y one-search-mcp

# Add with custom search provider (e.g., SearXNG)
claude mcp add one-search-mcp -e SEARCH_PROVIDER=searxng -e SEARCH_API_URL=http://127.0.0.1:8080 -- npx -y one-search-mcp

# Add with Tavily API
claude mcp add one-search-mcp -e SEARCH_PROVIDER=tavily -e SEARCH_API_KEY=your_api_key -- npx -y one-search-mcp

手動インストール

# Install globally (Optional)
npm install -g one-search-mcp

# Or run directly with npx
npx -y one-search-mcp

Dockerを使用する場合

Dockerイメージにはすべての依存関係（Chromiumブラウザ）がプリインストールされており、追加のセットアップは不要です。

イメージのプル:

# From GitHub Container Registry
docker pull ghcr.io/yokingma/one-search-mcp:latest

# Or from Docker Hub
docker pull zacma/one-search-mcp:latest

Claude Desktopでの設定:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/yokingma/one-search-mcp:latest"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

カスタム検索プロバイダーを使用する場合:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SEARCH_PROVIDER=tavily",
        "-e", "SEARCH_API_KEY=your_api_key",
        "ghcr.io/yokingma/one-search-mcp:latest"
      ]
    }
  }
}

環境変数

検索エンジン:

• SEARCH_PROVIDER (オプション): 使用する検索プロバイダー。searxng, duckduckgo, bing, tavily, google, zhipu, exa, bocha, local をサポート。デフォルトは local です。

• SEARCH_API_URL (オプション): SearxNG APIのURL、または google の場合はGoogleカスタム検索エンジンID。

• SEARCH_API_KEY (オプション): 検索プロバイダーのAPIキー。tavily, bing, google, zhipu, exa, bocha で必要です。

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

検索プロバイダーの設定

その他のMCPクライアントの設定

Claude Desktop

Claude Desktopの設定ファイルに追加してください:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Cursor

mcp.json ファイルに追加してください:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Windsurf

./codeium/windsurf/model_config.json ファイルに追加してください:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

SearXNGのセルフホスト (オプション)

SearXNGを検索プロバイダーとして使用したい場合は、Dockerを使用してローカルにデプロイできます:

前提条件:

• Dockerがインストールされ、実行されていること (バージョン20.10.0以上)

• 少なくとも4GBのRAMが利用可能であること

クイックスタート:

# Clone SearXNG Docker repository
git clone https://github.com/searxng/searxng-docker.git
cd searxng-docker

# Start SearXNG
docker compose up -d

デプロイ後、SearXNGはデフォルトで http://127.0.0.1:8080 で利用可能になります。

OneSearchでSearXNGを使用するように設定:

# Set environment variables
export SEARCH_PROVIDER=searxng
export SEARCH_API_URL=http://127.0.0.1:8080

詳細については、公式SearXNG Dockerドキュメントを参照してください。

トラブルシューティング

「Browser not found」エラー

「Browser not found」のようなエラーが表示される場合、サーバーはインストールされているChromiumベースのブラウザを検出できませんでした。以下のいずれかをインストールしてください:

• Google Chrome: https://www.google.com/chrome/

• Microsoft Edge: https://www.microsoft.com/edge

• Chromium: https://www.chromium.org/getting-involved/download-chromium/

または、agent-browser経由でインストールしてください:

npx agent-browser install

ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。