feat(web_search): add Serply search provider

config.example.toml

@@ -995,12 +995,12 @@ max_subagents = 10 # optional (default 64, clamped to 1-128)
 # Choose which backend the Web tool's search uses. Default is keyless Firecrawl
 # (bounded per-IP quota; `[search] api_key` or FIRECRAWL_API_KEY raises it).
 # Bing and DuckDuckGo HTML scraping need no API key. Tavily, Bocha, Metaso,
-# Baidu, Volcengine and Sofya need an api_key; SearXNG needs base_url.
+# Baidu, Volcengine, Sofya and Serply need an api_key; SearXNG needs base_url.
 # API runtime failures and empty responses visibly degrade through DuckDuckGo
 # then Bing. Missing configuration and network-policy denials fail closed.
 #
 # [search]
-# provider = "firecrawl"   # firecrawl | bing | duckduckgo | tavily | bocha | metaso | searxng | baidu | volcengine | sofya
+# provider = "firecrawl"   # firecrawl | bing | duckduckgo | tavily | bocha | metaso | searxng | baidu | volcengine | sofya | serply
 #                            # firecrawl:  Firecrawl Cloud search, keyless with a bounded per-IP quota
 #                            # duckduckgo: HTML scrape with Bing fallback
 #                            # bing:       HTML scrape, no API key
@@ -1016,9 +1016,12 @@ max_subagents = 10 # optional (default 64, clamped to 1-128)
 #                            # sofya:      https://sofya.co — AI search returning full page
 #                            #             content (not snippets), needs api_key (ay_live_...);
 #                            #             also falls back to the SOFYA_API_KEY env var
+#                            # serply:     https://serply.io Google organic results with
+#                            #             snippets, needs api_key;
+#                            #             also falls back to the SERPLY_API_KEY env var
 # base_url = "https://search.example/" # optional DuckDuckGo-compatible HTML endpoint;
 #                                      # required SearXNG root or /search endpoint
-# api_key = "YOUR_SEARCH_KEY" # required for tavily, bocha, metaso, baidu, volcengine, and sofya; optional for firecrawl (raises the keyless quota); unused by searxng
+# api_key = "YOUR_SEARCH_KEY" # required for tavily, bocha, metaso, baidu, volcengine, sofya, and serply; optional for firecrawl (raises the keyless quota); unused by searxng
 #                             # WARNING: treat config.toml like a secret file when
 #                             # storing API keys. Prefer env vars for local smoke tests.
 #
@@ -1034,6 +1037,7 @@ max_subagents = 10 # optional (default 64, clamped to 1-128)
 #   BAIDU_SEARCH_API_KEY     → baidu key fallback
 #   VOLCENGINE_API_KEY / VOLCENGINE_ARK_API_KEY / ARK_API_KEY → volcengine key fallback
 #   SOFYA_API_KEY            → sofya key fallback
+#   SERPLY_API_KEY           → serply key fallback
 
 # ─────────────────────────────────────────────────────────────────────────────────
 # Network Policy (#135)

crates/tui/src/config/search.rs

@@ -60,6 +60,10 @@ pub enum SearchProvider {
     /// snippets; falls back to the `SOFYA_API_KEY` env var when
     /// `[search] api_key` is not set.
     Sofya,
+    /// Serply Google search API (<https://serply.io>). Requires api_key;
+    /// returns Google organic results with snippets. Falls back to the
+    /// `SERPLY_API_KEY` env var when `[search] api_key` is not set.
+    Serply,
 }
 
 impl SearchProvider {
@@ -78,6 +82,7 @@ impl SearchProvider {
             }
             "volcengine" | "ark" | "volc" | "volcengine-ark" => Some(Self::Volcengine),
             "sofya" => Some(Self::Sofya),
+            "serply" => Some(Self::Serply),
             _ => None,
         }
     }
@@ -95,12 +100,13 @@ impl SearchProvider {
             Self::Baidu => "baidu",
             Self::Volcengine => "volcengine",
             Self::Sofya => "sofya",
+            Self::Serply => "serply",
         }
     }
 
     #[must_use]
     pub fn names_hint() -> &'static str {
-        "bing, duckduckgo, firecrawl, tavily, bocha, metaso, searxng, baidu, volcengine, sofya"
+        "bing, duckduckgo, firecrawl, tavily, bocha, metaso, searxng, baidu, volcengine, sofya, serply"
     }
 }
 
@@ -139,9 +145,10 @@ pub struct SearchConfig {
     /// SearXNG instance root or `/search` endpoint.
     #[serde(default)]
     pub base_url: Option<String>,
-    /// Optional for Firecrawl; required for Tavily, Bocha, Metaso, Baidu, Volcengine, or Sofya.
+    /// Optional for Firecrawl; required for Tavily, Bocha, Metaso, Baidu, Volcengine, Sofya, or Serply.
     /// Metaso also falls back to the `METASO_API_KEY` env var.
     /// Baidu also falls back to `BAIDU_SEARCH_API_KEY` env var.
+    /// Serply also falls back to the `SERPLY_API_KEY` env var.
     /// Volcengine also falls back to `VOLCENGINE_API_KEY` / `VOLCENGINE_ARK_API_KEY` / `ARK_API_KEY` env vars.
     #[serde(default)]
     pub api_key: Option<String>,

crates/tui/src/config/tests.rs

@@ -2008,6 +2008,35 @@ fn sofya_search_provider_parses_and_round_trips() {
     assert_eq!(SearchProvider::Sofya.as_str(), "sofya");
 }
 
+#[test]
+fn explicit_serply_search_provider_is_preserved() {
+    let config: Config = toml::from_str(
+        r#"
+        [search]
+        provider = "serply"
+        "#,
+    )
+    .expect("serply search config");
+
+    assert_eq!(
+        config.search.and_then(|search| search.provider),
+        Some(SearchProvider::Serply)
+    );
+}
+
+#[test]
+fn serply_search_provider_parses_and_round_trips() {
+    assert_eq!(
+        SearchProvider::parse("serply"),
+        Some(SearchProvider::Serply)
+    );
+    assert_eq!(
+        SearchProvider::parse("Serply"),
+        Some(SearchProvider::Serply)
+    );
+    assert_eq!(SearchProvider::Serply.as_str(), "serply");
+}
+
 #[test]
 fn live_search_provider_update_preserves_environment_precedence() {
     let _guard = lock_test_env();

crates/tui/src/lib.rs

@@ -2831,6 +2831,7 @@ fn is_workspace_dotenv_credential_key(key: &str) -> bool {
             key,
             "DEEPSEEK_SEARCH_API_KEY"
                 | "SOFYA_API_KEY"
+                | "SERPLY_API_KEY"
                 | "METASO_API_KEY"
                 | "BAIDU_SEARCH_API_KEY"
                 | "DEEPSEEK_SANDBOX_API_KEY"

crates/tui/src/tools/web/backend.rs

@@ -37,6 +37,7 @@ pub(crate) enum ConfiguredSearchBackend<'a> {
     Baidu(BackendContext<'a>),
     Volcengine(BackendContext<'a>),
     Sofya(BackendContext<'a>),
+    Serply(BackendContext<'a>),
 }
 
 #[derive(Clone, Copy)]
@@ -61,6 +62,7 @@ impl<'a> ConfiguredSearchBackend<'a> {
             SearchProvider::Baidu => Self::Baidu(backend),
             SearchProvider::Volcengine => Self::Volcengine(backend),
             SearchProvider::Sofya => Self::Sofya(backend),
+            SearchProvider::Serply => Self::Serply(backend),
         }
     }
 
@@ -76,6 +78,7 @@ impl<'a> ConfiguredSearchBackend<'a> {
             Self::Baidu(_) => SearchProvider::Baidu,
             Self::Volcengine(_) => SearchProvider::Volcengine,
             Self::Sofya(_) => SearchProvider::Sofya,
+            Self::Serply(_) => SearchProvider::Serply,
         }
     }
 
@@ -90,7 +93,8 @@ impl<'a> ConfiguredSearchBackend<'a> {
             | Self::Searxng(context)
             | Self::Baidu(context)
             | Self::Volcengine(context)
-            | Self::Sofya(context) => context,
+            | Self::Sofya(context)
+            | Self::Serply(context) => context,
         }
     }
 }
@@ -288,6 +292,7 @@ impl SearchBackend for ConfiguredSearchBackend<'_> {
             SearchProvider::Baidu => BackendId::Baidu,
             SearchProvider::Volcengine => BackendId::Volcengine,
             SearchProvider::Sofya => BackendId::Sofya,
+            SearchProvider::Serply => BackendId::Serply,
         }
     }
 
@@ -516,6 +521,7 @@ mod tests {
             (SearchProvider::Baidu, BackendId::Baidu),
             (SearchProvider::Volcengine, BackendId::Volcengine),
             (SearchProvider::Sofya, BackendId::Sofya),
+            (SearchProvider::Serply, BackendId::Serply),
         ];
 
         for (provider, expected) in cases {

crates/tui/src/tools/web/contract.rs

@@ -30,6 +30,7 @@ pub(crate) enum BackendId {
     Baidu,
     Volcengine,
     Sofya,
+    Serply,
 }
 
 impl BackendId {
@@ -47,6 +48,7 @@ impl BackendId {
             Self::Baidu => "baidu",
             Self::Volcengine => "volcengine",
             Self::Sofya => "sofya",
+            Self::Serply => "serply",
         }
     }
 }