📦 Tavily Search Native Node — Tavily 搜索原生节点

Tavily 搜索（Native Node） 最小化、可审计的 Tavily 网页搜索。Native Node.js，无依赖，仅两个文件。足够小，可以在几分钟内进行审计。 何时使用 触发短语：“搜索”，“查找”，“最新”，“最近新闻”，“研究”，“比较”，“当前信息”。 使用此功能时： 用户需要超出模型训练截止日期的信息 当前事件、新闻、市场数据、价格、天气背景、最近发布的内容 需要用户可以验证的引用 何时不使用 用户提供特定的 URL 来读取 → 使用 web_fetch 工具代替 问题可以从训练知识中回答（基本事实、定义） 隐私敏感查询（搜索传输到 api.tavily.com） 想要缓存、原始全页内容、提取端点或使用统计？使用 tavily-search-pro-native-node 代替。 如何运行 脚本位于 scripts/search.mjs。 基本搜索：node "/scripts/search.mjs" "你的查询内容" 新闻搜索（默认过去 ~7 天，新鲜度偏好）：node "/scripts/search.mjs" --topic news "软件发布说明" 更深入的研究（每次调用成本 2 积分）：node "/scripts/search.mjs" --depth advanced "AI 代理市场分析 2026" （其中 通常是 workspace/skills/tavily-search-native-node/。） 所有标志 标志 值 默认 目的 --topic general | news general 新闻偏好新文章 --depth basic | advanced basic 高级 = 更深入的分析，2 倍积分 --max 1-20 5 返回结果的数量 --days 整数 7（仅新闻） 新闻主题的年龄窗口 --include 逗号列表（无） 仅这些域，例如 github.com、stackoverflow.com --exclude 逗号列表（无） 跳过这些域 --json 标志 关闭 返回原始 JSON 而不是格式化输出 示例 # 比较框架，仅 GitHub+SO node "./scripts/search.mjs" --include "github.com,stackoverflow.com" "React Native vs Flutter 2026" # 最近新闻，10 个结果，过去 14 天 node "./scripts/search.mjs" --topic news --max 10 --days 14 "小企业 AI 采用" # 使用 JSON 进行程序化使用的深入研究 node "./scripts/search.mjs" --depth advanced --json "小企业 VPN 选项" 输出格式 默认为人类可读格式： 顶部标题，包含查询、主题、深度、结果计数 Tavily 合成的答案（简要摘要） 编号结果列表 — 标题、URL、日期（新闻）、片段 底部行，包含计时信息 默认为 ASCII 安全标点符号，以便于 Windows 重定向、日志和电子邮件正文 JSON 模式（--json）将完整的 Tavily 响应转储为原始格式，适用于管道到后续脚本。 凭证 需要在进程环境中设置 TAVILY_API_KEY。如果未设置，脚本将退出并显示清晰的错误消息。 获取密钥：https://app.tavily.com — 免费层每月 1,000 次搜索。 成本和速率限制 --depth 基本 = 每次搜索 1 积分 --depth 高级 = 每次搜索 2 积分 免费层：每月 1000 积分 Tavily 免费层的速率限制为每分钟；在 429 时，脚本会显示 Retry-After 错误。 代理使用模式 调用此技能时，首选批处理： 针对每个主题运行一个精心设计的搜索，而不是多个狭窄的搜索 除非用户明确要求深入探索，否则首选基本深度 在适当时使用 --include 来限定受信任的域 引用您引用的来源，以便用户可以验证 故障排除 "TAVILY_API_KEY 未设置" -> 在进程环境中导出环境变量 HTTP 401 -> 密钥无效或已撤销；在 app.tavily.com 重新生成 HTTP 429 -> 速率限制；等待，重试，间隔时间更长（脚本显示 Retry-After） HTTP 432 -> 每月积分上限；检查使用情况仪表板 网络超时 -> 暂时；重试一次 此技能的功能 从进程环境中读取 Tavily API 密钥 仅向 https://api.tavily.com/search 发送 POST 请求 将格式化结果打印到 stdout 此技能不执行的操作 不写入任何文件 不进行任何网络调用，除非向 api.tavily.com 不修改任何配置 不自动更新 不缓存（请参阅 Pro 版本以进行缓存） 发布说明 此技能故意保持小巧和无依赖，以便于审计。在发布或更新之前，运行 node --check scripts/search.mjs、node scripts/search.mjs --help 和一个无密钥的冒烟测试，使用临时主目录来验证没有使用 API 积分的情况下清晰的凭证错误。