n8n-nodes-duckduckgo-search 30.0.5 → 31.0.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
CHANGED
|
@@ -1,377 +1,432 @@
|
|
|
1
|
-
# DuckDuckGo Search Node for n8n
|
|
2
|
-
|
|
3
|
-
[](https://opensource.org/licenses/MIT)
|
|
5
|
-
|
|
6
|
-
A powerful and comprehensive n8n community node that seamlessly integrates DuckDuckGo search capabilities into your workflows. Search the web, find images, discover news, and explore videos - all with privacy-focused, reliable results.
|
|
7
|
-
|
|
8
|
-
## ✨ Features
|
|
9
|
-
|
|
10
|
-
###
|
|
11
|
-
- **
|
|
12
|
-
- **
|
|
13
|
-
- **
|
|
14
|
-
- **
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
- **
|
|
19
|
-
- **
|
|
20
|
-
- **
|
|
21
|
-
- **
|
|
22
|
-
- **
|
|
23
|
-
|
|
24
|
-
###
|
|
25
|
-
- **
|
|
26
|
-
- **
|
|
27
|
-
- **
|
|
28
|
-
- **
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
###
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
"
|
|
89
|
-
"
|
|
90
|
-
|
|
91
|
-
}
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
"
|
|
100
|
-
"
|
|
101
|
-
"
|
|
102
|
-
"
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
"
|
|
112
|
-
"
|
|
113
|
-
|
|
114
|
-
"
|
|
115
|
-
"
|
|
116
|
-
"
|
|
117
|
-
"
|
|
118
|
-
}
|
|
119
|
-
}
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
**Sample Output:**
|
|
123
|
-
```json
|
|
124
|
-
[
|
|
125
|
-
{
|
|
126
|
-
"title": "
|
|
127
|
-
"url": "https://
|
|
128
|
-
"
|
|
129
|
-
"
|
|
130
|
-
"
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
"
|
|
140
|
-
"
|
|
141
|
-
|
|
142
|
-
"
|
|
143
|
-
"
|
|
144
|
-
"
|
|
145
|
-
|
|
146
|
-
}
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
"
|
|
155
|
-
"
|
|
156
|
-
"
|
|
157
|
-
"publishedDate": "2025-06-
|
|
158
|
-
"
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
|
214
|
-
|
|
215
|
-
|
|
|
216
|
-
|
|
|
217
|
-
|
|
|
218
|
-
|
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
- **
|
|
233
|
-
- **
|
|
234
|
-
- **
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
-
|
|
244
|
-
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
-
|
|
248
|
-
-
|
|
249
|
-
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
- **
|
|
281
|
-
- **
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
-
|
|
289
|
-
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
-
|
|
294
|
-
-
|
|
295
|
-
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
-
|
|
300
|
-
-
|
|
301
|
-
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
- **
|
|
314
|
-
- **
|
|
315
|
-
- **
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
**
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
-
|
|
326
|
-
|
|
327
|
-
**
|
|
328
|
-
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
**
|
|
334
|
-
-
|
|
335
|
-
-
|
|
336
|
-
-
|
|
337
|
-
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
-
|
|
349
|
-
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
-
|
|
362
|
-
- **
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
- **
|
|
369
|
-
- **
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
1
|
+
# DuckDuckGo Search Node for n8n
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/n8n-nodes-duckduckgo-search)
|
|
4
|
+
[](https://opensource.org/licenses/MIT)
|
|
5
|
+
|
|
6
|
+
A powerful and comprehensive n8n community node that seamlessly integrates DuckDuckGo search capabilities into your workflows. Search the web, find images, discover news, and explore videos - all with privacy-focused, reliable results.
|
|
7
|
+
|
|
8
|
+
## ✨ Features
|
|
9
|
+
|
|
10
|
+
### 🤖 **AI Agent Integration** (New in v31.0.0)
|
|
11
|
+
- **Agent Tool Support**: Use as a tool in n8n AI Agent workflows
|
|
12
|
+
- **LLM-Optimized**: Clean interface designed for AI agent consumption
|
|
13
|
+
- **Structured Output**: Predictable format perfect for downstream AI processing
|
|
14
|
+
- **Production-Ready**: Enterprise-grade reliability for agent workloads
|
|
15
|
+
- **Enable**: Set `N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true` environment variable
|
|
16
|
+
|
|
17
|
+
### 🛡️ **Advanced Reliability System** (New in v31.0.0)
|
|
18
|
+
- **Adaptive Backoff**: Automatically backs off on consecutive empty results
|
|
19
|
+
- **Jittered Delays**: Prevents thundering herd in parallel execution
|
|
20
|
+
- **Circuit Breaker**: Automatic failure detection and recovery
|
|
21
|
+
- **Retry Logic**: Configurable retries with exponential backoff
|
|
22
|
+
- **Metrics Tracking**: Monitor performance, failures, and circuit state
|
|
23
|
+
|
|
24
|
+
### 🔍 **Complete Search Coverage**
|
|
25
|
+
- **Web Search**: Comprehensive web search with rich content extraction
|
|
26
|
+
- **Image Search**: High-quality image discovery with metadata
|
|
27
|
+
- **News Search**: Real-time news from diverse sources worldwide
|
|
28
|
+
- **Video Search**: Video content discovery across multiple platforms
|
|
29
|
+
|
|
30
|
+
### 🚀 **Advanced Capabilities**
|
|
31
|
+
- **Smart Query Processing**: Intelligent query enhancement and optimization
|
|
32
|
+
- **Rich Results**: Complete metadata including titles, descriptions, sources, and dates
|
|
33
|
+
- **Multiple Formats**: Support for various content types and file formats
|
|
34
|
+
- **Language Support**: 50+ language and region combinations
|
|
35
|
+
- **Search Operators**: Advanced search syntax (`site:`, `intitle:`, `filetype:`, etc.)
|
|
36
|
+
- **Safe Search**: Configurable content filtering options
|
|
37
|
+
|
|
38
|
+
### 🛡️ **Privacy & Performance**
|
|
39
|
+
- **No API Keys Required**: Completely free to use without registration
|
|
40
|
+
- **Privacy-Focused**: No user tracking or data collection
|
|
41
|
+
- **High Performance**: Optimized for speed and reliability under load
|
|
42
|
+
- **Error Handling**: Robust error recovery and retry mechanisms
|
|
43
|
+
- **Rate Limiting**: Intelligent protection against overuse
|
|
44
|
+
|
|
45
|
+
## 📦 Installation
|
|
46
|
+
|
|
47
|
+
### Via npm
|
|
48
|
+
```bash
|
|
49
|
+
npm install n8n-nodes-duckduckgo-search
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
### Via n8n Interface
|
|
53
|
+
1. Go to **Settings** → **Community Nodes**
|
|
54
|
+
2. Enter: `n8n-nodes-duckduckgo-search`
|
|
55
|
+
3. Click **Install**
|
|
56
|
+
4. Restart n8n if required
|
|
57
|
+
|
|
58
|
+
## 🚀 Quick Start
|
|
59
|
+
|
|
60
|
+
### Standard Usage
|
|
61
|
+
|
|
62
|
+
1. **Add Node**: Drag the **DuckDuckGo Search** node into your workflow
|
|
63
|
+
2. **Choose Operation**: Select Web, Image, News, or Video search
|
|
64
|
+
3. **Enter Query**: Type your search terms
|
|
65
|
+
4. **Configure Options**: Set result limits, language, and filters
|
|
66
|
+
5. **Execute**: Run your workflow and get results!
|
|
67
|
+
|
|
68
|
+
### AI Agent Usage
|
|
69
|
+
|
|
70
|
+
Use DuckDuckGo Search as a tool in AI Agent workflows for intelligent, autonomous search:
|
|
71
|
+
|
|
72
|
+
1. **Enable Community Tools**: Set environment variable `N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true`
|
|
73
|
+
2. **Add AI Agent**: Create an AI Agent node in your workflow
|
|
74
|
+
3. **Connect Tool**: Add DuckDuckGo Search node as a tool to your agent
|
|
75
|
+
4. **Configure**: The agent will automatically use the search tool when needed
|
|
76
|
+
5. **Run**: Let your AI agent autonomously search and process results
|
|
77
|
+
|
|
78
|
+
The node provides clean, structured output optimized for LLM consumption with automatic handling of parallel requests and rate limits.
|
|
79
|
+
|
|
80
|
+
## 🔧 Usage Examples
|
|
81
|
+
|
|
82
|
+
### Web Search
|
|
83
|
+
```json
|
|
84
|
+
{
|
|
85
|
+
"operation": "search",
|
|
86
|
+
"query": "artificial intelligence trends 2025",
|
|
87
|
+
"webSearchOptions": {
|
|
88
|
+
"maxResults": 20,
|
|
89
|
+
"region": "us-en",
|
|
90
|
+
"safeSearch": 1
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
**Sample Output:**
|
|
96
|
+
```json
|
|
97
|
+
[
|
|
98
|
+
{
|
|
99
|
+
"title": "AI Trends 2025: What to Expect",
|
|
100
|
+
"url": "https://example.com/ai-trends-2025",
|
|
101
|
+
"description": "Comprehensive overview of artificial intelligence trends...",
|
|
102
|
+
"hostname": "example.com"
|
|
103
|
+
}
|
|
104
|
+
]
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
### Image Search
|
|
108
|
+
```json
|
|
109
|
+
{
|
|
110
|
+
"operation": "searchImages",
|
|
111
|
+
"imageQuery": "sunset mountains landscape",
|
|
112
|
+
"imageSearchOptions": {
|
|
113
|
+
"maxResults": 15,
|
|
114
|
+
"safeSearch": 1,
|
|
115
|
+
"size": "large",
|
|
116
|
+
"color": "color",
|
|
117
|
+
"type": "photo"
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
**Sample Output:**
|
|
123
|
+
```json
|
|
124
|
+
[
|
|
125
|
+
{
|
|
126
|
+
"title": "Beautiful Mountain Sunset",
|
|
127
|
+
"url": "https://example.com/mountain-sunset.jpg",
|
|
128
|
+
"thumbnail": "https://example.com/thumb.jpg",
|
|
129
|
+
"height": 1080,
|
|
130
|
+
"width": 1920,
|
|
131
|
+
"source": "Photography Site"
|
|
132
|
+
}
|
|
133
|
+
]
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
### News Search
|
|
137
|
+
```json
|
|
138
|
+
{
|
|
139
|
+
"operation": "searchNews",
|
|
140
|
+
"newsQuery": "renewable energy breakthrough",
|
|
141
|
+
"newsSearchOptions": {
|
|
142
|
+
"maxResults": 10,
|
|
143
|
+
"region": "us-en",
|
|
144
|
+
"safeSearch": 1,
|
|
145
|
+
"timePeriod": "d"
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
**Sample Output:**
|
|
151
|
+
```json
|
|
152
|
+
[
|
|
153
|
+
{
|
|
154
|
+
"title": "Major Breakthrough in Solar Energy Efficiency",
|
|
155
|
+
"url": "https://news.example.com/solar-breakthrough",
|
|
156
|
+
"description": "Scientists announce 40% efficiency improvement...",
|
|
157
|
+
"publishedDate": "2025-06-29",
|
|
158
|
+
"source": "Tech News Daily"
|
|
159
|
+
}
|
|
160
|
+
]
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### Video Search
|
|
164
|
+
```json
|
|
165
|
+
{
|
|
166
|
+
"operation": "searchVideos",
|
|
167
|
+
"videoQuery": "machine learning tutorial",
|
|
168
|
+
"videoSearchOptions": {
|
|
169
|
+
"maxResults": 12,
|
|
170
|
+
"safeSearch": 1,
|
|
171
|
+
"duration": "medium",
|
|
172
|
+
"resolution": "high"
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
**Sample Output:**
|
|
178
|
+
```json
|
|
179
|
+
[
|
|
180
|
+
{
|
|
181
|
+
"title": "Complete Machine Learning Tutorial",
|
|
182
|
+
"url": "https://video.example.com/ml-tutorial",
|
|
183
|
+
"thumbnail": "https://video.example.com/thumb.jpg",
|
|
184
|
+
"duration": "15:30",
|
|
185
|
+
"publishedDate": "2025-06-20",
|
|
186
|
+
"views": "125000",
|
|
187
|
+
"source": "Educational Channel"
|
|
188
|
+
}
|
|
189
|
+
]
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
## ⚙️ Configuration Options
|
|
193
|
+
|
|
194
|
+
### Reliability Settings (New in v31.0.0)
|
|
195
|
+
|
|
196
|
+
Advanced reliability features for production workloads:
|
|
197
|
+
|
|
198
|
+
| Setting | Default | Description |
|
|
199
|
+
|---------|---------|-------------|
|
|
200
|
+
| **Enable Reliability** | true | Master switch for all reliability features |
|
|
201
|
+
| **Empty Result Threshold** | 3 | Consecutive empty results before backoff |
|
|
202
|
+
| **Initial Backoff** | 1000ms | Starting backoff delay |
|
|
203
|
+
| **Max Backoff** | 30000ms | Maximum backoff delay |
|
|
204
|
+
| **Min Jitter** | 100ms | Minimum random delay |
|
|
205
|
+
| **Max Jitter** | 500ms | Maximum random delay |
|
|
206
|
+
| **Failure Threshold** | 5 | Failures before circuit opens |
|
|
207
|
+
| **Circuit Reset Timeout** | 60000ms | Time before retry after circuit opens |
|
|
208
|
+
| **Max Retries** | 3 | Maximum retry attempts |
|
|
209
|
+
| **Retry Delay** | 1000ms | Base delay between retries |
|
|
210
|
+
|
|
211
|
+
### Search Types
|
|
212
|
+
|
|
213
|
+
| Operation | Description | Max Results |
|
|
214
|
+
|-----------|-------------|-------------|
|
|
215
|
+
| **Web Search** | General web content search | 1-50 |
|
|
216
|
+
| **Image Search** | Image and visual content discovery | 1-50 |
|
|
217
|
+
| **News Search** | News articles and current events | 1-50 |
|
|
218
|
+
| **Video Search** | Video content from various platforms | 1-50 |
|
|
219
|
+
|
|
220
|
+
### Common Parameters
|
|
221
|
+
|
|
222
|
+
| Parameter | Type | Description | Default |
|
|
223
|
+
|-----------|------|-------------|---------|
|
|
224
|
+
| `query` | string | Search terms | Required |
|
|
225
|
+
| `maxResults` | number | Number of results to return | 10 |
|
|
226
|
+
| `region` | string | Language/region code (us-en, de-de, etc.) | us-en |
|
|
227
|
+
| `safeSearch` | number | Safe search level (0=off, 1=moderate, 2=strict) | 1 |
|
|
228
|
+
|
|
229
|
+
### Advanced Options
|
|
230
|
+
|
|
231
|
+
#### Web Search Options
|
|
232
|
+
- **timePeriod**: Filter by time range (d, w, m, y)
|
|
233
|
+
- **searchOperators**: Use advanced search operators
|
|
234
|
+
- **useSearchOperators**: Enable operator parsing
|
|
235
|
+
|
|
236
|
+
#### Image Search Options
|
|
237
|
+
- **size**: Image size (small, medium, large, wallpaper)
|
|
238
|
+
- **color**: Color filter (color, monochrome, red, orange, etc.)
|
|
239
|
+
- **type**: Image type (photo, clipart, gif, transparent)
|
|
240
|
+
- **layout**: Image layout (square, tall, wide)
|
|
241
|
+
|
|
242
|
+
#### News Search Options
|
|
243
|
+
- **timePeriod**: Time range for news (d, w, m, y)
|
|
244
|
+
- **sortBy**: Sort order (date, relevance)
|
|
245
|
+
|
|
246
|
+
#### Video Search Options
|
|
247
|
+
- **duration**: Video length (short, medium, long)
|
|
248
|
+
- **resolution**: Video quality (high, standard)
|
|
249
|
+
- **publishedTime**: When published (d, w, m, y)
|
|
250
|
+
|
|
251
|
+
## 🔍 Advanced Search Operators
|
|
252
|
+
|
|
253
|
+
Use powerful search operators to refine your results:
|
|
254
|
+
|
|
255
|
+
| Operator | Example | Description |
|
|
256
|
+
|----------|---------|-------------|
|
|
257
|
+
| `site:` | `site:github.com` | Search within specific site |
|
|
258
|
+
| `filetype:` | `filetype:pdf` | Find specific file types |
|
|
259
|
+
| `intitle:` | `intitle:"machine learning"` | Search in page titles |
|
|
260
|
+
| `inurl:` | `inurl:tutorial` | Search in URLs |
|
|
261
|
+
| `"exact phrase"` | `"artificial intelligence"` | Exact phrase matching |
|
|
262
|
+
| `-exclude` | `python -snake` | Exclude specific terms |
|
|
263
|
+
| `OR` | `cat OR dog` | Either term |
|
|
264
|
+
|
|
265
|
+
**Example with operators:**
|
|
266
|
+
```json
|
|
267
|
+
{
|
|
268
|
+
"query": "site:github.com filetype:md machine learning",
|
|
269
|
+
"useSearchOperators": true
|
|
270
|
+
}
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
## 🌍 Supported Languages & Regions
|
|
274
|
+
|
|
275
|
+
The node supports 50+ language and region combinations:
|
|
276
|
+
|
|
277
|
+
- **English**: us-en, uk-en, au-en, ca-en, etc.
|
|
278
|
+
- **Spanish**: es-es, mx-es, ar-es, etc.
|
|
279
|
+
- **French**: fr-fr, ca-fr, ch-fr
|
|
280
|
+
- **German**: de-de, at-de, ch-de
|
|
281
|
+
- **And many more**: ja-jp, zh-cn, ru-ru, pt-br, it-it, nl-nl, etc.
|
|
282
|
+
|
|
283
|
+
## 💡 Use Cases
|
|
284
|
+
|
|
285
|
+
### Content Marketing
|
|
286
|
+
- Research trending topics and keywords
|
|
287
|
+
- Find images for blog posts and social media
|
|
288
|
+
- Monitor news about your industry
|
|
289
|
+
- Discover video content for inspiration
|
|
290
|
+
|
|
291
|
+
### Data Analysis
|
|
292
|
+
- Gather web content for analysis
|
|
293
|
+
- Build datasets from search results
|
|
294
|
+
- Monitor brand mentions and sentiment
|
|
295
|
+
- Track competitor content strategies
|
|
296
|
+
|
|
297
|
+
### Research & Development
|
|
298
|
+
- Academic research and literature review
|
|
299
|
+
- Technical documentation discovery
|
|
300
|
+
- Industry trend analysis
|
|
301
|
+
- Competitive intelligence gathering
|
|
302
|
+
|
|
303
|
+
### Automation Workflows
|
|
304
|
+
- Automated content curation
|
|
305
|
+
- News monitoring and alerts
|
|
306
|
+
- Image collection for projects
|
|
307
|
+
- SEO research and optimization
|
|
308
|
+
|
|
309
|
+
## 🛠️ Workflow Integration
|
|
310
|
+
|
|
311
|
+
### Input Parameters
|
|
312
|
+
All search operations accept standardized input parameters that can be:
|
|
313
|
+
- **Hard-coded** in the node configuration
|
|
314
|
+
- **Passed dynamically** from previous workflow steps
|
|
315
|
+
- **Combined** with expressions and variables
|
|
316
|
+
|
|
317
|
+
### Output Structure
|
|
318
|
+
Results are returned as structured JSON arrays with consistent formatting:
|
|
319
|
+
- **Standardized fields** across all search types
|
|
320
|
+
- **Rich metadata** for comprehensive analysis
|
|
321
|
+
- **Clean, parsed content** ready for further processing
|
|
322
|
+
|
|
323
|
+
### Error Handling
|
|
324
|
+
Robust error handling provides:
|
|
325
|
+
- **Descriptive error messages** for troubleshooting
|
|
326
|
+
- **Graceful failure handling** to prevent workflow breaks
|
|
327
|
+
- **Retry mechanisms** for temporary issues
|
|
328
|
+
- **Input validation** to catch configuration errors
|
|
329
|
+
|
|
330
|
+
## 📊 Performance & Limits
|
|
331
|
+
|
|
332
|
+
### Advanced Reliability (v31.0.0)
|
|
333
|
+
- **Adaptive Backoff**: Automatic delay adjustment based on response patterns
|
|
334
|
+
- **Circuit Breaker**: Prevents cascading failures with automatic recovery
|
|
335
|
+
- **Jittered Delays**: Randomized timing prevents thundering herd
|
|
336
|
+
- **Retry Logic**: Exponential backoff with configurable attempts
|
|
337
|
+
- **Metrics Tracking**: Real-time monitoring of performance and failures
|
|
338
|
+
|
|
339
|
+
### Rate Limiting
|
|
340
|
+
- **Built-in protection** against overuse
|
|
341
|
+
- **Intelligent delay mechanisms** between requests
|
|
342
|
+
- **Configurable retry logic** for failed requests
|
|
343
|
+
- **Circuit breaking** for automatic failure handling
|
|
344
|
+
|
|
345
|
+
### Result Limits
|
|
346
|
+
- **Web Search**: Up to 50 results per request
|
|
347
|
+
- **Image Search**: Up to 50 images per request
|
|
348
|
+
- **News Search**: Up to 50 articles per request
|
|
349
|
+
- **Video Search**: Up to 50 videos per request
|
|
350
|
+
|
|
351
|
+
### Performance Tips
|
|
352
|
+
- Use **specific queries** for better, faster results
|
|
353
|
+
- Set **appropriate result limits** for your use case
|
|
354
|
+
- Leverage **caching** for repeated searches
|
|
355
|
+
- Use **search operators** to narrow results efficiently
|
|
356
|
+
- Enable **reliability features** for production workloads
|
|
357
|
+
- Monitor **circuit breaker state** in high-volume scenarios
|
|
358
|
+
|
|
359
|
+
## 🔒 Privacy & Security
|
|
360
|
+
|
|
361
|
+
### Privacy-First Design
|
|
362
|
+
- **No user tracking** or data collection
|
|
363
|
+
- **No API keys required** - completely free
|
|
364
|
+
- **Direct DuckDuckGo integration** without third-party services
|
|
365
|
+
- **Secure HTTP client** configuration
|
|
366
|
+
|
|
367
|
+
### Data Handling
|
|
368
|
+
- **Minimal data retention** - results processed and returned immediately
|
|
369
|
+
- **No persistent storage** of search queries or results
|
|
370
|
+
- **Clean HTTP requests** without unnecessary headers or tracking
|
|
371
|
+
|
|
372
|
+
## 🆘 Troubleshooting
|
|
373
|
+
|
|
374
|
+
### Common Issues
|
|
375
|
+
|
|
376
|
+
**Empty Results**
|
|
377
|
+
- Check your search query for typos
|
|
378
|
+
- Try broader search terms
|
|
379
|
+
- Verify region/language settings
|
|
380
|
+
- Ensure safe search settings are appropriate
|
|
381
|
+
|
|
382
|
+
**Slow Performance**
|
|
383
|
+
- Reduce the number of results requested
|
|
384
|
+
- Use more specific search queries
|
|
385
|
+
- Check your network connection
|
|
386
|
+
- Consider using search operators to narrow results
|
|
387
|
+
|
|
388
|
+
**Configuration Errors**
|
|
389
|
+
- Verify all required parameters are provided
|
|
390
|
+
- Check parameter data types and formats
|
|
391
|
+
- Ensure region codes are valid
|
|
392
|
+
- Validate search operator syntax
|
|
393
|
+
|
|
394
|
+
## 📚 API Reference
|
|
395
|
+
|
|
396
|
+
### Node Properties
|
|
397
|
+
|
|
398
|
+
#### Required Parameters
|
|
399
|
+
- `operation`: The search operation to perform
|
|
400
|
+
- `query`: The search terms (varies by operation type)
|
|
401
|
+
|
|
402
|
+
#### Optional Parameters
|
|
403
|
+
- `maxResults`: Number of results to return (1-50)
|
|
404
|
+
- `region`: Language/region code
|
|
405
|
+
- `safeSearch`: Safe search filtering level
|
|
406
|
+
- Additional operation-specific options
|
|
407
|
+
|
|
408
|
+
### Output Format
|
|
409
|
+
|
|
410
|
+
All operations return an array of result objects with operation-specific fields but consistent structure for easy processing in your workflows.
|
|
411
|
+
|
|
412
|
+
## 🤝 Support & Contributing
|
|
413
|
+
|
|
414
|
+
### Getting Help
|
|
415
|
+
- **Documentation**: This README covers most use cases
|
|
416
|
+
- **GitHub Issues**: Report bugs or request features
|
|
417
|
+
- **Community**: Join the n8n community for discussions
|
|
418
|
+
|
|
419
|
+
### Contributing
|
|
420
|
+
This is an open-source project. Contributions are welcome:
|
|
421
|
+
- **Bug Reports**: Help us improve reliability
|
|
422
|
+
- **Feature Requests**: Suggest new capabilities
|
|
423
|
+
- **Code Contributions**: Submit pull requests
|
|
424
|
+
- **Documentation**: Help improve guides and examples
|
|
425
|
+
|
|
426
|
+
## 📄 License
|
|
427
|
+
|
|
428
|
+
MIT License - see the [LICENSE](LICENSE.md) file for details.
|
|
429
|
+
|
|
430
|
+
---
|
|
431
|
+
|
|
432
|
+
**Ready to get started?** Install the node and begin searching with DuckDuckGo's powerful, privacy-focused search capabilities in your n8n workflows today!
|