Add: SearXNGでローカル検索APIを構築する

2026-02-22 23:52:53 +00:00
parent 3100293622
commit b49848ac65
4 changed files with 396 additions and 1 deletions
@@ -17,3 +17,7 @@ slug: /
 - [DGX Spark デュアル構成ガイド](/tech/dgx-spark-dual/) - 2台のDGX Sparkを接続して256GBメ�
 - [DGX SparkでMiniMax-M2.5-REAP-172Bを動かす](/tech/dgx-spark-minimax/) - DGX Sparkデュアル構成で172Bパラ
 - [DGX SparkでQwen3-Coder-Next（80B MoE）を動かす](/tech/dgx-spark-qwen3-coder-next/) - NVIDIA DGX Sparkの128GB統合メモリ�
+
+## その他
+
+- [SearXNGでローカル検索APIを構築する](/tech/searxng-local-search/)
@@ -0,0 +1,259 @@
+---
+sidebar_position: 10
+title: SearXNGでローカル検索APIを構築する
+description: プライバシー重視のメタ検索エンジンSearXNGをセルフホストして、無料で検索APIを手に入れる方法
+hide_table_of_contents: false
+displayed_sidebar: null
+---
+
+# SearXNGでローカル検索APIを構築する
+
+ローカルでClaude CodeやLLMエージェントを動かすとき、Web検索機能が欲しくなることがある。Brave APIやGoogle Custom Search APIは有料だったり、レート制限があったりする。
+
+**SearXNG**をセルフホストすれば、**完全無料**で検索APIが手に入る。
+
+## SearXNGとは？
+
+SearXNGは**プライバシー重視のメタ検索エンジン**（オープンソース）。
+
+```
+ユーザー → SearXNG → Google/Bing/DuckDuckGo等
+                ↓
+         結果を集約してJSON返却
+```
+
+複数の検索エンジンに代理でクエリを投げて、結果をまとめて返す。
+
+### 特徴
+
+| ポイント | 説明 |
+|----------|------|
+| **APIキー不要** | スクレイピング方式なので無料 |
+| **JSON API** | `format=json` で検索結果をJSON取得 |
+| **複数エンジン集約** | Google, Bing, DuckDuckGoなどを同時検索 |
+| **セルフホスト** | 自分のサーバーで完全コントロール |
+
+## セットアップ
+
+### 前提条件
+
+- Docker環境（LXC、VM、物理サーバー等）
+- ポート8080が空いている
+
+### ワンライナーでセットアップ
+
+```bash
+curl -fsSL https://gitea.swallow.wjg.jp/swallow/searxng-setup/raw/branch/main/setup.sh | sudo bash
+```
+
+:::tip 手動セットアップ
+プライベートリポジトリなので、以下の手順でも可能です。
+:::
+
+### 手動セットアップ
+
+```bash
+# 必要なパッケージ
+sudo apt-get update
+sudo apt-get install -y docker.io curl
+
+# ディレクトリ作成
+sudo mkdir -p /opt/searxng/searxng
+cd /opt/searxng
+
+# docker-compose.yml作成
+sudo tee docker-compose.yml << 'EOF'
+version: '3.8'
+
+services:
+  searxng:
+    image: searxng/searxng:latest
+    container_name: searxng
+    restart: unless-stopped
+    ports:
+      - "8080:8080"
+    volumes:
+      - ./searxng:/etc/searxng:rw
+    environment:
+      - SEARXNG_BASE_URL=http://localhost:8080
+EOF
+
+# 設定ファイル作成
+sudo tee searxng/settings.yml << 'EOF'
+use_default_settings: true
+
+general:
+  instance_name: "SearXNG Local"
+
+search:
+  safe_search: 0
+  autocomplete: "duckduckgo"
+  default_lang: "ja-JP"
+  formats:
+    - html
+    - json
+
+server:
+  limiter: false
+  image_proxy: true
+
+ui:
+  default_theme: simple
+  default_locale: "ja"
+EOF
+
+# 起動
+sudo docker compose up -d
+```
+
+## 使い方
+
+### Web UI
+
+ブラウザで `http://localhost:8080` にアクセス。
+
+### JSON API
+
+```bash
+# 基本的な検索
+curl "http://localhost:8080/search?q=検索ワード&format=json"
+
+# 言語指定
+curl "http://localhost:8080/search?q=test&format=json&language=ja-JP"
+
+# カテゴリ指定
+curl "http://localhost:8080/search?q=test&format=json&categories=general"
+```
+
+### レスポンス例
+
+```json
+{
+  "results": [
+    {
+      "title": "Example Title",
+      "url": "https://example.com",
+      "content": "Description...",
+      "engine": "google",
+      "engines": ["google", "bing"],
+      "score": 4.0
+    }
+  ]
+}
+```
+
+## Claude Code連携
+
+ローカルのClaude CodeからSearXNGを検索ツールとして使う。
+
+### Pythonで使う
+
+```python
+import requests
+
+def search(query: str, num_results: int = 5) -> list:
+    """SearXNGで検索"""
+    response = requests.get(
+        "http://localhost:8080/search",
+        params={"q": query, "format": "json"}
+    )
+    return response.json()["results"][:num_results]
+
+# 使用例
+results = search("Python async await")
+for r in results:
+    print(f"- {r['title']}: {r['url']}")
+```
+
+### MCP Toolとして
+
+```json
+{
+  "tools": [
+    {
+      "name": "web_search",
+      "description": "Search the web using SearXNG",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {"type": "string"}
+        },
+        "required": ["query"]
+      }
+    }
+  ]
+}
+```
+
+## 有効な検索エンジン
+
+デフォルトで以下が有効：
+
+- **Google** - Web検索
+- **Bing** - Web検索
+- **DuckDuckGo** - プライバシー重視
+- **Brave** - 広告なし
+- **Wikipedia** - 百科事典
+- **GitHub** - コード検索
+
+`settings.yml` でエンジンの有効/無効を切り替え可能。
+
+## トラブルシューティング
+
+### 検索結果が少ない
+
+一部のエンジンがIPブロックされている可能性。`settings.yml` で別のエンジンを有効化。
+
+### 起動しない
+
+```bash
+# ログ確認
+docker logs searxng
+
+# 再起動
+cd /opt/searxng && docker compose restart
+```
+
+### アップデート
+
+```bash
+cd /opt/searxng
+docker compose pull
+docker compose up -d
+```
+
+## Brave API との比較
+
+| | SearXNG | Brave API |
+|---|---------|-----------|
+| 料金 | 無料 | 有料 |
+| セットアップ | 必要 | 不要 |
+| レート制限 | なし | あり |
+| 安定性 | 自己責任 | 高い |
+| エンジン | 複数集約 | Braveのみ |
+
+**おすすめ構成:**
+- 通常 → Brave API（安定）
+- フォールバック → SearXNG
+- ローカル開発 → SearXNG一本
+
+## まとめ
+
+SearXNGをセルフホストすれば：
+
+- ✅ 完全無料で検索API
+- ✅ レート制限なし
+- ✅ 複数エンジンの結果を集約
+- ✅ ローカルLLM/エージェントと連携
+
+ローカルでClaude Codeを動かすなら、一つ立てておくと便利！
+
+## 参考リンク
+
+- [SearXNG公式ドキュメント](https://docs.searxng.org/)
+- [SearXNG GitHub](https://github.com/searxng/searxng)
+- [Docker Hub - searxng/searxng](https://hub.docker.com/r/searxng/searxng)
+
+---
+
+*この記事は2026年2月時点の情報です。*