web-search-plus-plugin 1.2.2 → 1.3.0

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

@@ -1,3 +1,4 @@
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { Type } from "@sinclair/typebox";
 import { spawnSync } from "child_process";
 import fs from "fs";
@@ -34,183 +35,191 @@ function loadEnvFile(envPath: string): Record<string, string> {
 const PLUGIN_DIR = getPluginDir();
 const scriptPath = path.join(PLUGIN_DIR, "scripts", "search.py");
 
-export default function (api: any) {
-  // Bridge OpenClaw config fields to env vars expected by search.py
-  const configEnv: Record<string, string> = {};
-  const pluginConfig: Record<string, string> = (api as any)?.config ?? {};
-  const configKeyMap: Record<string, string> = {
-    serperApiKey: "SERPER_API_KEY",
-    tavilyApiKey: "TAVILY_API_KEY",
-    exaApiKey: "EXA_API_KEY",
-    perplexityApiKey: "PERPLEXITY_API_KEY",
-    kilocodeApiKey: "KILOCODE_API_KEY",
-    youApiKey: "YOU_API_KEY",
-    searxngInstanceUrl: "SEARXNG_INSTANCE_URL",
-  };
-  for (const [cfgKey, envKey] of Object.entries(configKeyMap)) {
-    const val = pluginConfig[cfgKey];
-    if (val && typeof val === "string") configEnv[envKey] = val;
-  }
-
-  api.registerTool(
-    {
-      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.",
-      parameters: Type.Object({
-        query: Type.String({ description: "Search query" }),
-        provider: Type.Optional(
-          Type.Union(
-            [
-              Type.Literal("serper"),
-              Type.Literal("tavily"),
-              Type.Literal("exa"),
-              Type.Literal("perplexity"),
-              Type.Literal("you"),
-              Type.Literal("searxng"),
-              Type.Literal("auto"),
-            ],
-            {
-              description:
-                "Force a specific provider, or 'auto' for smart routing (default: auto)",
-            },
+export default definePluginEntry({
+  id: "web-search-plus-plugin",
+  name: "Web Search Plus",
+  description:
+    "Multi-provider web search (Serper/Google, Tavily, Querit/Multilingual AI Search, Exa/Neural+Deep, Perplexity, You.com, SearXNG) with intelligent auto-routing",
+  register(api) {
+    // Bridge OpenClaw config fields to env vars expected by search.py
+    const configEnv: Record<string, string> = {};
+    const pluginConfig: Record<string, string> = (api as any)?.config ?? {};
+    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",
+      youApiKey: "YOU_API_KEY",
+      searxngInstanceUrl: "SEARXNG_INSTANCE_URL",
+    };
+    for (const [cfgKey, envKey] of Object.entries(configKeyMap)) {
+      const val = pluginConfig[cfgKey];
+      if (val && typeof val === "string") configEnv[envKey] = val;
+    }
+
+    api.registerTool(
+      {
+        name: "web_search_plus",
+        description:
+          "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(
+            Type.Union(
+              [
+                Type.Literal("serper"),
+                Type.Literal("tavily"),
+                Type.Literal("querit"),
+                Type.Literal("exa"),
+                Type.Literal("perplexity"),
+                Type.Literal("you"),
+                Type.Literal("searxng"),
+                Type.Literal("auto"),
+              ],
+              {
+                description:
+                  "Force a specific provider, or 'auto' for smart routing (default: auto)",
+              },
+            ),
+          ),
+          count: Type.Optional(
+            Type.Number({ description: "Number of results (default: 5)" }),
+          ),
+          depth: Type.Optional(
+            Type.Union(
+              [
+                Type.Literal("normal"),
+                Type.Literal("deep"),
+                Type.Literal("deep-reasoning"),
+              ],
+              {
+                description:
+                  "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.",
+              },
+            ),
           ),
-        ),
-        count: Type.Optional(
-          Type.Number({ description: "Number of results (default: 5)" }),
-        ),
-        depth: Type.Optional(
-          Type.Union(
-            [
-              Type.Literal("normal"),
-              Type.Literal("deep"),
-              Type.Literal("deep-reasoning"),
-            ],
-            {
+          include_domains: Type.Optional(
+            Type.Array(Type.String(), {
               description:
-                "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.",
-            },
+                "Only include results from these domains (e.g. ['arxiv.org', 'github.com']). Supported by Tavily and Exa.",
+            }),
           ),
-        ),
-        time_range: Type.Optional(
-          Type.Union(
-            [
-              Type.Literal("day"),
-              Type.Literal("week"),
-              Type.Literal("month"),
-              Type.Literal("year"),
-            ],
-            {
+          exclude_domains: Type.Optional(
+            Type.Array(Type.String(), {
               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.",
-            },
+                "Exclude results from these domains (e.g. ['reddit.com', 'pinterest.com']). Supported by Tavily and Exa.",
+            }),
           ),
-        ),
-        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,
-        params: {
-          query: string;
-          provider?: string;
-          count?: number;
-          depth?: string;
-          time_range?: string;
-          include_domains?: string[];
-          exclude_domains?: string[];
-        },
-      ) {
-        const args = [scriptPath, "--query", params.query, "--compact"];
-
-        if (params.provider && params.provider !== "auto") {
-          args.push("--provider", params.provider);
-        }
-
-        if (typeof params.count === "number" && Number.isFinite(params.count)) {
-          args.push(
-            "--max-results",
-            String(Math.max(1, Math.floor(params.count))),
-          );
-        }
-
-        if (params.depth && params.depth !== "normal") {
-          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"),
-        ];
-        const fileEnv: Record<string, string> = {};
-        for (const envPath of envPaths) {
-          Object.assign(fileEnv, loadEnvFile(envPath));
-        }
-        const childEnv = { ...process.env, ...configEnv, ...fileEnv };
-
-        try {
-          const child = spawnSync("python3", args, {
-            timeout: 75000,
-            env: childEnv,
-            shell: false,
-            encoding: "utf8",
-          });
-
-          if (child.error) {
-            return {
-              content: [
-                { type: "text", text: `Search failed: ${child.error.message}` },
-              ],
-            };
+        }),
+        async execute(
+          _id: string,
+          params: {
+            query: string;
+            provider?: string;
+            count?: number;
+            depth?: string;
+            time_range?: string;
+            include_domains?: string[];
+            exclude_domains?: string[];
+          },
+        ) {
+          const args = [scriptPath, "--query", params.query, "--compact"];
+
+          if (params.provider && params.provider !== "auto") {
+            args.push("--provider", params.provider);
+          }
+
+          if (typeof params.count === "number" && Number.isFinite(params.count)) {
+            args.push(
+              "--max-results",
+              String(Math.max(1, Math.floor(params.count))),
+            );
           }
 
-          if (child.status !== 0) {
-            const stderr = child.stderr?.trim() || "Unknown error";
+          if (params.depth && params.depth !== "normal") {
+            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"),
+          ];
+          const fileEnv: Record<string, string> = {};
+          for (const envPath of envPaths) {
+            Object.assign(fileEnv, loadEnvFile(envPath));
+          }
+          const childEnv = { ...process.env, ...configEnv, ...fileEnv };
+
+          try {
+            const child = spawnSync("python3", args, {
+              timeout: 75000,
+              env: childEnv,
+              shell: false,
+              encoding: "utf8",
+            });
+
+            if (child.error) {
+              return {
+                content: [
+                  { type: "text", text: `Search failed: ${child.error.message}` },
+                ],
+              };
+            }
+
+            if (child.status !== 0) {
+              const stderr = child.stderr?.trim() || "Unknown error";
+              return {
+                content: [
+                  {
+                    type: "text",
+                    text: `Search failed (exit ${child.status}): ${stderr}`,
+                  },
+                ],
+              };
+            }
+
+            return {
+              content: [{ type: "text", text: child.stdout?.trim() || "{}" }],
+            };
+          } catch (err: any) {
             return {
               content: [
-                {
-                  type: "text",
-                  text: `Search failed (exit ${child.status}): ${stderr}`,
-                },
+                { type: "text", text: `Search failed: ${err?.message ?? err}` },
               ],
             };
           }
-
-          return {
-            content: [{ type: "text", text: child.stdout?.trim() || "{}" }],
-          };
-        } catch (err: any) {
-          return {
-            content: [
-              { type: "text", text: `Search failed: ${err?.message ?? err}` },
-            ],
-          };
-        }
+        },
       },
-    },
-    { optional: true },
-  );
-}
+      { optional: true },
+    );
+  },
+});

package/openclaw.plugin.json

@@ -1,15 +1,15 @@
 {
   "id": "web-search-plus-plugin",
-  "kind": "skill",
   "name": "Web Search Plus",
-  "version": "1.2.2",
-  "description": "Multi-provider web search (Serper/Google, Tavily, Exa/Neural+Deep, Perplexity, You.com, SearXNG) with intelligent auto-routing",
+  "version": "1.3.0",
+  "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 +20,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,9 +1,12 @@
 {
   "name": "web-search-plus-plugin",
-  "version": "1.2.2",
-  "description": "OpenClaw plugin: multi-provider web search (Serper/Google, Tavily, Exa/Neural+Deep, Perplexity, You.com, SearXNG) with intelligent auto-routing",
+  "version": "1.3.0",
+  "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",
+  "openclaw": {
+    "extensions": ["./index.ts"]
+  },
   "files": [
     "index.ts",
     "openclaw.plugin.json",
@@ -12,7 +15,10 @@
     "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"],
+  "peerDependencies": {
+    "openclaw": ">=2026.3.22"
+  },
   "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",
     }
@@ -474,7 +482,8 @@ def validate_api_key(provider: str, config: Dict[str, Any] = None) -> str:
     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"
@@ -483,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"
@@ -1161,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
@@ -1171,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,
@@ -1221,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:
@@ -1337,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),
@@ -1358,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", [])
         ]
     }
@@ -1523,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)
 
@@ -1672,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)
 # =============================================================================
@@ -2273,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
@@ -2293,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(
@@ -2353,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(
@@ -2520,7 +2663,7 @@ 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
@@ -2570,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
@@ -2653,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