web-search

Retrieve web search results via DuckDuckGo with a Brave fallback.

223|6|Updated May 25, 2018
One-click install
npx skills add https://github.com/megalithic/dotfiles --skill web-search-megalithic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-search
Source: https://github.com/megalithic/dotfiles/tree/main/home/programs/ai/pi-coding-agent/skills/web-search
Command: npx skills add https://github.com/megalithic/dotfiles --skill web-search-megalithic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables fast, automated web search results directly from the terminal, reducing context-switching and manual lookups.

Core Features & Use Cases

  • Primary search with DuckDuckGo via the ddgr CLI for quick results.
  • Brave content-extraction fallback for full-page data when needed.
  • Site-scoped and time-filtered queries to support focused research tasks.

Quick Start

Run {baseDir}/search.sh 'nix environment' to perform a basic search. To fetch more results, use -n with a higher value, e.g. {baseDir}/search.sh 'nix' -n 10.

Frequently Asked Questions about web-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform a quick web search from the command line?

You can perform a quick web search from the command line by running the search shell script with your query string. It uses DuckDuckGo via the ddgr CLI to return results directly in your terminal.

Can I limit my web search results to a specific website?

Yes, you can limit web search results to a specific website using the site-scoped query feature. This allows you to focus your research on a single domain.

What happens if DuckDuckGo search fails to return content?

If DuckDuckGo search fails to return content, the tool uses a Brave content-extraction fallback. This ensures you still get full-page data for your terminal lookup.

How do I fetch more web search results for a detailed query?

To fetch more web search results for a detailed query, run the search script with the -n flag followed by a number. For example, passing -n 10 retrieves ten results.

Do I need any external dependencies to use this command line search tool?

You need the ddgr CLI for primary DuckDuckGo searches, jq for formatting results, and node for content scripting. These enable the terminal-based search workflow.

Are there limitations to using time-filtered inquiries with DuckDuckGo?

Time-filtered inquiries rely on DuckDuckGo capabilities via the ddgr CLI. While suitable for focused research, granular historical data might require the Brave fallback for full-page content extraction.