@haatlabs-core/provider-image-search

中文文档
0.18.5发布于 2026/11/14Apache-2.0TypeScriptESM + CJS近 30 天下载 4657

通过 SearXNG 、 Brave 或 SerpApi 在一个SearchProvider 后面进行图像和网络搜索 .

中文使用文档
文档目录8 节
  1. 安装
  2. 它会做什么
  3. 选项
  4. 错误
  5. 门户和最后期限
  6. 固定设备
  7. 测试
  8. 托管服务

@haatlabs-core/ 提供者- 图像搜索

@haatlabs-core/provider-image-search/contracts (0.12.1) (中文(简体) ) IMAGE_SEARCH_ERRORS, (中文(简体) ), SearchErrorCode, (中文(简体) ), createSearchError 编辑 SearchError 类型,没有节点 : 一个项目的合同,它的页面装入, 从这里导入, 永远不根, 这是为节点.

安装

pnpm add @haatlabs-core/provider-image-search

它会做什么

通过SearXNG(直接或通过服务网关),勇于或 SerpApi,并通过 SearXNG 搜索网页,后面一个 SearchProvider 接口. createImageSearchProvider(config, deps) 财务报告和审定财务报表 createWebSearchProvider 将提供者包入 限速门、断路器和重试(protect@haatlabs-core/professors),并带有 deps.cache 在一个 cachedCall 门外的地层,所以一个命中 花费没有符号.

选项

config数字 : provider (单位:千美元)'searxng' | 'brave' | 'serpapi', (中文(简体) ), timeoutMs,而供应商的 searxngBaseUrl 财务报告和审定财务报表 gatewayKey, (中文(简体) ), braveApiKey 或者说 serpApiKey (名称没有钥匙,它 施工失败). deps数字 : fetch, (中文(简体) ), limiter 财务报告和审定财务报表 rateLimit (大门), sleep, (中文(简体) ), now,以及 cache (单位:千美元){ store, ttlMs, onEvent }页:1 null 存储每次计算。 每个 搜索选中 SearchOptions数字 : limit, (中文(简体) ), safeSearch (0-2), (单位:千美元), language, (中文(简体) ), signal, (中文(简体) ), call。 。 。 .

错误

SEARCH_PROVIDER_ERROR (503) 有一条信息说失败了:429,5xx,没有答案,一个时间 一个不是JSON的身体是短暂的 retryAfterMs 从复试后, 秒 或日期,最多5分钟); 401或403是永久的,指定要检查的内容; 任何其他 地位是永久的。 SerpApi的"Google没有返回任何结果"是没有结果的;任何其他 SerpApi错误是一个瞬态"SerpApi无法运行搜索",它的文本没有传递. A 类 电话员的流产被重新推为他们的。 查询或限制差是核心 VALIDATION_FAILED。 。 。 . 项目分布 IMAGE_SEARCH_ERRORS 输入 defineErrors。 。 。 .

门户和最后期限

call (级别、优先权、, deadlineMs进入网关 gatewayKey中,第4级 没有背景。 每个供应商的时间限制是 timeoutMs,或 call.deadlineMs 在那更早的时候localTimeoutMs)),而网关被赋予了这个限度,永远不再存在. 期限是每次尝试的:重试再次开始;通过 signal 对于硬性限制 整个搜索。 通过网关,拒绝就意味着 UpstreamStatusError 联合国 原因 : isGatewayRefusal(error) 对401和403的网关来说是真实的 只有它自己的 bad_request 400是一个合同错误.

与 deps.cache,查找已运行的相同搜索等待答案 (cachedCall的单飞),再次寻找最高 waitMs (10 s) 在搜索之前 自己来 等待不会结束在呼叫者身上 signal: 一旦中止搜索答案 结束了,所以 waitMs {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}就那么迟了 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}我还没说.

固定设备

@haatlabs-core/provider-image-search/fixtures数字 : searchFixtures.searxngImages 记录于 (一) 安全XNG; braveImages 财务报告和审定财务报表 serpApiImages 以 Brave 和 SerpApi 的形状写 文档,没有记录,直到所有者用试用钥匙记录它们.

测试

pnpm --filter @haatlabs-core/provider-image-search test (单位,固定装置上)和 test:int (集装箱中真正的SearXNG;需要多克克). 现场测试,有老板的 BRAVE_API_KEY 财务报告和审定财务报表 SERPAPI_API_KEY运行 pnpm exec vitest run --config vitest.real.config.ts 并且没有钥匙就跳过.

托管服务

没有自己的搜索引擎, provider: 'haatlabs' 与 haatlabsApiKey (你的电话) RapidAPI密钥)通过RapidAPI上的Haatlabs API搜索. 拒绝是 SEARCH_PROVIDER_ERROR,与 API 一样短暂,与 API 错误 (单位:千美元)SERVICE_QUOTA_EXCEEDED, (中文(简体) ), SERVICE_KEY_REFUSED作为它的事业。 见 @haatlabs-core/services 财务报告和审定财务报表 https://haatlabs.shop/docs/服务/

版本与发布记录

@haatlabs-core/provider-image-search 共发布 27 个版本,首次发布于 2026/10/23;过去 12 个月发布了 27 个版本。

版本发布日期距今
0.18.5latest2026/11/144 天前
0.18.42026/11/134 天前
0.18.32026/11/134 天前
0.18.22026/11/134 天前
0.18.12026/11/134 天前
0.18.02026/11/134 天前

关于 @haatlabs-core/provider-image-search 的常见问题

@haatlabs-core/provider-image-search 是什么?

通过 SearXNG 、 Brave 或 SerpApi 在一个SearchProvider 后面进行图像和网络搜索 .

如何安装 @haatlabs-core/provider-image-search?

在项目目录运行 npm install @haatlabs-core/provider-image-search,或使用 pnpm add / yarn add / bun add。

@haatlabs-core/provider-image-search 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@haatlabs-core/provider-image-search 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@haatlabs-core/provider-image-search 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@haatlabs-core/provider-image-search 可以商用吗?

@haatlabs-core/provider-image-search 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@haatlabs-core/provider-image-search 的下载量有多少?

根据 npm 官方下载统计,@haatlabs-core/provider-image-search 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,657 次,日均约 155 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@haatlabs-core/provider-image-search 还在维护吗?

最新版本 0.18.5 发布于 2026/11/14(4 天前);至今共发布 27 个版本,其中过去 12 个月发布了 27 个;首次发布于 2026/10/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。