web-search-pro

⚠Review·Scanned 2/19/2026

Provides a multi-engine CLI web search and content extractor for AI agents. It reads API keys (TAVILY_API_KEY, EXA_API_KEY, SERPER_API_KEY, SERPAPI_API_KEY), instructs running node {baseDir}/scripts/search.mjs, and calls external endpoints such as https://api.tavily.com/search and https://api.exa.ai/search.

from clawhub.ai·v57af8e9·24.4 KB·0 installs

Scanned from 1.0.0 at 57af8e9 · Transparency log ↗

$ vett add clawhub.ai/zjianru/web-search-proReview findings below

Web Search Pro

Multi-engine web search with full parameter control for AI agents. A precision supplement to OpenClaw's built-in web_search (Brave/Perplexity), providing domain filtering, deep search, news mode, date ranges, and content extraction that the built-in search does not support.

多引擎精细化网络搜索，为 AI Agent 设计。作为 OpenClaw 内置 web_search（Brave/Perplexity）的精细化补充，提供域名过滤、深度搜索、新闻模式、日期范围、内容提取等内置搜索不支持的能力。配置一个或多个 API Key，自动选择最优引擎。

Engines / 引擎

Engine	Strengths	Free Tier	API Key Env
Tavily	AI-optimized, best answer quality, full filters, extract	1000/month	`TAVILY_API_KEY`
Exa	Semantic/neural search, deep research	$10 credit	`EXA_API_KEY`
Serper	Real Google SERP, best news coverage	100/month	`SERPER_API_KEY`
SerpAPI	Multi-engine (Google/Bing/Baidu/Yandex/DuckDuckGo)	250/month	`SERPAPI_API_KEY`

Auto-Select Priority / 自动选择优先级

When --engine is not specified, the skill picks the best available engine:

Query Type	Priority	Reason
Default	Tavily > Exa > Serper > SerpAPI	Tavily has best AI answer + full filters
`--deep`	Tavily > Exa	Both have dedicated deep search modes
`--news`	Serper > Tavily	Google News has widest coverage
`--include-domains`	Tavily > Exa > Serper > SerpAPI	Tavily/Exa have native domain filters
`--search-engine baidu`	SerpAPI	Only SerpAPI supports Baidu/Yandex
Chinese queries	SerpAPI (Baidu) > Serper	Baidu has better Chinese results

Search / 搜索

# Basic search (auto-select engine)
node {baseDir}/scripts/search.mjs "query"

# Force specific engine
node {baseDir}/scripts/search.mjs "query" --engine tavily

# Domain filtering (only search specific sites)
node {baseDir}/scripts/search.mjs "query" --include-domains "github.com,stackoverflow.com"

# Exclude domains
node {baseDir}/scripts/search.mjs "query" --exclude-domains "pinterest.com,quora.com"

# Date range (absolute)
node {baseDir}/scripts/search.mjs "query" --from 2026-01-01 --to 2026-02-09

# Time range (relative)
node {baseDir}/scripts/search.mjs "query" --time-range week

# Deep/advanced search
node {baseDir}/scripts/search.mjs "query" --deep

# News search
node {baseDir}/scripts/search.mjs "query" --news --days 7

# Multi-engine: Baidu search
node {baseDir}/scripts/search.mjs "query" --engine serpapi --search-engine baidu

# More results
node {baseDir}/scripts/search.mjs "query" -n 10

# JSON output (for programmatic use)
node {baseDir}/scripts/search.mjs "query" --json

Extract / 内容提取

Extract readable content from URLs (Tavily Extract or Exa livecrawl):

node {baseDir}/scripts/extract.mjs "https://example.com/article"
node {baseDir}/scripts/extract.mjs "url1" "url2" "url3"
node {baseDir}/scripts/extract.mjs "url" --engine exa
node {baseDir}/scripts/extract.mjs "url" --json

All Options / 全部参数

Option	Description	Engines
`--engine <name>`	Force engine: tavily\|exa\|serper\|serpapi	all
`-n <count>`	Number of results (default: 5)	all
`--deep`	Deep/advanced search mode	tavily, exa
`--news`	News search mode	tavily, serper, serpapi
`--days <n>`	Limit news to last N days	tavily
`--include-domains <d,...>`	Only search these domains	all (native: tavily, exa)
`--exclude-domains <d,...>`	Exclude these domains	all (native: tavily, exa)
`--time-range <range>`	day\|week\|month\|year	all
`--from <YYYY-MM-DD>`	Results after this date	all
`--to <YYYY-MM-DD>`	Results before this date	all
`--search-engine <name>`	SerpAPI sub-engine: google\|bing\|baidu\|yandex\|duckduckgo	serpapi
`--country <code>`	Country code (us, cn, de...)	serper, serpapi
`--lang <code>`	Language code (en, zh, de...)	serper, serpapi
`--json`	Raw JSON output	all

Setup / 配置

Add API keys to your environment (e.g., ~/.openclaw/.env):

# Configure at least one (recommended: Tavily)
TAVILY_API_KEY=tvly-xxxxx        # https://tavily.com (1000 free/month)
EXA_API_KEY=exa-xxxxx            # https://exa.ai ($10 free credit)
SERPER_API_KEY=xxxxx             # https://serper.dev (100 free/month)
SERPAPI_API_KEY=xxxxx            # https://serpapi.com (250 free/month)

Notes / 说明

At least one API key must be configured
Domain filtering via --include-domains/--exclude-domains works natively on Tavily and Exa; on Serper/SerpAPI it's implemented via site: query operators
--deep mode uses more API credits (Tavily: 2x, Exa: varies)
Extract only works with Tavily and Exa
All output is Markdown-formatted for AI agent consumption; use --json for programmatic access