# @crvouga/mockingbird-service-tavily 中文文档

规范地址：https://npmcn.com/package/%40crvouga/mockingbird-service-tavily/

版本：1\.10\.0
npm 元数据更新时间：2026-11-11T02:39:42.894Z
中文译文更新时间：2026-11-11T11:05:23.409Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40crvouga/mockingbird-service-tavily
原文对照：https://npmcn.com/package/%40crvouga/mockingbird-service-tavily/?lang=original
项目主页：https://github.com/crvouga/mockingbird/tree/main/packages/service/tavily#readme
源码仓库：https://github.com/crvouga/mockingbird

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.2 MB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-10-05T09:32:01.444Z
- 最新版本发布：2026-11-11T02:39:42.573Z
- 近 30 天下载量：2198（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

被拼写为"Tavily"搜索和取出,而无需网络爬行.

## 安装

```sh
npm install @crvouga/mockingbird-service-tavily
```

也可以使用：`pnpm add @crvouga/mockingbird-service-tavily`、`yarn add @crvouga/mockingbird-service-tavily`、`bun add @crvouga/mockingbird-service-tavily`

## README

# @crvouga/ mockingbird-service-tavily (中文(简体) )

> 本地模拟器。 真正的API合同. 部分 [嘲笑鸟](https://github.com/crvouga/mockingbird)。 。 。 .

WIP脚本为Tavily搜索和取出. 没有获取公共 URL 。 合同参考文献: [搜索](https://docs.tavily.com/documentation/api-reference/endpoint/search), (中文(简体) ), [摘录](https://docs.tavily.com/documentation/api-reference/endpoint/extract) 和准确的 [塔维利-平通0.7.17](https://pypi.org/project/tavily-python/0.7.17/) Async Tavily Client source. (原始内容存档于2018-10-29).

## 安装

`bun add @crvouga/mockingbird-service-tavily`

## 使用量

```ts
import { tavily } from "@tavily/core"
import { createServer } from "@crvouga/mockingbird-service-tavily/server"

// Test setup: script the results for one query.
const server = await createServer({
  searches: [{ query: "fixture", results: [
    { title: "Example", url: "https://example.test", content: "Synthetic", score: 0.9 },
  ] }],
})

// The Tavily SDK your application already uses. Only its base URL changes.
const client = tavily({ apiKey: "mock_tavily_key", apiBaseURL: server.url })
const { results } = await client.search("fixture")
console.log(results[0]?.title, results[0]?.url) // Example https://example.test

await server.close()
```

CLI: 爱丽丝 `mockingbird-tavily serve --port 12130`配置 SDK 的基础 URL(`apiBaseURL` 内 `@tavily/core`, (中文(简体) ), `api_base_url` 在tavily-python中);两个SDK都没有要求的全球终点 环境变量。 如果你的应用读取TAVILY API KEY, 设置在本地测试中仿真 tavily key。 HTTP 认证为 Bearer , 与 Async Tavily Client 0.7.17,不是 JSON api key 身体场.

POST / 搜索匹配查询设置、 返回按固定顺序排序的点击并尊重最大结果 (0–20,默认为10). 接受主题、 搜索、 深度和时间范围; 可选的固定匹配 字段在不运行排名/日期-过滤模式的情况下选择变量。 更具体匹配对象取胜. 包括真/基本/先进答案。 缺少查询返回空结果 . POST / extract 接受一个URL或最多20个URL;成功的内容和每URL出错仍然分开. 未标注的 URL 接收到合成检索失败, 绝不是网络请求 .

## 控件

选项搜索、提取和 apiKeys 种子 SQLite 收藏,并带有导出搜索脚本, 提取和ApiKey记录。 POST/ admin/状态/搜索为{id, value}; 提取记录与其值相匹配.url(使用任何简单的id;apiKeys ids必须等于合成密钥). 默认密钥: 模拟 tavily key. 关键状态配额为429;计划-限制为432;支付-限制为433. 无效/ 丢失密钥返回 401 并带有细节. error 。 没有真正的证书属于固定状态. 搜索结果可能包括脚本解答和应答 时间(数字秒,默认为零).

标准/ admin提供状态,重置,时光线,时钟,日记,度量衡,健康和UI. 命名空间: x- mocking bird-namespace, / admin/ns/name 和 熊克证书通过绘图 PUT / admin/证书. 期刊只包含元数据,不包含查询文本,内容或权限. 没有释放出网络用户 。 预设 : 无效 key, 配额 超额, 计划 限额, 支付 限额, 内部 error, 超时( 一秒长), 连接 滴放 。 一般断层也支持 决断相生. 该时钟可供消费者工作流程使用;不模拟配额调度器.

## 核查

`bun test` 运行接受、独立的 OpenAPI 自我均等和差异检测. `bun scripts/sdk.ts` 使用 uv 运行精确的tavilly-python 0.7.17 的模拟器: AsyncTavily Client 搜索/ 摘录, 无效的APIKeyError, 用法Limit ExcessedError, 紫禁 Error 和超时 Error . 没有使用真正的 API 键或 craw . `bun run parity` 需要TAVILY API KEY,只发送无效的 缺少- query 请求比较验证状态, 绝不进行搜索或提取。 证书缺失 2. SDK测试是相容性证据,而不是现场供应商搜索结果对等.

## 故意不模拟

真实的网络爬行/搜索/排名,生成答案,计费或定额核算,图像检索, 日期窗口过滤, 超出明确的脚本选择器, 自动参数, 高级提取 格式化, craw/map/研究端点和精确的供应商验证出错通俗. 空固定线 查询和未种子 URL 失败是本地测试控制,而不是对活搜索结果的预测. 采掘命令遵循输入命令;Tavily不保证输入命令。 响应( T) 遵循已公布的字段类型;文档示例字符串不是线型的保证.

## API 密码

主运行时间导出:TavilyAPI,TAVILY NAMESPACE,创建运行时间,TAVILY PRESETS,文档,, 操作Ids,支持操作Ids. 类型:搜索Hit,搜索脚本,提取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取. 服务器项:创建Server,DEFAULT PORT,服务目标;类型为TavilyServer可选. CLI 条目运行,不输出运行时间值.

## 常见问题

### @crvouga/mockingbird-service-tavily 是什么？

被拼写为"Tavily"搜索和取出,而无需网络爬行\.

### 如何安装 @crvouga/mockingbird-service-tavily？

在项目目录运行 npm install @crvouga/mockingbird-service-tavily，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mockingbird-tavily，可以用 npx mockingbird-tavily 直接运行。

### @crvouga/mockingbird-service-tavily 支持 TypeScript 吗？

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

### @crvouga/mockingbird-service-tavily 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @crvouga/mockingbird-service-tavily 可以商用吗？

@crvouga/mockingbird-service-tavily 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @crvouga/mockingbird-service-tavily 的下载量有多少？

根据 npm 官方下载统计，@crvouga/mockingbird-service-tavily 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,198 次，日均约 73 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @crvouga/mockingbird-service-tavily 还在维护吗？

最新版本 1\.10\.0 发布于 2026/11/11（今天）；至今共发布 17 个版本，其中过去 12 个月发布了 17 个；首次发布于 2026/10/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。