Web Search Skill#

Comprehensive web search and content extraction — free, no API keys required.

Quick Start#

Just want to search? Use DuckDuckGo Lite:

text

web_fetch url="https://lite.duckduckgo.com/lite/?q=YOUR+QUERY"

Want full page content? Use Jina Reader:

text

web_fetch url="https://r.jina.ai/http://TARGET_URL"

---

Method 1: Jina AI Reader (Free - Recommended for Content)#

Extract full page content using Jina's free reader API.

Read a URL#

text

web_fetch url="https://r.jina.ai/http://example.com"

Search the Web#

text

web_fetch url="https://r.jina.ai/http://duckduckgo.com/?q=YOUR+QUERY"

Examples:

TaskCommandGet Next.js docsweb_fetch url="https://r.jina.ai/http://nextjs.org"Get React docsweb_fetch url="https://r.jina.ai/http://react.dev"Get Python docsweb_fetch url="https://r.jina.ai/http://docs.python.org"

Advanced Jina Reader (with API Key)#

For advanced features, get a free API key from jina.ai/reader:

bash

export JINA_API_KEY="jina_..."

Then use the bundled script:

text

{baseDir}/scripts/reader.sh "https://example.com"
{baseDir}/scripts/reader.sh --mode search "AI news 2025"
{baseDir}/scripts/reader.sh --mode ground "OpenAI founded 2015"

Options: --mode, --selector, --remove, --format, --json

---

Method 2: DuckDuckGo Lite (Free - Recommended for Search)#

Search without any API key using DuckDuckGo Lite.

Basic Search#

text

web_fetch url="https://lite.duckduckgo.com/lite/?q=YOUR+QUERY"

Regional Search#

text

web_fetch url="https://lite.duckduckgo.com/lite/?q=QUERY&kl=us-en"

Regions: au-en, us-en, uk-en, de-de, fr-fr

Search Tips#

• Use + for spaces: python+tutorial
• Use quotes for exact phrases: %22exact+phrase%22
• Skip first 1-2 results (ads)

---

Method 3: Python ddgs (Fallback)#

If web_fetch is blocked, use Python's ddgs package:

bash

pip install ddgs

python

from ddgs import DDGS
ddgs = DDGS()
results = ddgs.text("search query", max_results=5)
for r in results:
    print(f"{r['title']}: {r['url']}")

---

Workflow: Search then Fetch#

1. Search → DDG Lite to find relevant URLs
2. Pick → Identify best result(s)
3. Fetch → Jina Reader to extract full content

Example:

text

# Step 1: Find info about Next.js auth
web_fetch url="https://lite.duckduckgo.com/lite/?q=nextjs+authentication+docs"

# Step 2: Fetch the official docs
web_fetch url="https://r.jina.ai/http://nextjs.org/docs/app/..."

---

Quick Reference#

NeedMethodCommandFind URLsDDG Lite?q=search+termsGet page contentJina Readerr.jina.ai/http://URLAdvanced extractionJina API--mode search --jsonPython fallbackddgsddgs.text()Browser (if available)Headlessbrowser action=navigate

---

Limitations#

• Google search blocked (captcha)
• No date filtering via DDG Lite
• Jina free tier has rate limits