# Send Duckduckgo Search to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "ddg-search-privacy", "name": "Duckduckgo Search", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/omprasad122007-rgb/ddg-search-privacy", "canonicalUrl": "https://clawhub.ai/omprasad122007-rgb/ddg-search-privacy", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/ddg-search-privacy", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ddg-search-privacy", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "scripts/duckduckgo_search.py", "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/ddg-search-privacy" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/ddg-search-privacy", "downloadUrl": "https://openagent3.xyz/downloads/ddg-search-privacy", "agentUrl": "https://openagent3.xyz/skills/ddg-search-privacy/agent", "manifestUrl": "https://openagent3.xyz/skills/ddg-search-privacy/agent.json", "briefUrl": "https://openagent3.xyz/skills/ddg-search-privacy/agent.md" } } ``` ## Documentation ### DuckDuckGo Web Search Private web search using DuckDuckGo API for tracker-free information retrieval. ### Core Features Privacy-focused search (no tracking) Instant answer support Multiple search modes (web, images, videos, news) JSON output for easy parsing No API key required ### Basic Web Search import requests def search_duckduckgo(query, max_results=10): """ Perform DuckDuckGo search and return results. Args: query: Search query string max_results: Maximum number of results to return (default: 10) Returns: List of search results with title, url, description """ url = "https://api.duckduckgo.com/" params = { "q": query, "format": "json", "no_html": 1, "skip_disambig": 0 } response = requests.get(url, params=params) data = response.json() # Extract results results = [] # Abstract (instant answer) if data.get("Abstract"): results.append({ "type": "instant_answer", "title": "Instant Answer", "content": data["Abstract"], "source": data.get("AbstractSource", "DuckDuckGo") }) # Related topics if data.get("RelatedTopics"): for topic in data["RelatedTopics"][:max_results]: if isinstance(topic, dict) and topic.get("Text"): results.append({ "type": "related", "title": topic.get("FirstURL", "").split("/")[-1].replace("-", " ").title(), "content": topic["Text"], "url": topic.get("FirstURL", "") }) return results[:max_results] ### Advanced Usage (HTML Scraping) from bs4 import BeautifulSoup import requests def search_with_results(query, max_results=10): """ Perform DuckDuckGo search and scrape actual results. Args: query: Search query string max_results: Maximum number of results to return Returns: List of search results with title, url, snippet """ url = "https://duckduckgo.com/html/" params = {"q": query} headers = { "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" } response = requests.post(url, data=params, headers=headers) soup = BeautifulSoup(response.text, "html.parser") results = [] for result in soup.find_all("a", class_="result__a", href=True)[:max_results]: results.append({ "title": result.get_text(), "url": result["href"], "snippet": result.find_parent("div", class_="result__body").get_text().strip() }) return results ### Search Operators DuckDuckGo supports standard search operators: OperatorExampleDescription"""exact phrase"Exact phrase match-python -djangoExclude termssite:site:wikipedia.org historySearch specific sitefiletype:filetype:pdf reportSpecific file typesintitle:intitle:openclawWords in titleinurl:inurl:docs/Words in URLORdocker OR kubernetesEither term ### Web Search Default mode, searches across the web. search_with_results("machine learning tutorial") ### Images Search def search_images(query, max_results=10): url = "https://duckduckgo.com/i.js" params = { "q": query, "o": "json", "vqd": "", # Will be populated "f": ",,,", "p": "1" } response = requests.get(url, params=params) data = response.json() results = [] for result in data.get("results", [])[:max_results]: results.append({ "title": result.get("title", ""), "url": result.get("image", ""), "thumbnail": result.get("thumbnail", ""), "source": result.get("source", "") }) return results ### News Search Add !news to the query: search_duckduckgo("artificial intelligence !news") ### Query Construction Good queries: "DuckDuckGo API documentation" 2024 (specific, recent) site:github.com openclaw issues (targeted) python machine learning tutorial filetype:pdf (resource-specific) Avoid: Vague single words ("search", "find") Overly complex operators that might confuse results Questions with multiple unrelated topics ### Privacy Considerations DuckDuckGo advantages: ✅ No personal tracking ✅ No search history stored ✅ No user profiling ✅ No forced personalized results ### Performance Tips Use HTML scraping for actual results - The JSON API provides instant answers but limited result lists Add appropriate delays - Respect rate limits when making multiple queries Cache results - Store common searches to avoid repeated API calls ### Error Handling def search_safely(query, retries=3): for attempt in range(retries): try: results = search_with_results(query) if results: return results except Exception as e: if attempt == retries - 1: raise time.sleep(2 ** attempt) # Exponential backoff return [] ### Markdown Format def format_results_markdown(results, query): output = f"# Search Results for: {query}\\n\\n" for i, result in enumerate(results, 1): output += f"## {i}. {result.get('title', 'Untitled')}\\n\\n" output += f"**URL:** {result.get('url', 'N/A')}\\n\\n" output += f"{result.get('snippet', result.get('content', 'N/A'))}\\n\\n" output += "---\\n\\n" return output ### JSON Format import json def format_results_json(results, query): return json.dumps({ "query": query, "count": len(results), "results": results, "timestamp": datetime.now().isoformat() }, indent=2) ### Find Documentation search_duckduckgo(f'{library_name} documentation filetype:md') ### Recent Information search_duckduckgo(f'{topic} 2024 news') ### Troubleshooting search_duckduckgo(f'{error_message} {tool_name} stackoverflow') ### Technical Comparison search_duckduckgo('postgresql vs mysql performance 2024') ### Integration Example class DuckDuckGoSearcher: def __init__(self): self.session = requests.Session() self.session.headers.update({ "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" }) def search(self, query, mode="web", max_results=10): """ Unified search interface. Args: query: Search query mode: 'web', 'images', 'news' max_results: Maximum results Returns: Formatted results as list """ if mode == "images": return self._search_images(query, max_results) elif mode == "news": return self._search_web(f"{query} !news", max_results) else: return self._search_web(query, max_results) def _search_web(self, query, max_results): # Implementation pass def _search_images(self, query, max_results): # Implementation pass ### Official Documentation DuckDuckGo API Wiki: https://duckduckgo.com/api Instant Answer API: https://duckduckgo.com/params Search Syntax: https://help.duckduckgo.com/duckduckgo-help-pages/results/syntax/ ### References HTML scraping patterns for result extraction Rate limiting best practices Result parsing and filtering ## Trust - Source: tencent - Verification: Indexed source record - Publisher: omprasad122007-rgb - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/ddg-search-privacy) - [Send to Agent page](https://openagent3.xyz/skills/ddg-search-privacy/agent) - [JSON manifest](https://openagent3.xyz/skills/ddg-search-privacy/agent.json) - [Markdown brief](https://openagent3.xyz/skills/ddg-search-privacy/agent.md) - [Download page](https://openagent3.xyz/downloads/ddg-search-privacy)