mcp-duckduckgo 1.0.0 → 3.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +71 -5
- package/install.js +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,6 +1,13 @@
|
|
|
1
1
|
# @cooperiano/duckduckgo-mcp
|
|
2
2
|
|
|
3
|
-
Free web search MCP server using DuckDuckGo.
|
|
3
|
+
Free web search MCP server using DuckDuckGo with AI-powered research capabilities.
|
|
4
|
+
|
|
5
|
+
## Features
|
|
6
|
+
|
|
7
|
+
- **3 Powerful Tools** - Search, crawl, and research with AI-powered ranking
|
|
8
|
+
- **Parallel Crawling** - Fetch multiple pages simultaneously
|
|
9
|
+
- **Smart Ranking** - Research tool ranks results by relevance to your question
|
|
10
|
+
- **No API Keys** - Works out of the box, no rate limits
|
|
4
11
|
|
|
5
12
|
## Installation
|
|
6
13
|
|
|
@@ -27,15 +34,74 @@ Add to your Claude Code configuration:
|
|
|
27
34
|
|
|
28
35
|
### MCP Tools
|
|
29
36
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
37
|
+
#### `search`
|
|
38
|
+
|
|
39
|
+
Quick web search. Returns titles, URLs, and snippets.
|
|
40
|
+
|
|
41
|
+
```json
|
|
42
|
+
{
|
|
43
|
+
"name": "search",
|
|
44
|
+
"arguments": {
|
|
45
|
+
"query": "latest AI news 2026",
|
|
46
|
+
"limit": 10,
|
|
47
|
+
"news": "true"
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
| Parameter | Type | Default | Max | Description |
|
|
53
|
+
|-----------|------|---------|-----|-------------|
|
|
54
|
+
| `query` | string | required | - | Search query |
|
|
55
|
+
| `limit` | number | 10 | 20 | Number of results |
|
|
56
|
+
| `news` | string | - | - | Set to "true" for news only |
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
#### `search_and_crawl`
|
|
61
|
+
|
|
62
|
+
Search + crawl all result pages in parallel. Get full content from each source.
|
|
63
|
+
|
|
64
|
+
```json
|
|
65
|
+
{
|
|
66
|
+
"name": "search_and_crawl",
|
|
67
|
+
"arguments": {
|
|
68
|
+
"query": "best JavaScript frameworks 2026",
|
|
69
|
+
"count": 5,
|
|
70
|
+
"maxContentLength": 3000
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
| Parameter | Type | Default | Max | Description |
|
|
76
|
+
|-----------|------|---------|-----|-------------|
|
|
77
|
+
| `query` | string | required | - | Search query |
|
|
78
|
+
| `count` | number | 5 | 10 | Number of results to crawl |
|
|
79
|
+
| `maxContentLength` | number | 3000 | 10000 | Max characters per page |
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
#### `research`
|
|
84
|
+
|
|
85
|
+
Best for answering questions. Searches, crawls in parallel, then **ranks results by relevance** using AI-powered scoring (keywords, content quality, source authority, relevance).
|
|
86
|
+
|
|
87
|
+
```json
|
|
88
|
+
{
|
|
89
|
+
"name": "research",
|
|
90
|
+
"arguments": {
|
|
91
|
+
"question": "How does Starlink help Ukraine in the war?",
|
|
92
|
+
"count": 5,
|
|
93
|
+
"maxContentLength": 3000
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
```
|
|
33
97
|
|
|
34
98
|
## Examples
|
|
35
99
|
|
|
36
100
|
```bash
|
|
37
101
|
# In Claude Code
|
|
38
|
-
> Use
|
|
102
|
+
> Use search tool to find "latest AI news"
|
|
103
|
+
> Use search_and_crawl to research "React vs Vue"
|
|
104
|
+
> Use research tool to answer "How do quantum computers work?"
|
|
39
105
|
```
|
|
40
106
|
|
|
41
107
|
## License
|
package/install.js
CHANGED
|
@@ -6,7 +6,7 @@ const path = require('path');
|
|
|
6
6
|
const os = require('os');
|
|
7
7
|
const https = require('https');
|
|
8
8
|
|
|
9
|
-
const VERSION = '1.0
|
|
9
|
+
const VERSION = '3.1.0';
|
|
10
10
|
const BASE_URL = `https://github.com/Cooperiano/duckduckgo-mcp/releases/download/v${VERSION}`;
|
|
11
11
|
|
|
12
12
|
function getPlatform() {
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-duckduckgo",
|
|
3
|
-
"version": "1.0
|
|
4
|
-
"description": "Free web search MCP server using DuckDuckGo",
|
|
3
|
+
"version": "3.1.0",
|
|
4
|
+
"description": "Free web search MCP server using DuckDuckGo — search, crawl, research, fetch, region/time/safe filters, Instant Answer, proxy auto-detect",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"duckduckgo-mcp": "./bin/duckduckgo-mcp.js"
|