DuckDuckGo Search MCP 🔍

---

クイックスタート

# Search from the command line
npx -y @oevortex/ddg_search@latest "your search query"

# Or install globally
npm install -g @oevortex/ddg_search
ddg "your search query"

使用方法

CLI

# Basic web search (DuckDuckGo)
ddg "quantum computing"

# Get more results
ddg "latest news" -n 10

# AI-generated answer (IAsk)
ddg "explain recursion" -m ai

# AI-generated answer (Monica)
ddg "hello world" -m ai -b monica

# IAsk with options
ddg "gravity" -m ai --iask-mode academic --detail-level comprehensive

フラグ

フラグ	説明	デフォルト
-m, --mode	web または ai	web
-b, --backend	iask または monica（AI モードのみ）	iask
-n, --num-results	結果の件数（1～20、ウェブモード）	3
--iask-mode	question、academic、forums、wiki、thinking	thinking
--detail-level	concise、detailed、comprehensive	—
-h, --help	ヘルプを表示
-v, --version	バージョンを表示

MCP サーバー

Claude Desktop、OpenCode、その他の MCP クライアントで使用するには、MCP サーバーを起動します。

ddg --server

Claude Desktop の設定：

{
  "mcpServers": {
    "ddg-search": {
      "command": "npx",
      "args": ["-y", "@oevortex/ddg_search@latest"]
    }
  }
}

グローバルインストールの設定：

{
  "mcpServers": {
    "ddg-search": {
      "command": "ddg"
    }
  }
}

プログラム API

import { searchDuckDuckGo } from '@oevortex/ddg_search/src/utils/search.js';
import { searchIAsk } from '@oevortex/ddg_search/src/utils/search_iask.js';
import { searchMonica } from '@oevortex/ddg_search/src/utils/search_monica.js';

// DuckDuckGo
const results = await searchDuckDuckGo("query", 5);

// IAsk AI
const answer = await searchIAsk("query", "thinking", null);

// Monica AI
const answer = await searchMonica("query");

MCP ツールのスキーマ

統合ツール web-search：

パラメーター	型	デフォルト	説明
query	string	必須	検索クエリ
mode	"web" | "ai"	"web"	DuckDuckGo の検索結果または AI による回答
backend	"iask" | "monica"	"iask"	AI バックエンド（mode=ai のみ）
numResults	integer	3	結果の件数（ウェブモード、1～20）
iaskMode	string	"thinking"	IAsk のモード（backend=iask のみ）
detailLevel	string	—	IAsk の詳細レベル（backend=iask のみ）

エージェント用プロンプト

ウェブ検索を有効にするには、これをエージェントのシステムプロンプトに追加します。

When you need to search the web or find current information, use the DDG Search CLI:

  npx -y @oevortex/ddg_search@latest "<query>" -m ai

This runs an AI-powered web search via IAsk. For standard DuckDuckGo results (titles + URLs + snippets), use mode "web" instead:

  npx -y @oevortex/ddg_search@latest "<query>" -m web -n 5

For a different AI backend (Monica), add -b monica. Use this for any research, fact-checking, or current events task.

プロキシのサポート

HTTP_PROXY、HTTPS_PROXY、NO_PROXY 環境変数が自動的に適用されます。

HTTPS_PROXY=http://proxy:8080 ddg "search query"

インストール

npm install -g @oevortex/ddg_search

または、インストールせずに npx を使用できます。

プロジェクト構成

bin/cli.js              CLI entry point
src/
  index.ts              MCP server
  tools/
    searchTool.js       Unified search tool
  utils/
    search.js           DuckDuckGo scraper
    search_iask.js      IAsk AI client
    search_monica.js    Monica AI client
    user_agents.js      User agent rotation
skills/
  ddg-search/           Agent skill for marketplace

コントリビュート

プルリクエストを歓迎します。バグや機能リクエストについては、イシューを作成してください。

ライセンス

Apache 2.0

---