mcpField
W
web-search

web-search

github.com/marcfargasProductivity482 installsUpdated 37w ago
Repository

About web-search

A CLI-based web search and page extraction skill for research that does not require an API key or browser. It uses ddgs for multi-engine text and news searches, and can extract readable page content as Markdown.

Key features

  1. 01Multi-engine text and news search
  2. 02Adjustable result count and time range
  3. 03Region and search backend options
  4. 04Optional page-content retrieval in search
  5. 05Extracts URLs into readable Markdown

Use cases

  1. 01Finding documentation and API references
  2. 02Searching for current facts or news
  3. 03Retrieving readable content from a URL

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/marcfargas/skills --skill web-search

After installing, type/web-searchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
content.js
package-lock.json
package.json
search.js

Details

From the project README

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)

Comments

Markdown supported