feat: add Tavily as parallel web search channel alongside Exa

Author: Tavily PR Agent

agent_reach/channels/__init__.py

@@ -15,6 +15,7 @@
 from .rss import RSSChannel
 from .bilibili import BilibiliChannel
 from .exa_search import ExaSearchChannel
+from .tavily_search import TavilySearchChannel
 from .xiaohongshu import XiaoHongShuChannel
 from .douyin import DouyinChannel
 from .linkedin import LinkedInChannel
@@ -41,6 +42,7 @@
     XueqiuChannel(),
     RSSChannel(),
     ExaSearchChannel(),
+    TavilySearchChannel(),
     WebChannel(),
 ]
 

agent_reach/channels/reddit.py

@@ -9,7 +9,7 @@
 class RedditChannel(Channel):
     name = "reddit"
     description = "Reddit 帖子和评论"
-    backends = ["rdt-cli"]
+    backends = ["rdt-cli", "Exa", "Tavily"]
     tier = 0
 
     def can_handle(self, url: str) -> bool:
@@ -27,5 +27,6 @@ def check(self, config=None):
             "需要安装 rdt-cli：\n"
             "  pipx install rdt-cli\n"
             "或：\n"
-            "  uv tool install rdt-cli"
+            "  uv tool install rdt-cli\n"
+            "搜索也可使用 Exa（免费）或 Tavily（需 API Key）作为替代"
         )

agent_reach/channels/tavily_search.py

@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+"""Tavily Search — API-based web search via tavily-python."""
+
+import os
+from .base import Channel
+
+
+class TavilySearchChannel(Channel):
+    name = "tavily_search"
+    description = "全网搜索（Tavily API）"
+    backends = ["Tavily API"]
+    tier = 2
+
+    def can_handle(self, url: str) -> bool:
+        return False  # Search-only channel
+
+    def check(self, config=None):
+        # Check for tavily-python
+        try:
+            import tavily  # noqa: F401
+        except ImportError:
+            return "off", (
+                "需要安装 tavily-python：\n"
+                "  pip install tavily-python"
+            )
+
+        # Check for API key via config or env
+        api_key = None
+        if config:
+            api_key = config.get("tavily_api_key")
+        if not api_key:
+            api_key = os.environ.get("TAVILY_API_KEY")
+
+        if not api_key:
+            return "off", (
+                "需要 TAVILY_API_KEY。获取：\n"
+                "  1. 访问 https://app.tavily.com 注册（每月 1000 次免费）\n"
+                "  2. agent-reach configure tavily_api_key <YOUR_KEY>"
+            )
+
+        return "ok", "Tavily 全网搜索可用（API Key 已配置）"

agent_reach/config.py

@@ -21,6 +21,7 @@ class Config:
     # Feature → required config keys
     FEATURE_REQUIREMENTS = {
         "exa_search": ["exa_api_key"],
+        "tavily_search": ["tavily_api_key"],
         "twitter_xreach": ["twitter_auth_token", "twitter_ct0"],  # legacy key name; used by bird CLI
         "groq_whisper": ["groq_api_key"],
         "github_token": ["github_token"],

agent_reach/guides/setup-tavily.md

@@ -0,0 +1,35 @@
+# Tavily Search Setup
+
+Tavily is an API-based web search provider designed for AI agents. It offers 1,000 free API credits per month.
+
+## 1. Get an API Key
+
+1. Visit [https://app.tavily.com](https://app.tavily.com)
+2. Sign up for a free account (no credit card required)
+3. Copy your API key (starts with `tvly-`)
+
+## 2. Configure Agent Reach
+
+```bash
+agent-reach configure tavily_api_key tvly-YOUR_API_KEY
+```
+
+Or set the environment variable directly:
+
+```bash
+export TAVILY_API_KEY="tvly-YOUR_API_KEY"
+```
+
+## 3. Verify
+
+```bash
+agent-reach doctor
+```
+
+You should see `tavily_search` show as **ok**.
+
+## Notes
+
+- Tavily is a Tier-2 channel (requires API key)
+- Exa Search remains available as the free/zero-config alternative
+- Install the Python SDK if not already present: `pip install tavily-python`

pyproject.toml

@@ -40,7 +40,8 @@ dependencies = [
 [project.optional-dependencies]
 browser = ["playwright>=1.40"]
 cookies = ["browser-cookie3>=0.19"]
-all = ["playwright>=1.40", "mcp[cli]>=1.0", "browser-cookie3>=0.19"]
+search = ["tavily-python>=0.3"]
+all = ["playwright>=1.40", "mcp[cli]>=1.0", "browser-cookie3>=0.19", "tavily-python>=0.3"]
 dev = [
     "pytest>=8.0",
     "ruff>=0.8",