Package Exports

n8n-nodes-duckduckgo-search
n8n-nodes-duckduckgo-search/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (n8n-nodes-duckduckgo-search) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

DuckDuckGo n8n Node - Enhanced 2025 Edition

A comprehensive n8n community node for seamless DuckDuckGo search integration with advanced pagination, enhanced error handling, and compatibility with 2025 DuckDuckGo API updates.

🚀 Latest Updates (2025)

New Features

Enhanced Error Handling: Robust error management with intelligent retry mechanisms
Improved Stock Quotes: Multiple fallback strategies for stock data with better accuracy
Advanced VQD Pagination: Enhanced pagination system with hybrid fallback strategies
2025 API Compatibility: Updated to work with latest DuckDuckGo API changes
Better Rate Limiting: Improved rate limiting to prevent API blocks
Retry Mechanisms: Automatic retry with exponential backoff for failed requests

Fixes Applied

Stock Data Issues: Fixed null value problems with enhanced data validation
Pagination Errors: Resolved VQD token expiration and pagination failures
Network Resilience: Better handling of network timeouts and connection issues
Image Search: Improved compatibility with DuckDuckGo's image search changes

🌟 Features

Search Operations

Web Search: Comprehensive web search with advanced pagination
Image Search: Find images with enhanced filtering options
News Search: Discover latest news articles with date filtering
Video Search: Search for videos from multiple sources
Instant Answer: Get quick answers and definitions
Dictionary: Word definitions with examples and synonyms
Stock Quotes: Real-time stock information with fallback sources
Currency Conversion: Live exchange rates and conversions

Advanced Capabilities

Smart Pagination: Up to 150+ results with intelligent VQD token management
Caching: Built-in caching system for improved performance
Rate Limiting: Intelligent rate limiting to prevent API blocks
Error Recovery: Automatic error recovery with multiple retry strategies
Proxy Support: HTTPS and SOCKS proxy configuration
Search Operators: Advanced search operators (site:, filetype:, etc.)
Telemetry: Optional usage analytics for debugging

📦 Installation

Install via npm:

npm install n8n-nodes-duckduckgo-search

Or install directly in n8n:

Go to Settings > Community Nodes
Enter: n8n-nodes-duckduckgo-search
Install the node

🔧 Configuration

Basic Setup

Add the DuckDuckGo node to your workflow
Select your desired operation
Configure search parameters
Optional: Add API credentials for enhanced features

API Credentials (Optional)

Create credentials for enhanced features:

Name: Any descriptive name
API Key: Your DuckDuckGo API key (if available)

💡 Usage Examples

Web Search with Pagination

{
  "operation": "search",
  "query": "n8n automation platform",
  "webSearchOptions": {
    "maxResults": 50,
    "region": "us-en",
    "safeSearch": 1,
    "timePeriod": "m"
  }
}

Image Search with Filters

{
  "operation": "searchImages",
  "imageQuery": "mountain landscape",
  "imageSearchOptions": {
    "maxResults": 30,
    "safeSearch": 1,
    "size": "large",
    "color": "color",
    "type": "photo"
  }
}

Stock Information

{
  "operation": "stocks",
  "stockSymbol": "AAPL"
}

Advanced Search with Operators

{
  "operation": "search",
  "query": "automation",
  "webSearchOptions": {
    "useSearchOperators": true,
    "searchOperators": {
      "site": "github.com",
      "filetype": "md",
      "exclude": ["spam", "ads"]
    }
  }
}

🔍 Search Operations

Web Search

Query: Your search terms
Max Results: Up to 150 results with smart pagination
Region: Localized search results
Safe Search: Content filtering options
Time Period: Filter by date range
Search Operators: Advanced search syntax

Image Search

Query: Image search terms
Max Results: Up to 100 images
Safe Search: Content filtering
Size: Image size preferences (small, medium, large)
Color: Color filtering options
Type: Image type (photo, clipart, line drawing)

News Search

Query: News search terms
Max Results: Up to 50 articles
Time Period: Recent news filtering
Region: Localized news sources

Video Search

Query: Video search terms
Max Results: Up to 50 videos
Safe Search: Content filtering
Duration: Video length preferences
Resolution: Video quality options

⚡ Performance Features

Enhanced Pagination

VQD Token Management: Automatic token caching and renewal
Hybrid Strategies: Multiple fallback methods for reliable results
Smart Rate Limiting: Adaptive delays to prevent blocks
Error Recovery: Automatic retry with exponential backoff

Caching System

Result Caching: Cache frequent searches for faster responses
TTL Management: Configurable cache expiration
Memory Efficient: Automatic cleanup of expired entries

Error Handling

Graceful Degradation: Fallback strategies when primary methods fail
Detailed Logging: Comprehensive error information for debugging
Retry Logic: Smart retry with increasing delays

🛠️ Advanced Configuration

Rate Limiting

{
  "rateLimitSettings": {
    "requestsPerMinute": 30,
    "burstLimit": 10,
    "enableAdaptive": true
  }
}

Caching

{
  "cacheSettings": {
    "enableCache": true,
    "cacheTTL": 300,
    "maxCacheSize": 100
  }
}

Proxy Configuration

{
  "proxySettings": {
    "enableProxy": true,
    "proxyUrl": "http://proxy:8080",
    "proxyType": "http"
  }
}

🐛 Troubleshooting

Common Issues

Rate Limiting

If you encounter rate limiting:

Increase delays between requests
Enable adaptive rate limiting
Use caching to reduce API calls

VQD Token Errors

For VQD token issues:

Tokens are automatically refreshed
Clear cache if problems persist
Enable debug mode for detailed logs

Empty Results

If getting empty results:

Check search terms for typos
Try different regions or time periods
Verify DuckDuckGo service availability

Debug Mode

Enable debug mode for detailed logging:

{
  "debugMode": true
}

📊 Output Format

All operations return structured data with consistent formatting:

{
  "sourceType": "web|image|news|video|instantAnswer|dictionary|stock|currency",
  "title": "Result title",
  "url": "Result URL",
  "description": "Result description",
  // Operation-specific fields
}

🔒 Privacy & Security

No Tracking: DuckDuckGo doesn't track users
Privacy Focused: Minimal data collection
Secure: HTTPS-only connections
Optional Telemetry: Completely optional usage analytics

🤝 Contributing

Contributions welcome! Please read our contributing guidelines and submit pull requests.

📝 License

MIT License - see LICENSE.md

🔗 Links

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
n8n Community: n8n Community Forum

Made with ❤️ for the n8n community