@crvouga/ mockingbird-service-tavily (中文(简体) )
本地模拟器。 真正的API合同. 部分 嘲笑鸟。 。 。 .
WIP脚本为Tavily搜索和取出. 没有获取公共 URL 。 合同参考文献: 搜索, (中文(简体) ), 摘录 和准确的 塔维利-平通0.7.17 Async Tavily Client source. (原始内容存档于2018-10-29).
安装
bun add @crvouga/mockingbird-service-tavily
使用量
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 条目运行,不输出运行时间值.