Web Search Skill

Search the web. Prefer the built-in WebSearch tool — it uses a real browser engine with high success rate. Fall back to curl only if WebSearch is unavailable.

DuckDuckGo Instant Answer API (No API key needed)

# Basic search — returns instant answers
curl -s "https://api.duckduckgo.com/?q=QUERY&format=json&no_html=1" | jq '.Abstract, .RelatedTopics[:5]'

DuckDuckGo HTML Search (Full results)

# Get search results page and extract links
curl -s "https://html.duckduckgo.com/html/?q=QUERY" | grep -o 'href="https\{0,1\}://[^"]*' | head -10

Google Search via SerpAPI (if API key available)

# Check if SERPAPI_KEY is set
alma config get serpapi.apiKey

# If available:
curl -s "https://serpapi.com/search.json?q=QUERY&api_key=API_KEY" | jq '.organic_results[:5] | .[] | {title, link, snippet}'

Fetching Page Content

After finding URLs from search, use the WebFetch tool to get the actual page content:

WebFetch(url="https://example.com/article")

Or via curl:

curl -sL "https://example.com/article" | head -200

Tips

• URL-encode the query: replace spaces with + or %20
• Use jq to parse JSON responses
• For complex queries, try multiple search approaches
• Always summarize findings for the user rather than dumping raw results
• If DuckDuckGo doesn't have good results, try fetching specific known sources directly

Examples

"最近的 AI 新闻":

curl -s "https://html.duckduckgo.com/html/?q=latest+AI+news+2026" | grep -o 'href="https\{0,1\}://[^"]*' | grep -v duckduckgo | head -5

"Python 3.13 新特性":

curl -s "https://api.duckduckgo.com/?q=python+3.13+new+features&format=json&no_html=1" | jq '.Abstract'