web-search-plus-plugin 1.2.1 → 1.2.3

package/.env.template

@@ -4,6 +4,9 @@ SERPER_API_KEY=your-serper-key-here
 # Tavily (Research Search) — https://tavily.com
 TAVILY_API_KEY=your-tavily-key-here
 
+# Querit (Multilingual AI Search) — https://querit.ai
+QUERIT_API_KEY=your-querit-api-key-here
+
 # Exa (Neural/Deep Search) — https://exa.ai
 EXA_API_KEY=your-exa-key-here
 

package/README.md

@@ -7,7 +7,7 @@ A standalone OpenClaw plugin that registers `web_search_plus` as a first-class t
 ## ✨ Features
 
 - **Intelligent auto-routing** — analyzes query intent and picks the best provider automatically
-- **6 search providers** — use one or all, graceful fallback if any is down
+- **7 search providers** — use one or all, graceful fallback if any is down
 - **Local result caching** — saves API costs on repeated queries
 - **Interactive setup wizard** — guided configuration via `python3 scripts/setup.py`
 - **Native OpenClaw tool** — registers as `web_search_plus`, not a skill
@@ -18,6 +18,7 @@ A standalone OpenClaw plugin that registers `web_search_plus` as a first-class t
 |----------|----------|-----------|
 | **Serper** (Google) | Facts, news, shopping, local businesses | 2,500 queries/month |
 | **Tavily** | Deep research, analysis, explanations | 1,000 queries/month |
+| **Querit** | Multi-lingual AI search with rich metadata and real-time info | 1,000 queries/month |
 | **Exa** (Neural) | Semantic discovery, finding similar content | 1,000 queries/month |
 | **Perplexity** | AI-synthesized answers with citations | Via API key |
 | **You.com** | Real-time RAG, LLM-ready snippets | Limited free tier |
@@ -31,6 +32,7 @@ The plugin analyzes your query and picks the best provider:
 |-------|-----------|-----|
 | "iPhone 16 Pro price" | Serper | Shopping intent detected |
 | "how does TCP/IP work" | Tavily | Research/explanation intent |
+| "latest multilingual EV market updates" | Querit | Real-time AI search with metadata-rich results |
 | "companies like Stripe" | Exa | Discovery/semantic intent |
 | "what is quantum computing" | Perplexity | Direct answer intent |
 | "latest news AI regulation" | Serper | News intent |
@@ -87,6 +89,7 @@ Copy `.env.template` to `.env` and add at least one API key:
 |----------|----------|---------|
 | `SERPER_API_KEY` | Serper (Google) | [console.serper.dev](https://console.serper.dev) |
 | `TAVILY_API_KEY` | Tavily | [tavily.com](https://tavily.com) |
+| `QUERIT_API_KEY` | Querit | [querit.ai](https://querit.ai) |
 | `EXA_API_KEY` | Exa | [exa.ai](https://exa.ai) |
 | `PERPLEXITY_API_KEY` | Perplexity | [perplexity.ai](https://docs.perplexity.ai) |
 | `KILOCODE_API_KEY` | Perplexity via Kilo | [kilocode.ai](https://kilocode.ai) |
@@ -119,7 +122,7 @@ The registered `web_search_plus` tool accepts:
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `query` | string | ✅ | Search query |
-| `provider` | string | ❌ | Force a provider: `serper`, `tavily`, `exa`, `perplexity`, `you`, `searxng`, or `auto` (default) |
+| `provider` | string | ❌ | Force a provider: `serper`, `tavily`, `querit`, `exa`, `perplexity`, `you`, `searxng`, or `auto` (default) |
 | `count` | number | ❌ | Number of results (default: 5) |
 
 ## 🧪 Test Directly
@@ -139,7 +142,7 @@ python3 scripts/search.py -q "your query" --max-results 10
 
 ## ❓ FAQ
 
-### Do I need all 6 providers?
+### Do I need all 7 providers?
 No. The plugin works with just one API key. Configure whichever providers you have — the auto-router will use what's available and skip what's not.
 
 ### What's the difference between this plugin and the `web-search-plus` skill?
@@ -149,7 +152,7 @@ The **plugin** registers a native tool that any agent can use directly. The **sk
 Yes, Python 3 is required. The search logic runs as a Python script. Most Linux servers and macOS have Python 3 pre-installed.
 
 ### How does auto-routing work?
-The router scores each provider based on query signals — keywords like "price" or "buy" boost Serper, research-oriented queries boost Tavily, semantic/discovery queries boost Exa, and direct questions boost Perplexity. The highest-scoring provider wins.
+The router scores each provider based on query signals — keywords like "price" or "buy" boost Serper, deep explanation queries boost Tavily, multilingual or metadata-rich real-time search can favor Querit, semantic/discovery queries boost Exa, and direct questions boost Perplexity. The highest-scoring provider wins.
 
 ### Does it cache results?
 Yes. Results are cached locally in a `.cache/` directory inside the plugin folder. Identical queries return cached results instantly and don't consume API credits. Cache is file-based and survives restarts.

package/index.ts

@@ -41,6 +41,7 @@ export default function (api: any) {
   const configKeyMap: Record<string, string> = {
     serperApiKey: "SERPER_API_KEY",
     tavilyApiKey: "TAVILY_API_KEY",
+    queritApiKey: "QUERIT_API_KEY",
     exaApiKey: "EXA_API_KEY",
     perplexityApiKey: "PERPLEXITY_API_KEY",
     kilocodeApiKey: "KILOCODE_API_KEY",
@@ -56,7 +57,7 @@ export default function (api: any) {
     {
       name: "web_search_plus",
       description:
-        "Search the web using multi-provider intelligent routing (Serper/Google, Tavily/Research, Exa/Neural+Deep, Perplexity, You.com, SearXNG). Automatically selects the best provider based on query intent. Use for ALL web searches. Set depth='deep' for multi-source synthesis, 'deep-reasoning' for complex cross-document analysis.",
+        "Search the web using multi-provider intelligent routing (Serper/Google, Tavily/Research, Querit/Multilingual AI Search, Exa/Neural+Deep, Perplexity, You.com, SearXNG). Automatically selects the best provider based on query intent. Use for ALL web searches. Set depth='deep' for multi-source synthesis, 'deep-reasoning' for complex cross-document analysis.",
       parameters: Type.Object({
         query: Type.String({ description: "Search query" }),
         provider: Type.Optional(
@@ -64,6 +65,7 @@ export default function (api: any) {
             [
               Type.Literal("serper"),
               Type.Literal("tavily"),
+              Type.Literal("querit"),
               Type.Literal("exa"),
               Type.Literal("perplexity"),
               Type.Literal("you"),
@@ -88,10 +90,36 @@ export default function (api: any) {
             ],
             {
               description:
-                "Exa search depth: 'deep' synthesizes across sources (4-12s), 'deep-reasoning' for complex cross-reference analysis (12-50s). Only applies when routed to Exa.",
+                "Exa search depth: 'deep' synthesizes across sources (4-12s), 'deep-reasoning' for complex cross-reference analysis (12-50s). When provider is auto, depth may be auto-selected based on query complexity.",
             },
           ),
         ),
+        time_range: Type.Optional(
+          Type.Union(
+            [
+              Type.Literal("day"),
+              Type.Literal("week"),
+              Type.Literal("month"),
+              Type.Literal("year"),
+            ],
+            {
+              description:
+                "Filter results by recency. Applies to Serper (as tbs), Perplexity (as search_recency_filter), Tavily/You.com (as freshness). Useful for news and current events.",
+            },
+          ),
+        ),
+        include_domains: Type.Optional(
+          Type.Array(Type.String(), {
+            description:
+              "Only include results from these domains (e.g. ['arxiv.org', 'github.com']). Supported by Tavily and Exa.",
+          }),
+        ),
+        exclude_domains: Type.Optional(
+          Type.Array(Type.String(), {
+            description:
+              "Exclude results from these domains (e.g. ['reddit.com', 'pinterest.com']). Supported by Tavily and Exa.",
+          }),
+        ),
       }),
       async execute(
         _id: string,
@@ -100,6 +128,9 @@ export default function (api: any) {
           provider?: string;
           count?: number;
           depth?: string;
+          time_range?: string;
+          include_domains?: string[];
+          exclude_domains?: string[];
         },
       ) {
         const args = [scriptPath, "--query", params.query, "--compact"];
@@ -119,6 +150,19 @@ export default function (api: any) {
           args.push("--exa-depth", params.depth);
         }
 
+        if (params.time_range) {
+          args.push("--time-range", params.time_range);
+          args.push("--freshness", params.time_range);
+        }
+
+        if (params.include_domains?.length) {
+          args.push("--include-domains", ...params.include_domains);
+        }
+
+        if (params.exclude_domains?.length) {
+          args.push("--exclude-domains", ...params.exclude_domains);
+        }
+
         const envPaths = [
           path.join(PLUGIN_DIR, ".env"),
           path.join(PLUGIN_DIR, "..", "web-search-plus", ".env"),
@@ -131,7 +175,7 @@ export default function (api: any) {
 
         try {
           const child = spawnSync("python3", args, {
-            timeout: 65000,
+            timeout: 75000,
             env: childEnv,
             shell: false,
             encoding: "utf8",

package/openclaw.plugin.json

@@ -2,14 +2,15 @@
   "id": "web-search-plus-plugin",
   "kind": "skill",
   "name": "Web Search Plus",
-  "version": "1.2.1",
-  "description": "Multi-provider web search (Serper/Google, Tavily, Exa/Neural+Deep, Perplexity, You.com, SearXNG) with intelligent auto-routing",
+  "version": "1.2.3",
+  "description": "Multi-provider web search (Serper/Google, Tavily, Querit/Multilingual AI Search, Exa/Neural+Deep, Perplexity, You.com, SearXNG) with intelligent auto-routing",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
       "serperApiKey": { "type": "string" },
       "tavilyApiKey": { "type": "string" },
+      "queritApiKey": { "type": "string" },
       "exaApiKey": { "type": "string" },
       "perplexityApiKey": { "type": "string" },
       "kilocodeApiKey": { "type": "string" },
@@ -20,6 +21,7 @@
   "uiHints": {
     "serperApiKey": { "label": "Serper API Key", "placeholder": "sk-...", "sensitive": true },
     "tavilyApiKey": { "label": "Tavily API Key", "placeholder": "tvly-...", "sensitive": true },
+    "queritApiKey": { "label": "Querit API Key", "placeholder": "querit-sk-...", "sensitive": true },
     "exaApiKey": { "label": "Exa API Key", "placeholder": "exa-...", "sensitive": true },
     "perplexityApiKey": { "label": "Perplexity API Key", "placeholder": "pplx-...", "sensitive": true },
     "kilocodeApiKey": { "label": "Kilo Gateway API Key", "placeholder": "...", "sensitive": true },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "web-search-plus-plugin",
-  "version": "1.2.1",
-  "description": "OpenClaw plugin: multi-provider web search (Serper/Google, Tavily, Exa/Neural+Deep, Perplexity, You.com, SearXNG) with intelligent auto-routing",
+  "version": "1.2.3",
+  "description": "OpenClaw plugin: multi-provider web search (Serper/Google, Tavily, Querit/Multilingual AI Search, Exa/Neural+Deep, Perplexity, You.com, SearXNG) with intelligent auto-routing",
   "type": "module",
   "main": "index.ts",
   "files": [
@@ -12,7 +12,7 @@
     "README.md",
     "LICENSE"
   ],
-  "keywords": ["openclaw", "plugin", "search", "serper", "tavily", "exa", "exa-deep", "perplexity", "you", "searxng", "web-search", "auto-routing"],
+  "keywords": ["openclaw", "plugin", "search", "serper", "tavily", "querit", "exa", "exa-deep", "perplexity", "you", "searxng", "web-search", "auto-routing"],
   "repository": {
     "type": "git",
     "url": "https://github.com/robbyczgw-cla/web-search-plus-plugin"

package/scripts/search.py

@@ -1,7 +1,8 @@
 #!/usr/bin/env python3
 """
 Web Search Plus — Unified Multi-Provider Search with Intelligent Auto-Routing
-Supports: Serper (Google), Tavily (Research), Exa (Neural), Perplexity (Direct Answers)
+Supports: Serper (Google), Tavily (Research), Querit (Multilingual AI Search),
+Exa (Neural), Perplexity (Direct Answers)
 
 Smart Routing uses multi-signal analysis:
   - Query intent classification (shopping, research, discovery)
@@ -12,7 +13,7 @@ Smart Routing uses multi-signal analysis:
 
 Usage:
     python3 search.py --query "..."                    # Auto-route based on query
-    python3 search.py --provider [serper|tavily|exa] --query "..." [options]
+    python3 search.py --provider [serper|tavily|querit|exa] --query "..." [options]
 
 Examples:
     python3 search.py -q "iPhone 16 Pro price"              # → Serper (shopping intent)
@@ -21,6 +22,7 @@ Examples:
 """
 
 import argparse
+from http.client import IncompleteRead
 import hashlib
 import json
 import os
@@ -275,7 +277,7 @@ DEFAULT_CONFIG = {
     "auto_routing": {
         "enabled": True,
         "fallback_provider": "serper",
-        "provider_priority": ["tavily", "exa", "perplexity", "serper", "you", "searxng"],
+        "provider_priority": ["tavily", "querit", "exa", "perplexity", "serper", "you", "searxng"],
         "disabled_providers": [],
         "confidence_threshold": 0.3,  # Below this, note low confidence
     },
@@ -288,6 +290,11 @@ DEFAULT_CONFIG = {
         "depth": "basic",
         "topic": "general"
     },
+    "querit": {
+        "base_url": "https://api.querit.ai",
+        "base_path": "/v1/search",
+        "timeout": 10
+    },
     "exa": {
         "type": "neural",
         "depth": "normal",
@@ -358,6 +365,7 @@ def get_api_key(provider: str, config: Dict[str, Any] = None) -> Optional[str]:
     key_map = {
         "serper": "SERPER_API_KEY",
         "tavily": "TAVILY_API_KEY",
+        "querit": "QUERIT_API_KEY",
         "exa": "EXA_API_KEY",
         "you": "YOU_API_KEY",
     }
@@ -459,24 +467,23 @@ def validate_api_key(provider: str, config: Dict[str, Any] = None) -> str:
                 ],
                 "provider": provider
             }
-            print(json.dumps(error_msg, indent=2), file=sys.stderr)
-            sys.exit(1)
-        
+            raise ProviderConfigError(json.dumps(error_msg))
+
         # Validate URL format
         if not key.startswith(("http://", "https://")):
-            print(json.dumps({
+            raise ProviderConfigError(json.dumps({
                 "error": "SearXNG instance URL must start with http:// or https://",
                 "provided": key,
                 "provider": provider
-            }, indent=2), file=sys.stderr)
-            sys.exit(1)
+            }))
         
         return key
     
     if not key:
         env_var = {
             "serper": "SERPER_API_KEY",
-            "tavily": "TAVILY_API_KEY", 
+            "tavily": "TAVILY_API_KEY",
+            "querit": "QUERIT_API_KEY",
             "exa": "EXA_API_KEY",
             "you": "YOU_API_KEY",
             "perplexity": "KILOCODE_API_KEY"
@@ -485,6 +492,7 @@ def validate_api_key(provider: str, config: Dict[str, Any] = None) -> str:
         urls = {
             "serper": "https://serper.dev",
             "tavily": "https://tavily.com",
+            "querit": "https://querit.ai",
             "exa": "https://exa.ai",
             "you": "https://api.you.com",
             "perplexity": "https://api.kilo.ai"
@@ -500,16 +508,14 @@ def validate_api_key(provider: str, config: Dict[str, Any] = None) -> str:
             ],
             "provider": provider
         }
-        print(json.dumps(error_msg, indent=2), file=sys.stderr)
-        sys.exit(1)
-    
+        raise ProviderConfigError(json.dumps(error_msg))
+
     if len(key) < 10:
-        print(json.dumps({
+        raise ProviderConfigError(json.dumps({
             "error": f"API key for {provider} appears invalid (too short)",
             "provider": provider
-        }, indent=2), file=sys.stderr)
-        sys.exit(1)
-    
+        }))
+
     return key
 
 
@@ -1165,6 +1171,7 @@ class QueryAnalyzer:
         provider_scores = {
             "serper": shopping_score + local_news_score + (recency_score * 0.35),
             "tavily": research_score + (complexity["complexity_score"] if not complexity["is_complex"] else 0) + (0.2 * recency_score),
+            "querit": (research_score * 0.65) + (rag_score * 0.35) + (recency_score * 0.45),
             "exa": discovery_score + (1.0 if re.search(r"\b(similar|alternatives?|examples?)\b", query, re.IGNORECASE) else 0.0) + (exa_deep_score * 0.5) + (exa_deep_reasoning_score * 0.5),
             "perplexity": direct_answer_score + (local_news_score * 0.4) + (recency_score * 0.55),
             "you": rag_score + (recency_score * 0.25),  # You.com good for real-time + RAG
@@ -1175,6 +1182,7 @@ class QueryAnalyzer:
         provider_matches = {
             "serper": shopping_matches + local_news_matches,
             "tavily": research_matches,
+            "querit": research_matches,
             "exa": discovery_matches + exa_deep_matches + exa_deep_reasoning_matches,
             "perplexity": direct_answer_matches,
             "you": rag_matches,
@@ -1225,7 +1233,7 @@ class QueryAnalyzer:
         total_score = sum(available.values()) or 1.0
         
         # Handle ties using priority
-        priority = self.auto_config.get("provider_priority", ["tavily", "exa", "perplexity", "serper", "you", "searxng"])
+        priority = self.auto_config.get("provider_priority", ["tavily", "querit", "exa", "perplexity", "serper", "you", "searxng"])
         winners = [p for p, s in available.items() if s == max_score]
         
         if len(winners) > 1:
@@ -1341,6 +1349,7 @@ def explain_routing(query: str, config: Dict[str, Any]) -> Dict[str, Any]:
         "intent_breakdown": {
             "shopping_signals": len(analysis["provider_matches"]["serper"]),
             "research_signals": len(analysis["provider_matches"]["tavily"]),
+            "querit_signals": len(analysis["provider_matches"]["querit"]),
             "discovery_signals": len(analysis["provider_matches"]["exa"]),
             "rag_signals": len(analysis["provider_matches"]["you"]),
             "exa_deep_score": round(analysis.get("exa_deep_score", 0), 2),
@@ -1362,7 +1371,7 @@ def explain_routing(query: str, config: Dict[str, Any]) -> Dict[str, Any]:
             if matches
         },
         "available_providers": [
-            p for p in ["serper", "tavily", "exa", "perplexity", "you", "searxng"]
+            p for p in ["serper", "tavily", "querit", "exa", "perplexity", "you", "searxng"]
             if get_api_key(p, config) and p not in config.get("auto_routing", {}).get("disabled_providers", [])
         ]
     }
@@ -1370,6 +1379,11 @@ def explain_routing(query: str, config: Dict[str, Any]) -> Dict[str, Any]:
 
 
 
+class ProviderConfigError(Exception):
+    """Raised when a provider is missing or has an invalid API key/config."""
+    pass
+
+
 class ProviderRequestError(Exception):
     """Structured provider error with retry/cooldown metadata."""
 
@@ -1437,6 +1451,24 @@ def reset_provider_health(provider: str) -> None:
         _save_provider_health(state)
 
 
+def _title_from_url(url: str) -> str:
+    """Derive a readable title from a URL when none is provided."""
+    try:
+        parsed = urlparse(url)
+        domain = parsed.netloc.replace("www.", "")
+        # Use last meaningful path segment as context
+        segments = [s for s in parsed.path.strip("/").split("/") if s]
+        if segments:
+            last = segments[-1].replace("-", " ").replace("_", " ")
+            # Strip file extensions
+            last = re.sub(r'\.\w{2,4}$', '', last)
+            if last:
+                return f"{domain} — {last[:80]}"
+        return domain
+    except Exception:
+        return url[:60]
+
+
 def normalize_result_url(url: str) -> str:
     if not url:
         return ""
@@ -1504,6 +1536,12 @@ def make_request(url: str, headers: dict, body: dict, timeout: int = 30) -> dict
         reason = str(getattr(e, "reason", e))
         is_timeout = "timed out" in reason.lower()
         raise ProviderRequestError(f"Network error: {reason}. Check your internet connection.", transient=is_timeout)
+    except IncompleteRead as e:
+        partial_len = len(getattr(e, "partial", b"") or b"")
+        raise ProviderRequestError(
+            f"Connection interrupted while reading response ({partial_len} bytes received). Please retry.",
+            transient=True,
+        )
     except TimeoutError:
         raise ProviderRequestError(f"Request timed out after {timeout}s. Try again or reduce max_results.", transient=True)
 
@@ -1653,6 +1691,114 @@ def search_tavily(
     }
 
 
+# =============================================================================
+# Querit (Multi-lingual search API for AI, with rich metadata and real-time information)
+# =============================================================================
+
+def _map_querit_time_range(time_range: Optional[str]) -> Optional[str]:
+    """Map generic time ranges to Querit's compact date filter format."""
+    if not time_range:
+        return None
+    return {
+        "day": "d1",
+        "week": "w1",
+        "month": "m1",
+        "year": "y1",
+    }.get(time_range, time_range)
+
+
+def search_querit(
+    query: str,
+    api_key: str,
+    max_results: int = 5,
+    language: str = "en",
+    country: str = "us",
+    time_range: Optional[str] = None,
+    include_domains: Optional[List[str]] = None,
+    exclude_domains: Optional[List[str]] = None,
+    base_url: str = "https://api.querit.ai",
+    base_path: str = "/v1/search",
+    timeout: int = 30,
+) -> dict:
+    """Search using Querit.
+
+    Mirrors the Querit Python SDK payload shape:
+      - query
+      - count
+      - optional filters: languages, geo, sites, timeRange
+    """
+    endpoint = base_url.rstrip("/") + base_path
+
+    filters: Dict[str, Any] = {}
+    if language:
+        filters["languages"] = {"include": [language.lower()]}
+    if country:
+        filters["geo"] = {"countries": {"include": [country.upper()]}}
+    if include_domains or exclude_domains:
+        sites: Dict[str, List[str]] = {}
+        if include_domains:
+            sites["include"] = include_domains
+        if exclude_domains:
+            sites["exclude"] = exclude_domains
+        filters["sites"] = sites
+
+    querit_time_range = _map_querit_time_range(time_range)
+    if querit_time_range:
+        filters["timeRange"] = {"date": querit_time_range}
+
+    body: Dict[str, Any] = {
+        "query": query,
+        "count": max_results,
+    }
+    if filters:
+        body["filters"] = filters
+
+    headers = {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json",
+    }
+
+    data = make_request(endpoint, headers, body, timeout=timeout)
+
+    error_code = data.get("error_code")
+    error_msg = data.get("error_msg")
+    if error_msg or (error_code not in (None, 0, 200)):
+        message = error_msg or f"Querit request failed with error_code={error_code}"
+        raise ProviderRequestError(message)
+
+    raw_results = ((data.get("results") or {}).get("result")) or []
+    results = []
+    for i, item in enumerate(raw_results[:max_results]):
+        snippet = item.get("snippet") or item.get("page_age") or ""
+        result = {
+            "title": item.get("title") or _title_from_url(item.get("url", "")),
+            "url": item.get("url", ""),
+            "snippet": snippet,
+            "score": round(1.0 - i * 0.05, 3),
+        }
+        if item.get("page_time") is not None:
+            result["page_time"] = item["page_time"]
+        if item.get("page_age"):
+            result["date"] = item["page_age"]
+        if item.get("language") is not None:
+            result["language"] = item["language"]
+        results.append(result)
+
+    answer = results[0]["snippet"] if results else ""
+
+    return {
+        "provider": "querit",
+        "query": query,
+        "results": results,
+        "images": [],
+        "answer": answer,
+        "metadata": {
+            "search_id": data.get("search_id"),
+            "time_range": querit_time_range,
+        }
+    }
+
+
 # =============================================================================
 # Exa (Neural/Semantic/Deep Search)
 # =============================================================================
@@ -1759,7 +1905,7 @@ def search_exa(
             results.append({
                 "title": f"Exa {exa_depth.replace('-', ' ').title()} Synthesis",
                 "url": "",
-                "snippet": synthesized_text[:2000],
+                "snippet": synthesized_text,
                 "full_synthesis": synthesized_text,
                 "score": 1.0,
                 "grounding": grounding_citations[:10],
@@ -1781,7 +1927,7 @@ def search_exa(
                 "type": "source",
             })
 
-        answer = synthesized_text[:1000] if synthesized_text else (results[1]["snippet"] if len(results) > 1 else "")
+        answer = synthesized_text if synthesized_text else (results[1]["snippet"] if len(results) > 1 else "")
 
         return {
             "provider": "exa",
@@ -1876,13 +2022,17 @@ def search_perplexity(
     message = choices[0].get("message", {}) if choices else {}
     answer = (message.get("content") or "").strip()
 
-    urls = re.findall(r"https?://[^\s)\]}>\"']+", answer)
-    unique_urls = []
-    seen = set()
-    for u in urls:
-        if u not in seen:
-            seen.add(u)
-            unique_urls.append(u)
+    # Prefer the structured citations array from Perplexity API response
+    api_citations = data.get("citations", [])
+
+    # Fallback: extract URLs from answer text if API doesn't provide citations
+    if not api_citations:
+        api_citations = []
+        seen = set()
+        for u in re.findall(r"https?://[^\s)\]}>\"']+", answer):
+            if u not in seen:
+                seen.add(u)
+                api_citations.append(u)
 
     results = []
 
@@ -1897,12 +2047,19 @@ def search_perplexity(
             "score": 1.0,
         })
 
-    # Additional results: extracted source URLs
-    for i, u in enumerate(unique_urls[:max_results - 1]):
+    # Source results from citations
+    for i, citation in enumerate(api_citations[:max_results - 1]):
+        # citations can be plain URL strings or dicts with url/title
+        if isinstance(citation, str):
+            url = citation
+            title = _title_from_url(url)
+        else:
+            url = citation.get("url", "")
+            title = citation.get("title") or _title_from_url(url)
         results.append({
-            "title": f"Source {i+1}",
-            "url": u,
-            "snippet": "Referenced source from Perplexity answer",
+            "title": title,
+            "url": url,
+            "snippet": f"Source cited in Perplexity answer [citation {i+1}]",
             "score": round(0.9 - i * 0.1, 3),
         })
 
@@ -2243,6 +2400,9 @@ Intelligent Auto-Routing:
   
   Research Intent → Tavily  
     "how does", "explain", "what is", analysis, pros/cons, tutorials
+
+  Multilingual + Real-Time AI Search → Querit
+    multilingual search, metadata-rich results, current information for AI workflows
   
   Discovery Intent → Exa (Neural)
     "similar to", "companies like", "alternatives", URLs, startups, papers
@@ -2263,7 +2423,7 @@ Full docs: See README.md and SKILL.md
     # Common arguments
     parser.add_argument(
         "--provider", "-p", 
-        choices=["serper", "tavily", "exa", "perplexity", "you", "searxng", "auto"],
+        choices=["serper", "tavily", "querit", "exa", "perplexity", "you", "searxng", "auto"],
         help="Search provider (auto=intelligent routing)"
     )
     parser.add_argument(
@@ -2323,6 +2483,19 @@ Full docs: See README.md and SKILL.md
     )
     parser.add_argument("--raw-content", action="store_true")
     
+    # Querit-specific
+    querit_config = config.get("querit", {})
+    parser.add_argument(
+        "--querit-base-url",
+        default=querit_config.get("base_url", "https://api.querit.ai"),
+        help="Querit API base URL"
+    )
+    parser.add_argument(
+        "--querit-base-path",
+        default=querit_config.get("base_path", "/v1/search"),
+        help="Querit API path"
+    )
+
     # Exa-specific
     exa_config = config.get("exa", {})
     parser.add_argument(
@@ -2490,13 +2663,15 @@ Full docs: See README.md and SKILL.md
     
     # Build provider fallback list
     auto_config = config.get("auto_routing", {})
-    provider_priority = auto_config.get("provider_priority", ["tavily", "exa", "perplexity", "serper"])
+    provider_priority = auto_config.get("provider_priority", ["tavily", "querit", "exa", "perplexity", "serper", "you", "searxng"])
     disabled_providers = auto_config.get("disabled_providers", [])
 
     # Start with the selected provider, then try others in priority order
+    # Only include providers that have a configured API key (except the primary,
+    # which gets a clear error if unconfigured and no fallback succeeds)
     providers_to_try = [provider]
     for p in provider_priority:
-        if p not in providers_to_try and p not in disabled_providers:
+        if p not in providers_to_try and p not in disabled_providers and get_api_key(p, config):
             providers_to_try.append(p)
 
     # Skip providers currently in cooldown
@@ -2538,6 +2713,20 @@ Full docs: See README.md and SKILL.md
                 include_images=args.images,
                 include_raw_content=args.raw_content,
             )
+        elif prov == "querit":
+            return search_querit(
+                query=args.query,
+                api_key=key,
+                max_results=args.max_results,
+                language=args.language,
+                country=args.country,
+                time_range=args.time_range or args.freshness,
+                include_domains=args.include_domains,
+                exclude_domains=args.exclude_domains,
+                base_url=args.querit_base_url,
+                base_path=args.querit_base_path,
+                timeout=int(querit_config.get("timeout", 30)),
+            )
         elif prov == "exa":
             # CLI --exa-depth overrides; fallback to auto-routing suggestion
             exa_depth = args.exa_depth
@@ -2621,6 +2810,8 @@ Full docs: See README.md and SKILL.md
         "locale": f"{args.country}:{args.language}",
         "freshness": args.freshness,
         "time_range": args.time_range,
+        "include_domains": sorted(args.include_domains) if args.include_domains else None,
+        "exclude_domains": sorted(args.exclude_domains) if args.exclude_domains else None,
         "topic": args.topic,
         "search_engines": sorted(args.engines) if args.engines else None,
         "include_news": not args.no_news,

package/scripts/setup.py

@@ -65,6 +65,14 @@ def print_provider_info():
             "signup": "https://tavily.com",
             "strengths": ["AI-synthesized answers", "Full page content", "Domain filtering", "Academic research"]
         },
+        {
+            "name": "Querit",
+            "emoji": "🗂️",
+            "best_for": "Multi-lingual AI search with rich metadata and real-time information",
+            "free_tier": "1,000 queries/month",
+            "signup": "https://querit.ai",
+            "strengths": ["Multi-lingual search", "Rich metadata", "Real-time information", "AI-ready results"]
+        },
         {
             "name": "Exa",
             "emoji": "🧠",
@@ -294,11 +302,12 @@ def run_setup(skill_dir: Path, force_reset: bool = False):
             "auto_routing": {"enabled": True, "fallback_provider": "serper"},
             "serper": {},
             "tavily": {},
+            "querit": {},
             "exa": {}
         }
     
     # Remove any existing API keys from example
-    for provider in ["serper", "tavily", "exa"]:
+    for provider in ["serper", "tavily", "querit", "exa"]:
         if provider in config:
             config[provider].pop("api_key", None)
     
@@ -314,6 +323,7 @@ def run_setup(skill_dir: Path, force_reset: bool = False):
     providers_info = {
         "serper": ("Serper", "https://serper.dev", "Google results, shopping, local"),
         "tavily": ("Tavily", "https://tavily.com", "Research, explanations, analysis"),
+        "querit": ("Querit", "https://querit.ai", "Multi-lingual AI search, rich metadata, real-time info"),
         "exa": ("Exa", "https://exa.ai", "Semantic search, similar content"),
         "you": ("You.com", "https://api.you.com", "RAG applications, real-time info"),
         "searxng": ("SearXNG", "https://docs.searxng.org/admin/installation.html", "Privacy-first, self-hosted, $0 cost")
@@ -393,7 +403,7 @@ def run_setup(skill_dir: Path, force_reset: bool = False):
     config["defaults"]["max_results"] = max_results
     
     # Set disabled providers
-    all_providers = ["serper", "tavily", "exa", "you", "searxng"]
+    all_providers = ["serper", "tavily", "querit", "exa", "you", "searxng"]
     disabled = [p for p in all_providers if p not in enabled_providers]
     config["auto_routing"]["disabled_providers"] = disabled