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

🚀 OneSearch MCP Server：Web 検索、URL の検出、スクレイピング、コンテンツの準備

Web 検索、ローカルブラウザー検索、URL の検出、agent-browser によるスクレイピング機能を利用するため、複数の検索プロバイダーと連携する Model Context Protocol（MCP）サーバーの実装です。

機能

• Web サイトの検索、スクレイピング、URL の検出、コンテンツの前処理を行います。
• 複数の検索エンジンと Web スクレイパーに対応しています：SearXNG、Tavily、DuckDuckGo、Bing、Google、Zhipu (智谱)、Exa、Bocha (博查)、You.com など。
• ローカル Web 検索（ブラウザー検索）に対応しており、複数の検索エンジンを利用できます：Bing、Google、Baidu、Sogou など。
  • ブラウザーの自動化には agent-browser を使用します。
  • 無料で、API キーは不要です。
• 有効なツール： one_search、one_scrape、one_map、one_extract

現在のツール

• one_search
  • 設定されたプロバイダーから検索結果を返します。
• one_map
  • ブラウザーでページを読み込み、HTML からリンクを抽出して、指定された URL を起点にリンクを検出します。
  • 対応する入力フィールド：url、search、includeSubdomains、limit。
  • これはサイトマップクローラーではありません。ignoreSitemap や sitemapOnly などの削除済みフィールドは、スキーマの境界で拒否されます。
• one_scrape
  • 1 ページをスクレイピングし、formats で選択したコンテンツを返します。
  • 対応する入力フィールド：url、formats、waitFor、timeout、skipTlsVerification、allowExecuteJavascript、actions。
  • 対応フォーマット：markdown、html、rawHtml、links、screenshot、screenshot@fullPage。
  • 対応する範囲制限付きのスクレイピング前アクション：wait、click、write、press、scroll。
  • 高度なスクレイピング前アクション：executeJavascript。actions に executeJavascript が含まれる場合は、allowExecuteJavascript: true を設定する必要があります。
  • actions はコンテンツ取得前に順番に実行され、最初のアクションエラーが発生した時点で処理が失敗します。
  • onlyMainContent、extract、location などの削除済みフィールドは、スキーマの境界で拒否されます。
• one_extract
  • urls のみを受け付け、後続のツールやモデル向けに前処理済みのテキストブロックを返します。

v1.1.0 以前からの移行

v1.1.0 での重大な変更：

• Firecrawl の削除：外部 API サービスを必要とせず、同様の機能を提供する agent-browser を採用したため、Firecrawl との連携は削除されました。
• 新しいブラウザー要件：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

前提条件

ブラウザー要件：このサーバーは Web スクレイピングとローカル検索に 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

MCP Inspector を使用したローカルデバッグ

公式の MCP Inspector を使用すると、ローカル開発中にこのサーバーのツール、リソース、プロンプトを対話的にテストできます。

# Inspect the TypeScript source entrypoint
npm run inspector

# Inspect the built server entrypoint
npm run inspector:build

# Example with explicit environment variables
ALLOW_PRIVATE_NETWORK=true SEARCH_PROVIDER=local npm run inspector

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、ydc、local をサポートしており、デフォルトは local です。
• SEARCH_API_URL（任意）：SearxNG API の URL、または google の Google Custom Search Engine ID です。
• SEARCH_API_KEY（任意）：検索プロバイダーの API キーです。tavily、bing、google、zhipu、exa、bocha では必須です。
• YDC_API_KEY（任意）：SEARCH_PROVIDER=ydc に指定する You.com API キーです。

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

ブラウザのネットワークセキュリティ

• ALLOW_PRIVATE_NETWORK（任意）：true に設定すると、ブラウザーを使用するツール（one_scrape、one_map、one_extract）がプライベート、ループバック、リンクローカルのネットワークターゲットにアクセスできるようになります。デフォルトは false です。

ALLOW_PRIVATE_NETWORK=true は、信頼できる環境でのみ使用してください。有効にすると、プロンプトインジェクションや信頼できないツール入力により、MCP プロセスがデフォルトではブロックされる内部サービスを取得する可能性があります。

検索プロバイダーの設定

プロバイダー	API キーが必要	API URL が必要	備考
local	いいえ	いいえ	無料。ブラウザー自動化を使用
duckduckgo	いいえ	いいえ	無料。API キー不要
searxng	任意	はい	セルフホスト可能なメタ検索エンジン
bing	はい	いいえ	Bing Search API
tavily	はい	いいえ	Tavily API
google	はい	はい（Search Engine ID）	Google Custom Search
zhipu	はい	いいえ	智谱 AI
exa	はい	いいえ	Exa AI
bocha	はい	いいえ	博查 AI
ydc	はい	いいえ	You.com Search

その他の 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 から利用できます。

SearXNG を使用するよう OneSearch を設定します：

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

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

トラブルシューティング

ブラウザーが見つからないエラー

「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 — 詳細は LICENSE ファイルを参照してください。