DuckDuckGo Search Skill
This skill enables free web search via DuckDuckGo. No API key required.
For premium search providers, see the dedicated skills:
- brave-search-skill - Brave Search API (independent index, privacy-focused)
- serper-search-skill - Serper API (Google-powered, news/images/places)
- perplexity-search-skill - Perplexity Sonar AI (synthesized answers with citations)
How It Works
This skill provides instructions and context. To execute web searches, connect the DuckDuckGo Search node to the agent's input-tools handle.
web_search Tool
Search the web using DuckDuckGo and get relevant results.
Schema Fields
| Field |
Type |
Required |
Description |
| query |
string |
Yes |
The search query to look up on the web |
Node Parameters
| Parameter |
Default |
Description |
| max_results |
5 |
Number of results to return |
Examples
Basic search:
{
"query": "latest news about artificial intelligence"
}
Factual search:
{
"query": "population of Tokyo 2024"
}
Current events:
{
"query": "weather forecast New York today"
}
Technical search:
{
"query": "how to use Python asyncio gather"
}
Response Format
{
"query": "artificial intelligence news",
"results": [
{
"title": "AI Breakthrough in Medical Research",
"snippet": "Researchers have developed a new AI model that can predict...",
"url": "https://example.com/ai-medical-research"
},
{
"title": "OpenAI Announces New Model",
"snippet": "The company revealed its latest advancement in...",
"url": "https://example.com/openai-announcement"
}
],
"provider": "duckduckgo"
}
When to Use DuckDuckGo Search
Use DuckDuckGo search when the user asks about:
- Current events and news - Recent happenings, breaking news, current affairs
- Real-time data - Stock prices, weather, sports scores, exchange rates
- Recent information - Events, releases, or changes after your knowledge cutoff
- Specific facts - Population, statistics, dates that may have changed
- Technical documentation - Latest API docs, library versions, tutorials
- Local information - Business hours, addresses, phone numbers
- Product information - Prices, availability, reviews
When NOT to Use DuckDuckGo Search
Avoid searching when:
- General knowledge - Well-established facts that won't change
- Simple calculations - Use the calculator tool instead
- Creative tasks - Writing, brainstorming, analysis
- Personal advice - Relationship, life decisions
- Subjective opinions - Preferences, recommendations without factual basis
Choosing the Right Search Provider
| Need |
Recommended Provider |
Tool Node |
| Free search, no API key |
DuckDuckGo |
DuckDuckGo Search |
| Google-quality results |
Serper |
Serper Search |
| News, images, places |
Serper |
Serper Search |
| Privacy-focused, independent |
Brave |
Brave Search |
| AI-synthesized answers |
Perplexity |
Perplexity Search |
| Research with citations |
Perplexity |
Perplexity Search |
Search Query Best Practices
Do:
- Use specific, focused queries
- Include relevant keywords
- Add context like dates, locations, or names
- Break complex questions into simpler searches
Don't:
- Use overly long queries (keep under 10 words when possible)
- Include unnecessary words like "please" or "can you tell me"
- Ask questions as full sentences (use keywords instead)
Examples of Good vs Bad Queries
| Bad Query |
Good Query |
| "Can you please tell me what the weather is like in London today?" |
"London weather today" |
| "I want to know about the latest iPhone model and its features" |
"iPhone 16 Pro specifications" |
| "What is happening in the stock market right now?" |
"stock market news today" |
Handling Results
- Summarize the key findings from search results
- Cite sources when providing specific information
- Indicate uncertainty if results are conflicting or unclear
- Suggest follow-up searches if the initial results are insufficient
- Combine multiple searches for comprehensive answers
Limitations
- DuckDuckGo uses the
ddgs library (free, no API key)
- Results depend on DuckDuckGo's index
- Some recent events may not be indexed immediately
- Paywalled content may show limited snippets
- Results are in English by default
Setup Requirements
- Connect this skill to the agent's
input-skill handle
- Connect the DuckDuckGo Search node to the agent's
input-tools handle
- No API key required for DuckDuckGo
1---2name: duckduckgo-search-skill3description: Search the web using DuckDuckGo for free, privacy-focused results with no API key required.4allowed-tools: "duckduckgo_search"5metadata:6 source: https://skillmd.com/skills/zeenie-ai/duckduckgo-search-skill7 author: opencompany8 version: "2.0"9 category: search1011---1213# DuckDuckGo Search Skill1415This skill enables free web search via DuckDuckGo. No API key required.1617For premium search providers, see the dedicated skills:18- **brave-search-skill** - Brave Search API (independent index, privacy-focused)19- **serper-search-skill** - Serper API (Google-powered, news/images/places)20- **perplexity-search-skill** - Perplexity Sonar AI (synthesized answers with citations)2122## How It Works2324This skill provides instructions and context. To execute web searches, connect the **DuckDuckGo Search** node to the agent's `input-tools` handle.2526## web_search Tool2728Search the web using DuckDuckGo and get relevant results.2930### Schema Fields3132| Field | Type | Required | Description |33|-------|------|----------|-------------|34| query | string | Yes | The search query to look up on the web |3536### Node Parameters3738| Parameter | Default | Description |39|-----------|---------|-------------|40| max_results | 5 | Number of results to return |4142### Examples4344**Basic search:**45```json46{47 "query": "latest news about artificial intelligence"48}49```5051**Factual search:**52```json53{54 "query": "population of Tokyo 2024"55}56```5758**Current events:**59```json60{61 "query": "weather forecast New York today"62}63```6465**Technical search:**66```json67{68 "query": "how to use Python asyncio gather"69}70```7172### Response Format7374```json75{76 "query": "artificial intelligence news",77 "results": [78 {79 "title": "AI Breakthrough in Medical Research",80 "snippet": "Researchers have developed a new AI model that can predict...",81 "url": "https://example.com/ai-medical-research"82 },83 {84 "title": "OpenAI Announces New Model",85 "snippet": "The company revealed its latest advancement in...",86 "url": "https://example.com/openai-announcement"87 }88 ],89 "provider": "duckduckgo"90}91```9293## When to Use DuckDuckGo Search9495Use DuckDuckGo search when the user asks about:96971. **Current events and news** - Recent happenings, breaking news, current affairs982. **Real-time data** - Stock prices, weather, sports scores, exchange rates993. **Recent information** - Events, releases, or changes after your knowledge cutoff1004. **Specific facts** - Population, statistics, dates that may have changed1015. **Technical documentation** - Latest API docs, library versions, tutorials1026. **Local information** - Business hours, addresses, phone numbers1037. **Product information** - Prices, availability, reviews104105## When NOT to Use DuckDuckGo Search106107Avoid searching when:1081091. **General knowledge** - Well-established facts that won't change1102. **Simple calculations** - Use the calculator tool instead1113. **Creative tasks** - Writing, brainstorming, analysis1124. **Personal advice** - Relationship, life decisions1135. **Subjective opinions** - Preferences, recommendations without factual basis114115## Choosing the Right Search Provider116117| Need | Recommended Provider | Tool Node |118|------|---------------------|-----------|119| Free search, no API key | DuckDuckGo | DuckDuckGo Search |120| Google-quality results | Serper | Serper Search |121| News, images, places | Serper | Serper Search |122| Privacy-focused, independent | Brave | Brave Search |123| AI-synthesized answers | Perplexity | Perplexity Search |124| Research with citations | Perplexity | Perplexity Search |125126## Search Query Best Practices127128### Do:129- Use specific, focused queries130- Include relevant keywords131- Add context like dates, locations, or names132- Break complex questions into simpler searches133134### Don't:135- Use overly long queries (keep under 10 words when possible)136- Include unnecessary words like "please" or "can you tell me"137- Ask questions as full sentences (use keywords instead)138139### Examples of Good vs Bad Queries140141| Bad Query | Good Query |142|-----------|------------|143| "Can you please tell me what the weather is like in London today?" | "London weather today" |144| "I want to know about the latest iPhone model and its features" | "iPhone 16 Pro specifications" |145| "What is happening in the stock market right now?" | "stock market news today" |146147## Handling Results1481491. **Summarize** the key findings from search results1502. **Cite sources** when providing specific information1513. **Indicate uncertainty** if results are conflicting or unclear1524. **Suggest follow-up searches** if the initial results are insufficient1535. **Combine multiple searches** for comprehensive answers154155## Limitations156157- DuckDuckGo uses the `ddgs` library (free, no API key)158- Results depend on DuckDuckGo's index159- Some recent events may not be indexed immediately160- Paywalled content may show limited snippets161- Results are in English by default162163## Setup Requirements1641651. Connect this skill to the agent's `input-skill` handle1662. Connect the **DuckDuckGo Search** node to the agent's `input-tools` handle1673. No API key required for DuckDuckGo