web-searchThis skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.
Install via ClawdBot CLI:
clawdbot install billyutw/web-searchSearch the web using DuckDuckGo's API to find information across web pages, news articles, images, and videos. Returns results in multiple formats (text, markdown, JSON) with filtering options for time range, region, and safe search.
Use this skill when users request:
Install the required dependency:
pip install duckduckgo-searchThis library provides a simple Python interface to DuckDuckGo's search API without requiring API keys or authentication.
Search for web pages and information:
python scripts/search.py "<query>"Example:
python scripts/search.py "python asyncio tutorial"Returns the top 10 web results with titles, URLs, and descriptions in a clean text format.
Control the number of results returned:
python scripts/search.py "<query>" --max-results <N>Example:
python scripts/search.py "machine learning frameworks" --max-results 20Useful for:
Filter results by recency:
python scripts/search.py "<query>" --time-range <d|w|m|y>Time range options:
d - Past dayw - Past weekm - Past monthy - Past yearExample:
python scripts/search.py "artificial intelligence news" --time-range wGreat for:
Search specifically for news articles:
python scripts/search.py "<query>" --type newsExample:
python scripts/search.py "climate change" --type news --time-range w --max-results 15News results include:
Search for images:
python scripts/search.py "<query>" --type imagesExample:
python scripts/search.py "sunset over mountains" --type images --max-results 20Image filtering options:
Size filters:
python scripts/search.py "landscape photos" --type images --image-size LargeOptions: Small, Medium, Large, Wallpaper
Color filters:
python scripts/search.py "abstract art" --type images --image-color BlueOptions: color, Monochrome, Red, Orange, Yellow, Green, Blue, Purple, Pink, Brown, Black, Gray, Teal, White
Type filters:
python scripts/search.py "icons" --type images --image-type transparentOptions: photo, clipart, gif, transparent, line
Layout filters:
python scripts/search.py "wallpapers" --type images --image-layout WideOptions: Square, Tall, Wide
Image results include:
Search for videos:
python scripts/search.py "<query>" --type videosExample:
python scripts/search.py "python tutorial" --type videos --max-results 15Video filtering options:
Duration filters:
python scripts/search.py "cooking recipes" --type videos --video-duration shortOptions: short, medium, long
Resolution filters:
python scripts/search.py "documentary" --type videos --video-resolution highOptions: high, standard
Video results include:
Search with region-specific results:
python scripts/search.py "<query>" --region <region-code>Common region codes:
us-en - United States (English)uk-en - United Kingdom (English)ca-en - Canada (English)au-en - Australia (English)de-de - Germany (German)fr-fr - France (French)wt-wt - Worldwide (default)Example:
python scripts/search.py "local news" --region us-en --type newsControl safe search filtering:
python scripts/search.py "<query>" --safe-search <on|moderate|off>Options:
on - Strict filteringmoderate - Balanced filtering (default)off - No filteringExample:
python scripts/search.py "medical information" --safe-search onChoose how results are formatted:
Text format (default):
python scripts/search.py "quantum computing"Clean, readable plain text with numbered results.
Markdown format:
python scripts/search.py "quantum computing" --format markdownFormatted markdown with headers, bold text, and links.
JSON format:
python scripts/search.py "quantum computing" --format jsonStructured JSON data for programmatic processing.
Save search results to a file:
python scripts/search.py "<query>" --output <file-path>Example:
python scripts/search.py "artificial intelligence" --output ai_results.txt
python scripts/search.py "AI news" --type news --format markdown --output ai_news.md
python scripts/search.py "AI research" --format json --output ai_data.jsonThe file format is determined by the --format flag, not the file extension.
1. Page Title Here
URL: https://example.com/page
Brief description of the page content...
2. Another Result
URL: https://example.com/another
Another description...## 1. Page Title Here
**URL:** https://example.com/page
Brief description of the page content...
## 2. Another Result
**URL:** https://example.com/another
Another description...[
{
"title": "Page Title Here",
"href": "https://example.com/page",
"body": "Brief description of the page content..."
},
{
"title": "Another Result",
"href": "https://example.com/another",
"body": "Another description..."
}
]Gather comprehensive information about a subject:
# Get overview from web
python scripts/search.py "machine learning basics" --max-results 15 --output ml_web.txt
# Get recent news
python scripts/search.py "machine learning" --type news --time-range m --output ml_news.txt
# Find tutorial videos
python scripts/search.py "machine learning tutorial" --type videos --max-results 10 --output ml_videos.txtTrack news on specific topics:
python scripts/search.py "climate summit" --type news --time-range d --format markdown --output daily_climate_news.mdSearch for images with specific criteria:
python scripts/search.py "data visualization examples" --type images --image-type photo --image-size Large --max-results 25 --output viz_images.txtVerify information with recent sources:
python scripts/search.py "specific claim to verify" --time-range w --max-results 20Find resources on scholarly topics:
python scripts/search.py "quantum entanglement research" --time-range y --max-results 30 --output quantum_research.txtGather information about products or companies:
python scripts/search.py "electric vehicle market 2025" --max-results 20 --format markdown --output ev_market.md
python scripts/search.py "EV news" --type news --time-range m --output ev_news.txtWhen users request web searches:
--type)--time-range)--max-results)Command structure:
python scripts/search.py "<query>" [options]Essential options:
-t, --type - Search type (web, news, images, videos)-n, --max-results - Maximum results (default: 10)--time-range - Time filter (d, w, m, y)-r, --region - Region code (e.g., us-en, uk-en)--safe-search - Safe search level (on, moderate, off)-f, --format - Output format (text, markdown, json)-o, --output - Save to fileImage-specific options:
--image-size - Size filter (Small, Medium, Large, Wallpaper)--image-color - Color filter--image-type - Type filter (photo, clipart, gif, transparent, line)--image-layout - Layout filter (Square, Tall, Wide)Video-specific options:
--video-duration - Duration filter (short, medium, long)--video-resolution - Resolution filter (high, standard)Get full help:
python scripts/search.py --help--time-range for current information--output to preserve resultsCommon issues:
pip install duckduckgo-searchLimitations:
Gather comprehensive information by combining search types:
# Web overview
python scripts/search.py "topic" --max-results 15 --output topic_web.txt
# Recent news
python scripts/search.py "topic" --type news --time-range w --output topic_news.txt
# Images
python scripts/search.py "topic" --type images --max-results 20 --output topic_images.txtUse JSON output for automated processing:
python scripts/search.py "research topic" --format json --output results.json
# Then process with another script
python analyze_results.py results.jsonCreate searchable documentation from web results:
# Search multiple related topics
python scripts/search.py "topic1" --format markdown --output kb/topic1.md
python scripts/search.py "topic2" --format markdown --output kb/topic2.md
python scripts/search.py "topic3" --format markdown --output kb/topic3.mdThe main search tool implementing DuckDuckGo search functionality. Key features:
The script can be executed directly and includes comprehensive command-line help via --help.
Generated Feb 24, 2026
Startups can use this skill to gather competitive intelligence, analyze market trends, and identify customer needs by searching for recent news, industry reports, and competitor websites. It helps in making data-driven decisions without manual web browsing.
Marketing agencies can leverage this skill to find trending topics, source images and videos for campaigns, and verify facts for content creation. By filtering results by time and region, they ensure relevance and timeliness for target audiences.
Researchers and students can use this skill to quickly find scholarly articles, recent publications, and multimedia resources for papers or projects. The time-range filtering helps access up-to-date information, while JSON output facilitates data analysis.
Journalists can employ this skill to track breaking news, verify sources, and gather background information on events. With news-specific searches and safe-search controls, it supports ethical reporting and fact-checking in fast-paced environments.
Designers and product managers can search for images, videos, and web resources to inspire new ideas, understand user preferences, and benchmark against existing products. Image and video filters help refine searches for visual assets.
Integrate this skill into enterprise software platforms as a search module, offering enhanced web research capabilities. Revenue is generated through subscription fees based on usage tiers and advanced features like API access.
Offer a free version with basic search functions and a premium version with advanced filters, higher result limits, and priority support. Monetize through upsells to creators who need efficient content sourcing and verification.
License this skill as a white-label service for marketing or research agencies to embed in their own tools. Revenue comes from one-time setup fees and ongoing maintenance contracts, providing a customizable search experience.
💬 Integration Tip
Install the duckduckgo-search library via pip and test with basic queries first; use the JSON output format for easy data parsing in automated workflows.
Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).
AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.
Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
Search indexed Discord community discussions via Answer Overflow. Find solutions to coding problems, library issues, and community Q&A that only exist in Discord conversations.
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.
Free AI search via Exa MCP. Web search for news/info, code search for docs/examples from GitHub/StackOverflow, company research for business intel. No API key needed.