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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

RebelPotato/agent-config

doc-coauthoring

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

0 0
Explore
RebelPotato/agent-config

pdf

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

0 0
Explore
RebelPotato/agent-config

browser-tools

Interactive browser automation via Chrome DevTools Protocol. Use when you need to interact with web pages, test frontends, or when user interaction with a visible browser is required.

0 0
Explore
mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore
mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results