dsh-free-search 0.4.25 → 0.4.26

package/README.md

@@ -29,11 +29,11 @@ dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`
 ### 特性
 
 - **零成本** —— 多个免费引擎，无需 key、无需注册
-- **多引擎可选**：DuckDuckGo（html/lite）、Bing、SearXNG（元搜索，支持自定义实例）、AnySearch、Exa、Tavily、Keenable、Perplexity、DeepSeek 官方
+- **多引擎可选**：DuckDuckGo（html/lite）、Bing、SearXNG（元搜索，支持自定义实例）、AnySearch、Exa、Tavily、Keenable、Firecrawl、Parallel、Perplexity、DeepSeek 官方
 - **网页设置页** —— 引擎切换 + API key 配置（UI 中 key 脱敏显示"已配置"）+ 中英文切换
 - **弹出式切换命令** —— 聊天框输入 `/free-search-engine`，弹出引擎选择窗口，点选即切换（等效设置页 + 保存）
 - **引擎测试** —— `free_search_test` 工具让 agent 一键测试所有引擎；设置页也有"测试引擎"按钮（直测当前引擎，不走回退链，付费引擎无 key 会明确报错）
-- **统一引擎回退** —— 任何引擎失败（付费/免费，缺 key/401/限流/网络）自动轮流尝试下一个引擎：首选引擎 → 其他引擎（exa/tavily/keenable 无 key 也会尝试，因为它们自带 keyless 免费额度）→ 剩余免费引擎，搜索永不直接失败；结果顶部注明实际生效的引擎（如 `Note: perplexity unavailable or failed, using exa.`）
+- **统一引擎回退** —— 任何引擎失败（付费/免费，缺 key/401/限流/网络）自动轮流尝试下一个引擎：首选引擎 → 其他引擎（exa/tavily/keenable/firecrawl 无 key 也会尝试，因为它们自带 keyless 免费额度）→ 剩余免费引擎，搜索永不直接失败；结果顶部注明实际生效的引擎（如 `Note: perplexity unavailable or failed, using exa.`）
 - **时间过滤** —— `advanced_search` 工具支持 `timeRange`：固定档、自定义相对值、绝对日期三种形式（详见下方逻辑说明）
 - **系统提示词注入** —— agent 知道当前用哪个引擎、哪些需要 key
 - **版本号 + 检查更新** —— 设置卡片显示当前版本（v0.4.17），"检查更新"按钮直连 npm registry 对比最新版，有新版本时提示并可一键跳转
@@ -57,6 +57,8 @@ dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`
 | `exa` | Exa | 免费 | **无 key 也可用**（MCP 匿名），配 key 提升额度 |
 | `tavily` | Tavily | 免费 | **无 key 也可用**（keyless 匿名），配 key 提升额度 |
 | `keenable` | Keenable | 免费 | **无 key 也可用**（MCP 匿名），配 key 提升额度 |
+| `firecrawl` | Firecrawl | 免费 | **无 key 也可用**（官方免 key 匿名额度），配 key 提升限额 |
+| `parallel` | Parallel | 付费 | 需 `PARALLEL_API_KEY`（platform.parallel.ai 有免费额度） |
 | `perplexity` | Perplexity | 付费 | 需 `PERPLEXITY_API_KEY` |
 | `deepseek-official` | DeepSeek 官方 | 付费 | 需 `DEEPSEEK_API_KEY` |
 
@@ -66,6 +68,7 @@ dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`
   - Exa：<https://dashboard.exa.ai/api-keys>
   - Tavily：<https://app.tavily.com/home>
   - Keenable：<https://keenable.ai/login>
+  - Parallel：<https://platform.parallel.ai>
   - Perplexity：<https://www.perplexity.ai/settings/api>
   - DeepSeek：<https://platform.deepseek.com/api_keys>
 
@@ -75,6 +78,7 @@ dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`
 - **Exa**：公开 MCP 端点（`mcp.exa.ai/mcp`）支持匿名调用，不配 key 也能用；配置 `EXA_API_KEY` 后可获得更高额度。
 - **Tavily**：通过 `x-tavily-access-mode: keyless` 头走 keyless 匿名额度，不配 key 即可用；配置 `TAVILY_API_KEY` 后走账号档，额度更高、结果质量更稳定。
 - **Keenable**：无 key 时走其公开 MCP 端点（`api.keenable.ai/mcp`）匿名调用；配置 `KEENABLE_API_KEY` 后走 REST API（`api.keenable.ai/v1/search`），额度更高、按组织限流。
+- **Firecrawl**：其 `/v2/search` 端点**无需 key** 即可使用（官方文档明确说明，有匿名限流）；配置 `FIRECRAWL_API_KEY` 后可提高限额。支持 `tbs` 时间过滤（`qdr:h/d/w/m/y` 与自定义日期区间）。
 
 ### 安装
 
@@ -110,7 +114,7 @@ dsh web
 安装后，打开 **设置 → 插件 → 可配置** 标签页 → **Free Search** 卡片（官方设置页）：
 
 - **Search engine**：下拉框切换引擎，保存即生效
-- **API keys**：为 Exa / Tavily / Keenable / Perplexity / DeepSeek 填写 key（密码框，保存后只显示"已配置"）
+- **API keys**：为 Exa / Tavily / Keenable / Firecrawl / Parallel / Perplexity / DeepSeek 填写 key（密码框，保存后只显示"已配置"）
   - **推荐**：付费引擎 key 建议写入 harness 凭据中心 `~/.dsh/.credentials.yaml`（如 `DEEPSEEK_API_KEY: sk-...`，与官方 LLM provider 一致，一处管理所有 key）。插件读取优先级：凭据中心 > 设置页 > 环境变量，设置页填的 key 仅作为遗留兼容。
 - **Test engine**：直测当前引擎可用性（不走回退链，付费引擎无 key 会明确报错）
 - **Use Bing default**：把当前搜索引擎切回稳定的免费 Bing；`Discard` 只撤销尚未保存的编辑
@@ -148,7 +152,7 @@ dsh web
 
 ```yaml
 free-search:
-  provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / perplexity / deepseek-official
+  provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / firecrawl / parallel / perplexity / deepseek-official
   lang: zh                    # 设置页界面语言（zh / en）
   bingMarket: zh-CN           # Bing 市场
   region: cn-zh               # DuckDuckGo 区域（可选）
@@ -157,6 +161,8 @@ free-search:
   exaApiKey: ...              # 或通过设置页填写
   tavilyApiKey: ...           # 或通过设置页填写
   keenableApiKey: ...         # 或通过设置页填写
+  firecrawlApiKey: ...        # 或通过设置页填写
+  parallelApiKey: ...         # 或通过设置页填写
   perplexityApiKey: ...
   deepseekApiKey: ...
 ```
@@ -191,13 +197,15 @@ Search engine test:
 | Exa | `startPublishedDate` | ✅ 精确 | 自定义天数转成 ISO 日期（N 天前），绝对日期原样传入 |
 | Keenable | `published_after` | ✅ 精确 | 相对值原样传（`12h/3d/2mo/1y`），绝对日期原样传 |
 | Tavily | `time_range` | ⚠️ 近似 | 只认固定档，自定义天数自动映射到最近似档位 |
+| Firecrawl | `tbs` | ⚠️ 近似 | 固定档映射到 `qdr:d/w/m/y`；绝对日期用 `cdr:1,cd_min:M/D/YYYY`（精确） |
+| Parallel | `source_policy.after_date` | ✅ 精确 | 自定义天数转成 ISO 日期（N 天前），绝对日期原样传入 |
 | SearXNG | `time_range` | ⚠️ 近似 | 同上 |
 | DuckDuckGo / Lite | `df` | ⚠️ 近似 | 同上 |
 | Bing / AnySearch | — | ❌ 忽略 | 无对应参数 |
 
 **"最近似档位"映射规则**：`≤2 天 → day`，`≤14 天 → week`，`≤90 天 → month`，否则 `year`。例如 `3d` 在 Tavily 上按 `day` 处理，`2mo` 按 `month` 处理。
 
-**引擎链优先级**：当带 timeRange 搜索时，支持时间过滤的引擎（tavily / exa / keenable / searxng / ddg / ddg-lite）会排到引擎链前面，确保过滤真正生效——即使首选引擎是 bing（不支持过滤），也会先尝试支持过滤的引擎。
+**引擎链优先级**：当带 timeRange 搜索时，支持时间过滤的引擎（tavily / exa / keenable / firecrawl / parallel / searxng / ddg / ddg-lite）会排到引擎链前面，确保过滤真正生效——即使首选引擎是 bing（不支持过滤），也会先尝试支持过滤的引擎。
 
 示例对话：*"帮我搜最近 3 天关于 DSH 的新闻"* → agent 调用 `advanced_search`，`timeRange: "3d"`。
 
@@ -282,11 +290,11 @@ This plugin provides multiple free search engines with automatic fallback, compl
 ### Features
 
 - **Zero Cost** — Multiple free engines with no API key or registration required
-- **Multi-Engine Support** — DuckDuckGo (HTML / Lite), Bing, AnySearch AI, SearXNG (meta-search with custom instances), Exa, Tavily, Keenable, Perplexity, and DeepSeek Official
+- **Multi-Engine Support** — DuckDuckGo (HTML / Lite), Bing, AnySearch AI, SearXNG (meta-search with custom instances), Exa, Tavily, Keenable, Firecrawl, Parallel, Perplexity, and DeepSeek Official
 - **Web Settings UI** — Engine switching, API key configuration (keys masked as "configured" in the UI), and a Chinese/English toggle
 - **Popup Switch Command** — Type `/free-search-engine` in the chat: a picker opens with all engines; click one to switch (equivalent to the settings page + save)
 - **Engine Testing** — `free_search_test` for the agent to check all engines in one call; the settings UI also has a "Test engine" button that tests the selected engine directly (no fallback chain; paid engines without a key report an explicit error)
-- **Unified Engine Fallback** — Any engine failure (paid or free, missing key, 401, rate limit, network error) automatically tries the next engine: the configured engine first, then other engines (exa/tavily/keenable are tried even without a key because they have built-in keyless quota), then the remaining free engines (Bing/AnySearch etc.) — with a note attached to the results naming the engine that actually served them (e.g. `Note: perplexity unavailable or failed, using exa.`). Search never fails outright.
+- **Unified Engine Fallback** — Any engine failure (paid or free, missing key, 401, rate limit, network error) automatically tries the next engine: the configured engine first, then other engines (exa/tavily/keenable/firecrawl are tried even without a key because they have built-in keyless quota), then the remaining free engines (Bing/AnySearch etc.) — with a note attached to the results naming the engine that actually served them (e.g. `Note: perplexity unavailable or failed, using exa.`). Search never fails outright.
 - **Time Filtering** — The `advanced_search` tool supports `timeRange`: fixed tiers, custom relative values, or an absolute date (details below)
 - **System Prompt Injection** — The agent is aware of the currently active engine and which engines require API keys
 - **Version + Update Check** — The settings card shows the current version (v0.4.17), and a "Check update" button queries the npm registry to compare against the latest release, prompting a one-click jump when a newer version exists
@@ -310,15 +318,18 @@ If this plugin has been helpful, a ⭐ on [GitHub](https://github.com/DDDMUC/dsh
 | `exa` | Exa | Free | **Usable without a key** (anonymous MCP); configure a key for higher quota |
 | `tavily` | Tavily | Free | **Usable without a key** (keyless anonymous); configure a key for higher quota |
 | `keenable` | Keenable | Free | **Usable without a key** (anonymous MCP); configure a key for higher quota |
+| `firecrawl` | Firecrawl | Free | **Usable without a key** (official keyless anonymous quota); configure a key for higher limits |
+| `parallel` | Parallel | Paid | Requires `PARALLEL_API_KEY` (free tier available at platform.parallel.ai) |
 | `perplexity` | Perplexity | Paid | Requires `PERPLEXITY_API_KEY` |
 | `deepseek-official` | DeepSeek Official | Paid | Requires `DEEPSEEK_API_KEY` |
 
 - **Default engine is `bing`** (free and most stable), ready to use out of the box after installation.
-- **Auto-failover**: any engine failure (rate-limited free engine, or missing/invalid paid key, network error) automatically tries the next engine — the configured engine first, then other engines (exa/tavily/keenable are tried even without a key because they have built-in keyless quota), then the remaining free engines (Bing/AnySearch etc.) — with a note attached to the results naming the engine that actually served them (e.g. `Note: perplexity unavailable or failed, using exa.`). Search never fails outright because of engine issues.
+- **Auto-failover**: any engine failure (rate-limited free engine, or missing/invalid paid key, network error) automatically tries the next engine — the configured engine first, then other engines (exa/tavily/keenable/firecrawl are tried even without a key because they have built-in keyless quota), then the remaining free engines (Bing/AnySearch etc.) — with a note attached to the results naming the engine that actually served them (e.g. `Note: perplexity unavailable or failed, using exa.`). Search never fails outright because of engine issues.
 - **Official Links in Settings**: Free engines display "Visit Website →", while paid engines display "Get API Key →" (opens in a new tab):
   - Exa: <https://dashboard.exa.ai/api-keys>
   - Tavily: <https://app.tavily.com/home>
   - Keenable: <https://keenable.ai/login>
+  - Parallel: <https://platform.parallel.ai>
   - Perplexity: <https://www.perplexity.ai/settings/api>
   - DeepSeek: <https://platform.deepseek.com/api_keys>
 
@@ -328,6 +339,7 @@ If this plugin has been helpful, a ⭐ on [GitHub](https://github.com/DDDMUC/dsh
 - **Exa**: its public MCP endpoint (`mcp.exa.ai/mcp`) supports anonymous requests, so it works without a key; configuring `EXA_API_KEY` grants a higher usage quota.
 - **Tavily**: offers keyless anonymous quota via the `x-tavily-access-mode: keyless` header — it works without a key; configuring `TAVILY_API_KEY` switches to the account tier for higher quota and more stable results.
 - **Keenable**: without a key it is called via its public MCP endpoint (`api.keenable.ai/mcp`); configuring `KEENABLE_API_KEY` switches to the REST API (`api.keenable.ai/v1/search`) for higher quota and organization-scoped rate limits.
+- **Firecrawl**: its `/v2/search` endpoint works **without a key** out of the box (the official docs state "No API key needed to get started", with anonymous rate limits); configuring `FIRECRAWL_API_KEY` raises the limits. Supports `tbs` time filtering (`qdr:h/d/w/m/y` and custom date ranges).
 
 ### Installation
 
@@ -363,7 +375,7 @@ This plugin intentionally specifies `@deepseek-ai/dsh-settings` and `@deepseek-a
 After installation, navigate to **Settings → Plugins → Configurable** tab → **Free Search** card (the official settings page):
 
 - **Search engine**: Select an engine from the dropdown; changes take effect immediately upon saving.
-- **API keys**: Enter keys for Exa / Tavily / Keenable / Perplexity / DeepSeek (password fields; displayed as "configured" once saved).
+- **API keys**: Enter keys for Exa / Tavily / Keenable / Firecrawl / Parallel / Perplexity / DeepSeek (password fields; displayed as "configured" once saved).
   - **Recommended**: store paid-engine keys in the harness credential center `~/.dsh/.credentials.yaml` (e.g. `DEEPSEEK_API_KEY: sk-...`, same as the official LLM providers — one place for all keys). Resolution order: credentials center > settings page > environment variable; the settings-page fields remain for backward compatibility.
 - **Test engine**: Tests the selected engine directly (no fallback chain; paid engines without a key report an explicit error).
 - **Use Bing default**: stage a switch back to the stable free Bing engine; `Discard` only cancels unsaved edits
@@ -401,7 +413,7 @@ Configuration is stored in `~/.dsh/settings.yaml`:
 
 ```yaml
 free-search:
-  provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / perplexity / deepseek-official
+  provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / firecrawl / parallel / perplexity / deepseek-official
   lang: zh                    # settings UI language (zh / en)
   bingMarket: zh-CN           # Bing market
   region: cn-zh               # DuckDuckGo region (optional)
@@ -410,6 +422,8 @@ free-search:
   exaApiKey: ...              # Or configure via the web settings UI
   tavilyApiKey: ...           # Or configure via the web settings UI
   keenableApiKey: ...         # Or configure via the web settings UI
+  firecrawlApiKey: ...        # Or configure via the web settings UI
+  parallelApiKey: ...         # Or configure via the web settings UI
   perplexityApiKey: ...
   deepseekApiKey: ...
 ```
@@ -444,13 +458,15 @@ Ask the agent for *"news from the last week"*, *"releases this month"*, *"update
 | Exa | `startPublishedDate` | ✅ precise | custom days become an ISO date (N days ago); absolute dates pass through |
 | Keenable | `published_after` | ✅ precise | relative values (`12h/3d/2mo/1y`) and absolute dates pass through |
 | Tavily | `time_range` | ⚠️ approximate | only fixed tiers; custom days map to the nearest tier |
+| Firecrawl | `tbs` | ⚠️ approximate | fixed tiers map to `qdr:d/w/m/y`; absolute dates use `cdr:1,cd_min:M/D/YYYY` (precise) |
+| Parallel | `source_policy.after_date` | ✅ precise | custom days become an ISO date (N days ago); absolute dates pass through |
 | SearXNG | `time_range` | ⚠️ approximate | same as above |
 | DuckDuckGo / Lite | `df` | ⚠️ approximate | same as above |
 | Bing / AnySearch | — | ❌ ignored | no corresponding parameter |
 
 **Nearest-tier mapping rule**: `≤2 days → day`, `≤14 days → week`, `≤90 days → month`, otherwise `year`. For example, `3d` becomes `day` on Tavily, and `2mo` becomes `month`.
 
-**Engine-chain priority**: when a `timeRange` is present, engines that support time filtering (tavily / exa / keenable / searxng / ddg / ddg-lite) are moved to the front of the fallback chain, so the filter actually takes effect — even if the preferred engine is bing (which does not support filtering), a filtering-capable engine is tried first.
+**Engine-chain priority**: when a `timeRange` is present, engines that support time filtering (tavily / exa / keenable / firecrawl / parallel / searxng / ddg / ddg-lite) are moved to the front of the fallback chain, so the filter actually takes effect — even if the preferred engine is bing (which does not support filtering), a filtering-capable engine is tried first.
 
 Example: *"Find DSH news from the last 3 days"* → agent calls `advanced_search` with `timeRange: "3d"`.
 

package/lib/client.js

@@ -78,7 +78,7 @@ window.__ModuleLoader__.load({
     const NS = "free-search";
     const I18N = {
       zh: {
-        description: "免费搜索 —— 无需 API key（Bing / DuckDuckGo / AnySearch / Exa / Tavily / Keenable）",
+        description: "免费搜索 —— 无需 API key（Bing / DuckDuckGo / AnySearch / Exa / Tavily / Keenable / Firecrawl）",
         unsaved: "未保存",
         searchEngine: "搜索引擎",
         visit: "访问官网 →",
@@ -88,13 +88,15 @@ window.__ModuleLoader__.load({
         exaPh: (c) => c ? "Exa API 密钥（已配置）" : "Exa API 密钥（可选，不填也可免费使用）",
         tavilyPh: (c) => c ? "Tavily API 密钥（已配置）" : "Tavily API 密钥（可选，不填也可免费使用）",
         keenablePh: (c) => c ? "Keenable API 密钥（已配置）" : "Keenable API 密钥（可选，不填也可免费使用）",
+        firecrawlPh: (c) => c ? "Firecrawl API 密钥（已配置）" : "Firecrawl API 密钥（可选，不填也可免费使用）",
+        parallelPh: (c) => c ? "Parallel API 密钥（已配置）" : "Parallel API 密钥（必填，platform.parallel.ai）",
         perplexityPh: (c) => c ? "Perplexity API 密钥（已配置）" : "Perplexity API 密钥（pplx-...）",
         deepseekPh: (c) => c ? "DeepSeek API 密钥（已配置）" : "DeepSeek API 密钥（sk-...）",
         keysHint: "密钥读取优先级：.credentials.yaml 凭据中心 > 这里 > 环境变量。推荐把 key 写进凭据中心（与官方 LLM 一致，一处管理）。",
         keyStorage: "Key 存储位置",
         keyStorageCred: "凭据中心（推荐）",
         keyStorageSettings: "设置页（兼容）",
-        keyStorageCredHint: (c) => `保存后写入 ~/.dsh/.credentials.yaml（最高优先级）。当前已配置：${["exa", "tavily", "keenable", "perplexity", "deepseek"].filter((k) => c[k]).map((k) => k.toUpperCase()).join(", ") || "无"}`,
+        keyStorageCredHint: (c) => `保存后写入 ~/.dsh/.credentials.yaml（最高优先级）。当前已配置：${["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "deepseek"].filter((k) => c[k]).map((k) => k.toUpperCase()).join(", ") || "无"}`,
         keyStorageSettingsHint: "保存后写入 settings.yaml（向后兼容路径，优先级低于凭据中心）。",
         platformSearch: "平台搜索（platform_search 工具）",
         platformHint: "为 agent 的 platform_search 工具启用平台。禁用的平台会被跳过。",
@@ -141,7 +143,7 @@ window.__ModuleLoader__.load({
         marketKoKR: "ko-KR —— 韩国",
       },
       en: {
-        description: "Free web search — no API key needed (Bing / DuckDuckGo / AnySearch / Exa / Tavily / Keenable)",
+        description: "Free web search — no API key needed (Bing / DuckDuckGo / AnySearch / Exa / Tavily / Keenable / Firecrawl)",
         unsaved: "unsaved",
         searchEngine: "Search engine",
         visit: "Visit website →",
@@ -151,13 +153,15 @@ window.__ModuleLoader__.load({
         exaPh: (c) => c ? "Exa API key (configured)" : "Exa API key (optional, free without)",
         tavilyPh: (c) => c ? "Tavily API key (configured)" : "Tavily API key (optional, free without)",
         keenablePh: (c) => c ? "Keenable API key (configured)" : "Keenable API key (optional, free without)",
+        firecrawlPh: (c) => c ? "Firecrawl API key (configured)" : "Firecrawl API key (optional, free without)",
+        parallelPh: (c) => c ? "Parallel API key (configured)" : "Parallel API key (required, platform.parallel.ai)",
         perplexityPh: (c) => c ? "Perplexity API key (configured)" : "Perplexity API key (pplx-...)",
         deepseekPh: (c) => c ? "DeepSeek API key (configured)" : "DeepSeek API key (sk-...)",
         keysHint: "Key resolution: .credentials.yaml credential center > here > environment variables. Recommended: store keys in the credential center (same as official LLM providers, one place for all).",
         keyStorage: "Key storage",
         keyStorageCred: "Credential center (recommended)",
         keyStorageSettings: "Settings page (legacy)",
-        keyStorageCredHint: (c) => `Saved to ~/.dsh/.credentials.yaml (highest priority). Currently configured: ${["exa", "tavily", "keenable", "perplexity", "deepseek"].filter((k) => c[k]).map((k) => k.toUpperCase()).join(", ") || "none"}`,
+        keyStorageCredHint: (c) => `Saved to ~/.dsh/.credentials.yaml (highest priority). Currently configured: ${["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "deepseek"].filter((k) => c[k]).map((k) => k.toUpperCase()).join(", ") || "none"}`,
         keyStorageSettingsHint: "Saved to settings.yaml (backward-compatible path; lower priority than the credential center).",
         platformSearch: "Platform search (platform_search tool)",
         platformHint: "Enable platforms for the agent's platform_search tool. Disabled platforms are skipped.",
@@ -206,7 +210,7 @@ window.__ModuleLoader__.load({
     };
     const tt = (lang) => I18N[lang === "en" ? "en" : "zh"];
     // 当前插件版本（与 lib/index.js 的 PLUGIN_VERSION 保持一致）
-    const PLUGIN_VERSION = "0.4.25";
+    const PLUGIN_VERSION = "0.4.26";
     const ENGINES = [
       { id: "ddg", label: "DuckDuckGo · HTML", badge: "FREE", link: "https://duckduckgo.com" },
       { id: "ddg-lite", label: "DuckDuckGo · Lite", badge: "FREE", link: "https://duckduckgo.com" },
@@ -216,6 +220,8 @@ window.__ModuleLoader__.load({
       { id: "exa", label: "Exa", badge: "FREE", link: "https://dashboard.exa.ai/api-keys" },
       { id: "tavily", label: "Tavily", badge: "FREE", link: "https://app.tavily.com/home" },
       { id: "keenable", label: "Keenable", badge: "FREE", link: "https://keenable.ai/login" },
+      { id: "firecrawl", label: "Firecrawl", badge: "FREE", link: "https://www.firecrawl.dev" },
+      { id: "parallel", label: "Parallel", badge: "API KEY", link: "https://platform.parallel.ai" },
       { id: "perplexity", label: "Perplexity", badge: "API KEY", link: "https://www.perplexity.ai/settings/api" },
       { id: "deepseek-official", label: "DeepSeek Official", badge: "API KEY", link: "https://platform.deepseek.com/api_keys" },
     ];
@@ -312,6 +318,8 @@ window.__ModuleLoader__.load({
       const [exaKey, setExaKey] = react.useState("");
       const [tavilyKey, setTavilyKey] = react.useState("");
       const [keenableKey, setKeenableKey] = react.useState("");
+      const [firecrawlKey, setFirecrawlKey] = react.useState("");
+      const [parallelKey, setParallelKey] = react.useState("");
       const [perplexityKey, setPerplexityKey] = react.useState("");
       const [deepseekKey, setDeepseekKey] = react.useState("");
       const [platforms, setPlatforms] = react.useState(["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm"]);
@@ -345,6 +353,8 @@ window.__ModuleLoader__.load({
               setExaKey(v.exaApiKey ?? "");
               setTavilyKey(v.tavilyApiKey ?? "");
               setKeenableKey(v.keenableApiKey ?? "");
+              setFirecrawlKey(v.firecrawlApiKey ?? "");
+              setParallelKey(v.parallelApiKey ?? "");
               setPerplexityKey(v.perplexityApiKey ?? "");
               setDeepseekKey(v.deepseekApiKey ?? "");
               setPlatforms(Array.isArray(v.platforms) && v.platforms.length > 0 ? v.platforms : ["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm"]);
@@ -357,6 +367,8 @@ window.__ModuleLoader__.load({
                   if (path === "exaApiKey") configured.exa = true;
                   if (path === "tavilyApiKey") configured.tavily = true;
                   if (path === "keenableApiKey") configured.keenable = true;
+                  if (path === "firecrawlApiKey") configured.firecrawl = true;
+                  if (path === "parallelApiKey") configured.parallel = true;
                   if (path === "perplexityApiKey") configured.perplexity = true;
                   if (path === "deepseekApiKey") configured.deepseek = true;
                 }
@@ -370,7 +382,7 @@ window.__ModuleLoader__.load({
                 const cred = await bridgeCredentialsStatus();
                 if (cred.ok) {
                   const cc = {};
-                  const map = { exaApiKey: "exa", tavilyApiKey: "tavily", keenableApiKey: "keenable", perplexityApiKey: "perplexity", deepseekApiKey: "deepseek" };
+                  const map = { exaApiKey: "exa", tavilyApiKey: "tavily", keenableApiKey: "keenable", firecrawlApiKey: "firecrawl", parallelApiKey: "parallel", perplexityApiKey: "perplexity", deepseekApiKey: "deepseek" };
                   for (const [k, v] of Object.entries(cred.value.configured ?? {})) {
                     if (map[k]) cc[map[k]] = v;
                   }
@@ -407,6 +419,8 @@ window.__ModuleLoader__.load({
             ["exaApiKey", exaKey],
             ["tavilyApiKey", tavilyKey],
             ["keenableApiKey", keenableKey],
+            ["firecrawlApiKey", firecrawlKey],
+            ["parallelApiKey", parallelKey],
             ["perplexityApiKey", perplexityKey],
             ["deepseekApiKey", deepseekKey],
           ];
@@ -710,6 +724,30 @@ react_jsx_runtime.jsx("div", {
                           setFailed(false);
                         },
                       }),
+                      react_jsx_runtime.jsx("input", {
+                        className: "dshfs-input",
+                        type: "password",
+                        placeholder: t.firecrawlPh(keysConfigured.firecrawl),
+                        value: firecrawlKey,
+                        disabled: !ready || saving,
+                        onChange: (e) => {
+                          setFirecrawlKey(e.target.value);
+                          setDirty(true);
+                          setFailed(false);
+                        },
+                      }),
+                      react_jsx_runtime.jsx("input", {
+                        className: "dshfs-input",
+                        type: "password",
+                        placeholder: t.parallelPh(keysConfigured.parallel),
+                        value: parallelKey,
+                        disabled: !ready || saving,
+                        onChange: (e) => {
+                          setParallelKey(e.target.value);
+                          setDirty(true);
+                          setFailed(false);
+                        },
+                      }),
                       react_jsx_runtime.jsx("input", {
                         className: "dshfs-input",
                         type: "password",

package/lib/index.js

@@ -9,6 +9,8 @@ const DDG_HTML_URL = "https://html.duckduckgo.com/html/";
 const DDG_LITE_URL = "https://lite.duckduckgo.com/lite/";
 const BING_URL = "https://www.bing.com/search";
 const TAVILY_URL = "https://api.tavily.com/search";
+const FIRECRAWL_URL = "https://api.firecrawl.dev/v2/search";
+const PARALLEL_URL = "https://api.parallel.ai/v1/search";
 const KEENABLE_URL = "https://api.keenable.ai/v1/search";
 const KEENABLE_MCP_URL = "https://api.keenable.ai/mcp";
 const USER_AGENT =
@@ -45,10 +47,10 @@ const MARKET_TO_LANG = {
 const FREE_SEARCH_NS = "free-search";
 const BRIDGE_PREFIX = "/api/dsh-free-search-settings";
 const FREE_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch"];
-const ALL_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch", "exa", "tavily", "keenable", "perplexity", "deepseek-official"];
+const ALL_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch", "exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "deepseek-official"];
 
 // 当前插件版本（发布时与 package.json 同步）
-const PLUGIN_VERSION = "0.4.25";
+const PLUGIN_VERSION = "0.4.26";
 // 检查更新的 npm registry 元数据地址（dsh-free-search 是 npmjs 上的公开包）
 const NPM_REGISTRY_URL = "https://registry.npmjs.org/dsh-free-search/latest";
 const PLUGIN_NPM_URL = "https://www.npmjs.com/package/dsh-free-search";
@@ -862,6 +864,132 @@ async function searchTavily(query, maxResults, apiKey, timeRange, signal) {
   return { sources: uniqueSources(sources, maxResults ?? 10), truncated: false };
 }
 
+// Firecrawl: 无 key 走 keyless（官方免 key 匿名额度），有 key 走账号档（Bearer）
+const FIRECRAWL_TBS = { day: "qdr:d", week: "qdr:w", month: "qdr:m", year: "qdr:y" };
+
+// Firecrawl 自定义绝对日期 → Google tbs 语法（cd_min 用 M/D/YYYY）
+function formatFirecrawlDate(date) {
+  const [y, m, d] = String(date).split("-").map((n) => parseInt(n, 10));
+  return `${m}/${d}/${y}`;
+}
+
+async function searchFirecrawl(query, maxResults, apiKey, timeRange, signal) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 20000);
+  const onAbort = () => controller.abort();
+  signal?.addEventListener("abort", onAbort);
+  let response;
+  try {
+    const body = { query, limit: Math.min(Math.max(maxResults ?? 5, 1), 10) };
+    // Firecrawl 时间过滤：tbs 支持固定档（qdr:d/w/m/y）与自定义绝对区间（cdr:1,cd_min:...）
+    if (timeRange) {
+      if (timeRange.after) {
+        body.tbs = `cdr:1,cd_min:${formatFirecrawlDate(timeRange.after)}`;
+      } else if (timeRange.days !== undefined) {
+        const tr = approximateTimeRange(timeRange.days);
+        if (FIRECRAWL_TBS[tr]) body.tbs = FIRECRAWL_TBS[tr];
+      }
+    }
+    response = await fetch(FIRECRAWL_URL, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        accept: "application/json",
+        ...(apiKey ? { authorization: `Bearer ${apiKey}` } : {}),
+      },
+      body: JSON.stringify(body),
+      signal: controller.signal,
+      redirect: "error",
+    });
+  } catch (error) {
+    if (signal?.aborted) throw error;
+    throw new Error(`Firecrawl request failed: ${error?.message ?? String(error)}`);
+  } finally {
+    clearTimeout(timer);
+    signal?.removeEventListener("abort", onAbort);
+  }
+  if (!response.ok) {
+    const detail = await response.text().catch(() => "");
+    if (response.status === 401) {
+      throw new Error("Firecrawl API key is invalid (HTTP 401) - update it in Settings > Plugins > Free Search");
+    }
+    if (response.status === 429) {
+      throw new Error("Firecrawl rate limit exceeded (HTTP 429) - configure FIRECRAWL_API_KEY for higher limits");
+    }
+    throw new Error(`Firecrawl API error (HTTP ${response.status}): ${detail.slice(0, 200)}`);
+  }
+  const data = await response.json();
+  const sources = (data.data?.web ?? [])
+    .filter((r) => r.url)
+    .map((r) => ({
+      url: r.url,
+      ...(r.title ? { title: String(r.title) } : {}),
+      ...(r.description ? { snippet: String(r.description).slice(0, 300) } : {}),
+    }));
+  return { sources: uniqueSources(sources, maxResults ?? 10), truncated: false };
+}
+
+// Parallel: 需 PARALLEL_API_KEY（x-api-key），自然语言 objective + search_queries，返回带 excerpts 的结果
+async function searchParallel(query, maxResults, apiKey, timeRange, signal) {
+  if (!apiKey) throw new Error("Parallel search requires PARALLEL_API_KEY");
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 25000);
+  const onAbort = () => controller.abort();
+  signal?.addEventListener("abort", onAbort);
+  let response;
+  try {
+    const body = {
+      objective: query,
+      search_queries: [query],
+      mode: "fast",
+      advanced_settings: { max_results: Math.min(Math.max(maxResults ?? 5, 1), 20) },
+    };
+    // Parallel 时间过滤：source_policy.after_date（YYYY-MM-DD，精确）
+    if (timeRange) {
+      const after =
+        timeRange.after ??
+        (timeRange.days !== undefined ? isoDaysAgo(timeRange.days).slice(0, 10) : undefined);
+      if (after) body.advanced_settings.source_policy = { after_date: after };
+    }
+    response = await fetch(PARALLEL_URL, {
+      method: "POST",
+      headers: { "x-api-key": apiKey, "content-type": "application/json", accept: "application/json" },
+      body: JSON.stringify(body),
+      signal: controller.signal,
+      redirect: "error",
+    });
+  } catch (error) {
+    if (signal?.aborted) throw error;
+    throw new Error(`Parallel request failed: ${error?.message ?? String(error)}`);
+  } finally {
+    clearTimeout(timer);
+    signal?.removeEventListener("abort", onAbort);
+  }
+  if (!response.ok) {
+    const detail = await response.text().catch(() => "");
+    if (response.status === 401 || response.status === 403) {
+      throw new Error(`Parallel API key is invalid (HTTP ${response.status}) - update it in Settings > Plugins > Free Search`);
+    }
+    if (response.status === 402) {
+      throw new Error(`Parallel quota/billing error (HTTP 402) - check usage/credits at platform.parallel.ai. ${detail.slice(0, 200)}`);
+    }
+    throw new Error(`Parallel API error (HTTP ${response.status}): ${detail.slice(0, 200)}`);
+  }
+  const data = await response.json();
+  const sources = (data.results ?? [])
+    .filter((r) => r.url)
+    .map((r) => {
+      const excerpt = (r.excerpts ?? []).find((e) => String(e).trim().length > 0);
+      return {
+        url: r.url,
+        ...(r.title ? { title: String(r.title) } : {}),
+        ...(excerpt ? { snippet: String(excerpt).slice(0, 300) } : {}),
+        ...(r.publish_date ? { publishedAt: String(r.publish_date) } : {}),
+      };
+    });
+  return { sources: uniqueSources(sources, maxResults ?? 10), truncated: false };
+}
+
 // 把任意天数转成 Keenable 的相对时间格式（12h / Nd / Nmo / Ny）
 function formatKeenableRelative(days) {
   if (days <= 0.5) return "12h";
@@ -1451,6 +1579,8 @@ const KEY_REF_MAP = {
   exaApiKey: "EXA_API_KEY",
   tavilyApiKey: "TAVILY_API_KEY",
   keenableApiKey: "KEENABLE_API_KEY",
+  firecrawlApiKey: "FIRECRAWL_API_KEY",
+  parallelApiKey: "PARALLEL_API_KEY",
   perplexityApiKey: "PERPLEXITY_API_KEY",
   deepseekApiKey: "DEEPSEEK_API_KEY",
 };
@@ -1469,6 +1599,8 @@ const Config = z.object({
   exaApiKey: z.string().role("secret"),
   tavilyApiKey: z.string().role("secret"),
   keenableApiKey: z.string().role("secret"),
+  firecrawlApiKey: z.string().role("secret"),
+  parallelApiKey: z.string().role("secret"),
   perplexityApiKey: z.string().role("secret"),
   deepseekApiKey: z.string().role("secret"),
 });
@@ -1543,10 +1675,10 @@ function apply(ctx, config) {
       }
 
       // 统一引擎链：首选优先，然后其他付费引擎（有 key 的优先尝试），最后免费引擎
-      const paidEngines = ["exa", "tavily", "keenable", "perplexity", "deepseek-official"];
+      const paidEngines = ["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "deepseek-official"];
       const freeEngines = ["bing", "anysearch", "ddg", "ddg-lite", "searxng"];
-      // 支持 time_range 过滤的引擎：tavily / exa / keenable / searxng / ddg / ddg-lite
-      const timeEngines = ["tavily", "exa", "keenable", "searxng", "ddg", "ddg-lite"];
+      // 支持 time_range 过滤的引擎：tavily / exa / keenable / firecrawl / parallel / searxng / ddg / ddg-lite
+      const timeEngines = ["tavily", "exa", "keenable", "firecrawl", "parallel", "searxng", "ddg", "ddg-lite"];
       let chain;
       // 首选引擎被跳过的原因（用于生成准确的 Note，避免误导 agent/用户）：
       //  - "time-filter"：带 timeRange 且首选引擎不支持时间过滤（根本没尝试）
@@ -1611,6 +1743,20 @@ function apply(ctx, config) {
             // keenable：有 key 走 REST，无 key 走 keyless MCP（免费）
             const key = await resolveApiKey("KEENABLE_API_KEY", "keenableApiKey");
             result = await searchKeenable(request.query, request.maxResults, key, timeRange, effSignal);
+          } else if (engine === "firecrawl") {
+            // firecrawl：无 key 也可用（官方免 key 匿名额度），有 key 走账号档（更高限额）
+            const key = await resolveApiKey("FIRECRAWL_API_KEY", "firecrawlApiKey");
+            result = await searchFirecrawl(request.query, request.maxResults, key, timeRange, effSignal);
+          } else if (engine === "parallel") {
+            // parallel：必须配置 PARALLEL_API_KEY（无 key 跳过，同 perplexity）
+            const key = await resolveApiKey("PARALLEL_API_KEY", "parallelApiKey");
+            if (!key) {
+              lastError = new Error("Parallel requires PARALLEL_API_KEY");
+              if (engine === preferred) preferredFailure = "PARALLEL_API_KEY is not configured";
+              logger.warn(`free-search: engine "${engine}" skipped (no key), trying next engine`);
+              continue; // 无 key 跳过
+            }
+            result = await searchParallel(request.query, request.maxResults, key, timeRange, effSignal);
           } else if (engine === "perplexity") {
             const key = await resolveApiKey("PERPLEXITY_API_KEY", "perplexityApiKey");
             if (!key) {
@@ -1768,6 +1914,15 @@ function apply(ctx, config) {
           const key = await resolveApiKey("KEENABLE_API_KEY", "keenableApiKey");
           return await searchKeenable(q, 2, key, tr);
         }
+        case "firecrawl": {
+          const key = await resolveApiKey("FIRECRAWL_API_KEY", "firecrawlApiKey");
+          return await searchFirecrawl(q, 2, key, tr);
+        }
+        case "parallel": {
+          const key = await resolveApiKey("PARALLEL_API_KEY", "parallelApiKey");
+          if (!key) return { ok: false, error: "PARALLEL_API_KEY not configured" };
+          return await searchParallel(q, 2, key, tr);
+        }
         case "perplexity": {
           const key = await resolveApiKey("PERPLEXITY_API_KEY", "perplexityApiKey");
           if (!key) return { ok: false, error: "PERPLEXITY_API_KEY not configured" };
@@ -1813,7 +1968,7 @@ function apply(ctx, config) {
           parameters: {
             engines: {
               type: "array",
-              description: "Which engines to test (default: all). Options: ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, perplexity, deepseek-official.",
+              description: "Which engines to test (default: all). Options: ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, firecrawl, parallel, perplexity, deepseek-official.",
               items: { type: "string" },
             },
             query: {
@@ -1997,7 +2152,7 @@ function apply(ctx, config) {
             },
             engine: {
               type: "string",
-              description: "Optional specific engine to try first: ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, perplexity, deepseek-official.",
+              description: "Optional specific engine to try first: ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, firecrawl, parallel, perplexity, deepseek-official.",
             },
           },
           output: {
@@ -2094,10 +2249,12 @@ function apply(ctx, config) {
           "- exa - FREE keyless (MCP) or EXA_API_KEY for higher limits",
           "- tavily - FREE keyless or TAVILY_API_KEY for higher limits",
           "- keenable - FREE keyless (MCP) or KEENABLE_API_KEY for higher limits",
+          "- firecrawl - FREE keyless or FIRECRAWL_API_KEY for higher limits",
+          "- parallel - requires PARALLEL_API_KEY",
           "- perplexity - requires PERPLEXITY_API_KEY",
           "- deepseek-official - requires DEEPSEEK_API_KEY",
           "",
-          "IMPORTANT: If the configured engine fails (missing key, invalid key, 401, rate limit, or network error), web_search automatically tries other engines in this order: (1) the configured engine first, (2) then other engines with API keys configured (exa/tavily/keenable work keyless too, so they are tried even without a key), (3) then the remaining free engines (Bing, AnySearch, DuckDuckGo, SearXNG). This applies to ALL engines - paid or free. The results include a note showing which engine was actually used and why the preferred one was skipped. Understand the two note forms: (a) 'Note: X does not support time filtering (timeRange=...), using Y.' means X cannot filter by time so it was skipped BEFORE any attempt (X did NOT fail); (b) 'Note: X unavailable or failed (reason), using Y.' means X was actually tried but failed (missing key / invalid key / 401 / rate limit / network / 0 results). Never tell the user search is unavailable - it always falls back.",
+          "IMPORTANT: If the configured engine fails (missing key, invalid key, 401, rate limit, or network error), web_search automatically tries other engines in this order: (1) the configured engine first, (2) then other engines with API keys configured (exa/tavily/keenable/firecrawl work keyless too, so they are tried even without a key), (3) then the remaining free engines (Bing, AnySearch, DuckDuckGo, SearXNG). This applies to ALL engines - paid or free. The results include a note showing which engine was actually used and why the preferred one was skipped. Understand the two note forms: (a) 'Note: X does not support time filtering (timeRange=...), using Y.' means X cannot filter by time so it was skipped BEFORE any attempt (X did NOT fail); (b) 'Note: X unavailable or failed (reason), using Y.' means X was actually tried but failed (missing key / invalid key / 401 / rate limit / network / 0 results). Never tell the user search is unavailable - it always falls back.",
           "",
           "Use the free_search_test tool to test which engines actually work right now.",
           "",
@@ -2127,10 +2284,12 @@ export {
   DDG_HTML_URL,
   DDG_LITE_URL,
   EXA_MCP_URL,
+  FIRECRAWL_URL,
   FREE_ENGINES,
   FREE_SEARCH_NS,
   KEENABLE_MCP_URL,
   KEENABLE_URL,
+  PARALLEL_URL,
   PLATFORMS,
   SEARXNG_INSTANCES,
   TAVILY_URL,
@@ -2149,12 +2308,14 @@ export {
   searchDdgLite,
   searchExa,
   searchExaMCP,
+  searchFirecrawl,
   searchGithub,
   searchHackerNews,
   searchKeenable,
   searchKeenableMCP,
   searchKeenableREST,
   searchNpm,
+  searchParallel,
   searchPerplexity,
   searchPlatform,
   searchReddit,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-free-search",
-  "version": "0.4.25",
-  "description": "Free web search for DeepSeek Harness: 10 engines (Bing/DuckDuckGo/AnySearch/SearXNG/Exa/Tavily/Keenable keyless) + time filtering + platform search + web_fetch, with web settings UI.",
+  "version": "0.4.26",
+  "description": "Free web search for DeepSeek Harness: 12 engines (Bing/DuckDuckGo/AnySearch/SearXNG/Exa/Tavily/Keenable/Firecrawl keyless; Parallel/Perplexity/DeepSeek with key) + time filtering + platform search + web_fetch, with web settings UI.",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -24,6 +24,8 @@
     "tavily",
     "exa",
     "keenable",
+    "firecrawl",
+    "parallel",
     "perplexity",
     "search",
     "free"