{"id":"d10085ae-86bc-428f-9b17-e46ec35a176c","entityType":"agent","slug":"zjianru-web-search-pro","name":"web-search-pro","canonicalUrl":"https://www.xpersona.co/agent/zjianru-web-search-pro","canonicalPath":"/agent/zjianru-web-search-pro","generatedAt":"2026-10-09T22:28:08.221Z","source":"GITHUB_OPENCLEW","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"description":"Multi-engine web search with full parameter control. Supports Tavily, Exa, Serper, and SerpAPI with domain filtering, date ranges, deep search, news mode, and content extraction. Auto-selects the best engine based on query type and available API keys. 多引擎精细化搜索：支持域名过滤、日期范围、深度搜索、新闻模式、内容提取。 根据查询类型和可用 API Key 自动选择最优引擎。 --- name: web-search-pro description: | Multi-engine web search with full parameter control. Supports Tavily, Exa, Serper, and SerpAPI with domain filtering, date ranges, deep search, news mode, and content extraction. Auto-selects the best engine based on query type and available API keys. 多引擎精细化搜索：支持域名过滤、日期范围、深度搜索、新闻模式、内容提取。 根据查询类型和可用 API Key 自动选择最优引擎。 homepage: https://github.com/Zjianru/web-search-pro metadata: {","descriptionLabel":"Technical summary","evidenceSummary":"Published capability contract available. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"git clone https://github.com/Zjianru/web-search-pro.git","sourceUrl":"https://github.com/Zjianru/web-search-pro","homepage":"https://github.com/Zjianru/web-search-pro","primaryLinks":[{"label":"View Source","url":"https://github.com/Zjianru/web-search-pro","kind":"source"}],"safetyScore":89,"overallRank":35.9,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Multi-engine web search with full parameter control. Supports Tavily, Exa, Serper, and SerpAPI with domain filtering, date ranges, deep search, news mode, and c"},"coverage":{"evidence":{"source":"capability-contract + public-profile","verified":true,"confidence":"high","updatedAt":"2026-02-24T19:44:18.620Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"baidu","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":2,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"baidu","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:baidu|supported|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No source adoption metrics were available."},"stars":0,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-03-01T06:04:06.111Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-03-01T06:04:06.111Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-02T06:04:06.111Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"capability-contract","verified":true,"confidence":"high","updatedAt":"2026-02-24T19:44:18.620Z","emptyReason":null},"installCommand":"git clone https://github.com/Zjianru/web-search-pro.git","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"ready","authModes":["api_key"],"requires":["openclew","lang:typescript"],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":"https://github.com/Zjianru/web-search-pro#input","outputSchemaRef":"https://github.com/Zjianru/web-search-pro#output","dataRegion":"global","contractUpdatedAt":"2026-02-24T19:44:18.620Z","sourceUpdatedAt":"2026-02-24T19:44:18.620Z","freshnessSeconds":19622629},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/zjianru-web-search-pro/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/zjianru-web-search-pro/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/zjianru-web-search-pro/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/zjianru-web-search-pro/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/zjianru-web-search-pro/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/zjianru-web-search-pro/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_OPENCLEW","generatedAt":"2026-10-09T22:28:08.221Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/zjianru-web-search-pro/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/zjianru-web-search-pro/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/zjianru-web-search-pro/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/zjianru-web-search-pro/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":[],"safeUseWhen":["Contract is available with explicit auth and schema references.","Trust confidence is not low and verification freshness is acceptable."],"riskFlags":["trust_data_unavailable"],"operationalConfidence":"medium"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"readme":"---\nname: web-search-pro\ndescription: |\n  Multi-engine web search with full parameter control. Supports Tavily, Exa, Serper, and SerpAPI\n  with domain filtering, date ranges, deep search, news mode, and content extraction.\n  Auto-selects the best engine based on query type and available API keys.\n  多引擎精细化搜索：支持域名过滤、日期范围、深度搜索、新闻模式、内容提取。\n  根据查询类型和可用 API Key 自动选择最优引擎。\nhomepage: https://github.com/Zjianru/web-search-pro\nmetadata: {\"clawdbot\":{\"emoji\":\"🔎\",\"requires\":{\"bins\":[\"node\"],\"env_any\":[\"TAVILY_API_KEY\",\"EXA_API_KEY\",\"SERPER_API_KEY\",\"SERPAPI_API_KEY\"]}}}\n---\n\n# Web Search Pro\n\nMulti-engine web search with full parameter control for AI agents.\nA precision supplement to OpenClaw's built-in `web_search` (Brave/Perplexity), providing\ndomain filtering, deep search, news mode, date ranges, and content extraction\nthat the built-in search does not support.\n\n多引擎精细化网络搜索，为 AI Agent 设计。\n作为 OpenClaw 内置 `web_search`（Brave/Perplexity）的精细化补充，提供域名过滤、\n深度搜索、新闻模式、日期范围、内容提取等内置搜索不支持的能力。\n配置一个或多个 API Key，自动选择最优引擎。\n\n## Engines / 引擎\n\n| Engine | Strengths | Free Tier | API Key Env |\n|--------|-----------|-----------|-------------|\n| **Tavily** | AI-optimized, best answer quality, full filters, extract | 1000/month | `TAVILY_API_KEY` |\n| **Exa** | Semantic/neural search, deep research | $10 credit | `EXA_API_KEY` |\n| **Serper** | Real Google SERP, best news coverage | 100/month | `SERPER_API_KEY` |\n| **SerpAPI** | Multi-engine (Google/Bing/Baidu/Yandex/DuckDuckGo) | 250/month | `SERPAPI_API_KEY` |\n\n## Auto-Select Priority / 自动选择优先级\n\nWhen `--engine` is not specified, the skill picks the best available engine:\n\n| Query Type | Priority | Reason |\n|------------|----------|--------|\n| Default | Tavily > Exa > Serper > SerpAPI | Tavily has best AI answer + full filters |\n| `--deep` | Tavily > Exa | Both have dedicated deep search modes |\n| `--news` | Serper > Tavily | Google News has widest coverage |\n| `--include-domains` | Tavily > Exa > Serper > SerpAPI | Tavily/Exa have native domain filters |\n| `--search-engine baidu` | SerpAPI | Only SerpAPI supports Baidu/Yandex |\n| Chinese queries | SerpAPI (Baidu) > Serper | Baidu has better Chinese results |\n\n## Search / 搜索\n\n```bash\n# Basic search (auto-select engine)\nnode {baseDir}/scripts/search.mjs \"query\"\n\n# Force specific engine\nnode {baseDir}/scripts/search.mjs \"query\" --engine tavily\n\n# Domain filtering (only search specific sites)\nnode {baseDir}/scripts/search.mjs \"query\" --include-domains \"github.com,stackoverflow.com\"\n\n# Exclude domains\nnode {baseDir}/scripts/search.mjs \"query\" --exclude-domains \"pinterest.com,quora.com\"\n\n# Date range (absolute)\nnode {baseDir}/scripts/search.mjs \"query\" --from 2026-01-01 --to 2026-02-09\n\n# Time range (relative)\nnode {baseDir}/scripts/search.mjs \"query\" --time-range week\n\n# Deep/advanced search\nnode {baseDir}/scripts/search.mjs \"query\" --deep\n\n# News search\nnode {baseDir}/scripts/search.mjs \"query\" --news --days 7\n\n# Multi-engine: Baidu search\nnode {baseDir}/scripts/search.mjs \"query\" --engine serpapi --search-engine baidu\n\n# More results\nnode {baseDir}/scripts/search.mjs \"query\" -n 10\n\n# JSON output (for programmatic use)\nnode {baseDir}/scripts/search.mjs \"query\" --json\n```\n\n## Extract / 内容提取\n\nExtract readable content from URLs (Tavily Extract or Exa livecrawl):\n\n```bash\nnode {baseDir}/scripts/extract.mjs \"https://example.com/article\"\nnode {baseDir}/scripts/extract.mjs \"url1\" \"url2\" \"url3\"\nnode {baseDir}/scripts/extract.mjs \"url\" --engine exa\nnode {baseDir}/scripts/extract.mjs \"url\" --json\n```\n\n## All Options / 全部参数\n\n| Option | Description | Engines |\n|--------|-------------|---------|\n| `--engine <name>` | Force engine: tavily\\|exa\\|serper\\|serpapi | all |\n| `-n <count>` | Number of results (default: 5) | all |\n| `--deep` | Deep/advanced search mode | tavily, exa |\n| `--news` | News search mode | tavily, serper, serpapi |\n| `--days <n>` | Limit news to last N days | tavily |\n| `--include-domains <d,...>` | Only search these domains | all (native: tavily, exa) |\n| `--exclude-domains <d,...>` | Exclude these domains | all (native: tavily, exa) |\n| `--time-range <range>` | day\\|week\\|month\\|year | all |\n| `--from <YYYY-MM-DD>` | Results after this date | all |\n| `--to <YYYY-MM-DD>` | Results before this date | all |\n| `--search-engine <name>` | SerpAPI sub-engine: google\\|bing\\|baidu\\|yandex\\|duckduckgo | serpapi |\n| `--country <code>` | Country code (us, cn, de...) | serper, serpapi |\n| `--lang <code>` | Language code (en, zh, de...) | serper, serpapi |\n| `--json` | Raw JSON output | all |\n\n## Setup / 配置\n\nAdd API keys to your environment (e.g., `~/.openclaw/.env`):\n\n```bash\n# Configure at least one (recommended: Tavily)\nTAVILY_API_KEY=tvly-xxxxx        # https://tavily.com (1000 free/month)\nEXA_API_KEY=exa-xxxxx            # https://exa.ai ($10 free credit)\nSERPER_API_KEY=xxxxx             # https://serper.dev (100 free/month)\nSERPAPI_API_KEY=xxxxx            # https://serpapi.com (250 free/month)\n```\n\n## Notes / 说明\n\n- At least one API key must be configured\n- Domain filtering via `--include-domains`/`--exclude-domains` works natively on Tavily and Exa; on Serper/SerpAPI it's implemented via `site:` query operators\n- `--deep` mode uses more API credits (Tavily: 2x, Exa: varies)\n- Extract only works with Tavily and Exa\n- All output is Markdown-formatted for AI agent consumption; use `--json` for programmatic access\n","readmeExcerpt":"--- name: web-search-pro description: | Multi-engine web search with full parameter control. Supports Tavily, Exa, Serper, and SerpAPI with domain filtering, date ranges, deep search, news mode, and content extraction. Auto-selects the best engine based on query type and available API keys. 多引擎精细化搜索：支持域名过滤、日期范围、深度搜索、新闻模式、内容提取。 根据查询类型和可用 API Key 自动选择最优引擎。 homepage: https://github.com/Zjianru/web-search-pro metadata: {","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Basic search (auto-select engine)\nnode {baseDir}/scripts/search.mjs \"query\"\n\n# Force specific engine\nnode {baseDir}/scripts/search.mjs \"query\" --engine tavily\n\n# Domain filtering (only search specific sites)\nnode {baseDir}/scripts/search.mjs \"query\" --include-domains \"github.com,stackoverflow.com\"\n\n# Exclude domains\nnode {baseDir}/scripts/search.mjs \"query\" --exclude-domains \"pinterest.com,quora.com\"\n\n# Date range (absolute)\nnode {baseDir}/scripts/search.mjs \"query\" --from 2026-01-01 --to 2026-02-09\n\n# Time range (relative)\nnode {baseDir}/scripts/search.mjs \"query\" --time-range week\n\n# Deep/advanced search\nnode {baseDir}/scripts/search.mjs \"query\" --deep\n\n# News search\nnode {baseDir}/scripts/search.mjs \"query\" --news --days 7\n\n# Multi-engine: Baidu search\nnode {baseDir}/scripts/search.mjs \"query\" --engine serpapi --search-engine baidu\n\n# More results\nnode {baseDir}/scripts/search.mjs \"query\" -n 10\n\n# JSON output (for programmatic use)\nnode {baseDir}/scripts/search.mjs \"query\" --json"},{"language":"bash","snippet":"node {baseDir}/scripts/extract.mjs \"https://example.com/article\"\nnode {baseDir}/scripts/extract.mjs \"url1\" \"url2\" \"url3\"\nnode {baseDir}/scripts/extract.mjs \"url\" --engine exa\nnode {baseDir}/scripts/extract.mjs \"url\" --json"},{"language":"bash","snippet":"# Configure at least one (recommended: Tavily)\nTAVILY_API_KEY=tvly-xxxxx        # https://tavily.com (1000 free/month)\nEXA_API_KEY=exa-xxxxx            # https://exa.ai ($10 free credit)\nSERPER_API_KEY=xxxxx             # https://serper.dev (100 free/month)\nSERPAPI_API_KEY=xxxxx            # https://serpapi.com (250 free/month)"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"Multi-engine web search with full parameter control. Supports Tavily, Exa, Serper, and SerpAPI with domain filtering, date ranges, deep search, news mode, and content extraction. Auto-selects the best engine based on query type and available API keys. 多引擎精细化搜索：支持域名过滤、日期范围、深度搜索、新闻模式、内容提取。 根据查询类型和可用 API Key 自动选择最优引擎。 --- name: web-search-pro description: | Multi-engine web search with full parameter control. Supports Tavily, Exa, Serper, and SerpAPI with domain filtering, date ranges, deep search, news mode, and content extraction. Auto-selects the best engine based on query type and available API keys. 多引擎精细化搜索：支持域名过滤、日期范围、深度搜索、新闻模式、内容提取。 根据查询类型和可用 API Key 自动选择最优引擎。 homepage: https://github.com/Zjianru/web-search-pro metadata: {","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":406,"uniquenessScore":61,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T22:28:08.221Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_openclew","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}