marcfargas Web Search
Web search and content extraction using ddgs — a multi-engine metasearch CLI. No API keys, no signup, no browser required.
Setup
Install ddgs (run once):
uv tool install ddgs
Install Node.js dependencies for content extraction (run once):
cd {baseDir}
npm install
Search
{baseDir}/search.js "query" # Basic search (5 results)
{baseDir}/search.js "query" -n 10 # More results
{baseDir}/search.js "query" --content # Include page content as markdown
{baseDir}/search.js "query" -t w # Results from last week
{baseDir}/search.js "query" -t m # Results from last month
{baseDir}/search.js "query" -r es-es # Results in Spanish
{baseDir}/search.js "query" -b google # Use Google backend
{baseDir}/search.js "query" -n 3 --content # Combined options
Options
-n <num>— Number of results (default: 5)--content— Fetch and include page content as markdown-r <region>— Region code:us-en,es-es,de-de,fr-fr, etc. (default: none)-t <timelimit>— Filter by time:d(day),w(week),m(month),y(year)-b <backend>— Search backend:auto,all,bing,brave,duckduckgo,google,mojeek,yandex,yahoo,wikipedia(default: auto)
News Search
{baseDir}/search.js --news "query" # News search
{baseDir}/search.js --news "query" -n 10 -t w # News from last week
{baseDir}/search.js --news "query" --content # News with full article content
News backends: auto, all, bing, duckduckgo, yahoo
Extract Page Content
{baseDir}/content.js https://example.com/article
Fetches a URL and extracts readable content as markdown.
Output Format
Text search
--- Result 1 ---
Title: Page Title
Link: https://example.com/page
Snippet: Description from search results
Content: (if --content flag used)
Markdown content extracted from the page...
--- Result 2 ---
...
News search
--- Result 1 ---
Title: Article Title
Link: https://news.example.com/article
Date: 2026-02-08T10:18:00+00:00
Source: Reuters
Snippet: Article summary...
Content: (if --content flag used)
Full article as markdown...
--- Result 2 ---
...
When to Use
- Searching for documentation or API references
- Looking up facts or current information
- News search for recent events
- Fetching content from specific URLs
- Any task requiring web search without interactive browsing
- When no API key is available (unlike Brave Search)