Agent skill

ddgs-search

Web search via the DDGS metasearch library. Use for searching for unknown documentation, facts, or any web content. Lightweight, no browser required.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/RebelPotato/agent-config/tree/main/skills/ddgs-search

SKILL.md

DDGS search

Web search and content extraction using the DDGS library. No browser required.

Usage

Run from any directory:

bash
uv run {baseDir}/search.py "python programming"                     # Basic search (5 results)
uv run {baseDir}/search.py "python programming" --proxy http://proxy.example.com:8080  # Use proxy
uv run {baseDir}/search.py "russia filetype:pdf"                    # Search with advanced query
uv run {baseDir}/search.py "python programming" -n 20               # More results
uv run {baseDir}/search.py "python programming" -r uk-en            # UK English results
uv run {baseDir}/search.py "python programming" -s off              # Disable safesearch
uv run {baseDir}/search.py "python programming" -t w2               # Results from the last two weeks
uv run {baseDir}/search.py "python programming" -p 2                # Page 2 of results
uv run {baseDir}/search.py "python programming" -b "bing,google"    # Use specific backends
uv run {baseDir}/search.py "python programming" --brief             # Show only snippets (no full text extraction)

Options

  • -n, --max-results <num> - Maximum number of results (default: 5)
  • -r, --region <code> - Region/language code: us-en, uk-en, ru-ru, etc. (default: us-en)
  • -s, --safesearch <level> - Safesearch level: on, moderate, off (default: off)
  • -t, --timelimit <period> - Time limit: d, w, m, y. (default: None)
  • -p, --page <num> - Page number of results (default: 1)
  • -b, --backend <backends> - Single or comma-delimited backends (default: auto)
    • available backends: bing, brave, duckduckgo, google, grokipedia, mojeek, yandex, yahoo, wikipedia
  • --proxy <url> - Proxy URL (default: None)
  • --brief - Suppress full text extraction from webpages (show only snippets)

Output Format

By default, the tool fetches and displays full text from each webpage:

plaintext
--- Result 1 ---
Title: Python (programming language)
Href: https://grokipedia.com/page/Python_(programming_language)
Body: Python is an interpreted, high-level, general-purpose programming language designed for code readability and simplicity, featuring a dynamic type system and support for...

Full Text:
----------------------------------------
# Python (programming language)

Python is an interpreted, high-level, general-purpose programming language...

[... truncated ...]
----------------------------------------

--- Result 2 ---
...

Use --brief to show only the search result snippets without full text extraction.

When to Use

  • Searching for documentation or API references
  • Looking up facts or current information
  • Any task requiring web search without interactive browsing

Next Steps

Useful commands

  • Use curl to fetch webpage or download files
  • Use uvx html2text to convert webpages into readable text
  • Use pdftotext or uvx pdfplumber to extract text from PDF documents

Didn't find tool you were looking for?

Be as detailed as possible for better results