web-search

name	web-search
description	Web search

DuckDuckGo Search

Web search and content extraction using DuckDuckGo. No API key required.

Setup

Requires Python 3.10+ and uv.

No additional setup needed. Dependencies are managed inline via uv script headers.

Search

uv run {baseDir}/search.py "query"                         # Basic search (5 results)
uv run {baseDir}/search.py "query" -n 10                   # More results (max 20)
uv run {baseDir}/search.py "query" --timelimit d           # Results from last day
uv run {baseDir}/search.py "query" --timelimit w           # Results from last week
uv run {baseDir}/search.py "query" --region de-de          # Results from Germany
uv run {baseDir}/search.py "query" -n 3 --timelimit m      # Combined options
uv run {baseDir}/search.py "query" --backend brave         # Force a single specific backend
uv run {baseDir}/search.py "query" --timeout 3             # Fail slow providers faster

Options

• -n <num> - Number of results (default: 5, max: 20)
• --region <code> - Region code (default: wt-wt for global). Examples: us-en, de-de, fr-fr
• --backend <name> - Search backend (default: auto). Options: auto, brave, google, bing, yahoo. auto queries all engines simultaneously with priority ordering — the most robust choice.
• --timeout <seconds> - Request timeout (default: 5)
• --timelimit <period> - Filter by time:
  • d - Past day
  • w - Past week
  • m - Past month
  • y - Past year

Extract Page Content

uv run {baseDir}/content.py https://example.com/article

Fetches a URL and extracts readable content as plain text.

Output Format

--- Result 1 ---
Title: Page Title
Link: https://example.com/page
Snippet: Description from search results

--- Result 2 ---
...

When to Use

• Searching for documentation or API references
• Looking up facts or current information
• Fetching content from specific URLs
• Any task requiring web search without an API key