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 服务

启动 MCP 服务，以便与 Claude Desktop、OpenCode 或其他 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	字符串	必填	搜索查询
mode	"web" | "ai"	"web"	DuckDuckGo 搜索结果或 AI 回答
backend	"iask" | "monica"	"iask"	AI 后端（仅 mode=ai）
numResults	整数	3	结果数量（网页模式，1-20）
iaskMode	字符串	"thinking"	IAsk 模式（仅 backend=iask）
detailLevel	字符串	—	IAsk 详细程度（仅 backend=iask）

Agent 提示词

将以下内容添加到 Agent 的系统提示词中，以启用网页搜索：

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

贡献

欢迎提交拉取请求。发现错误或希望提出功能请求，请新建 issue。

许可证

Apache 2.0

---