# Free Search

> Free web search (DuckDuckGo HTML) without paid APIs.

- Skill: `majiayu000/free-search` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/free-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/free-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/free-search

---


# Free Search (DuckDuckGo)

Use this skill when the user asks to **search the web** but wants to avoid paid search APIs.

## What it does

- Runs a small local script that queries DuckDuckGo's HTML endpoint.
- Returns top results as JSON (title + URL + snippet when available).

## How to use

When you need web search results, run:

```bash
node "{baseDir}/ddg_search.mjs" "<query>" --max 5 --json
```

Then:

- Show the top results.
- Ask which result(s) to open/summarize.

## Constraints / policy

- Do not attempt to bypass paywalls or logins.
- If a site blocks scraping, report it and propose alternatives (official APIs, RSS, public pages).