后端与接口
需要高质量结构化联网搜索并支持域名、时间、主题过滤时,用…
当需要当前信息、新闻、事实核查或可过滤的结构化网络搜索结果时,调用 Tavily API 执行联网搜索。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
需要高质量结构化联网搜索并支持域名、时间特定
解决思路
- 执行简单搜索:deno run --allow-env --allow-net=api.tavily.com scripts/search.ts "your search query"。
- 需要 AI 生成答案摘要时,在命令中加入 --answer,例如:deno run --allow-env --allow-net=api.tavily.com scripts/search.ts "React 19 new features" --answer。
- 脚本调用格式为:deno run --allow-env --allow-net=api.tavily.com scripts/search.ts [options] "query"。
- 使用 --answer 在结果中包含 AI 生成的答案摘要(默认 false)。
- 使用 --depth <level> 设置搜索深度:basic 或 advanced(默认 basic)。
- 使用 --results <n> 设置返回结果数量(默认 5)。
- 使用 --topic <type> 设置主题类型:general、news 或 finance(默认 general)。
- 使用 --time <range> 设置时间过滤:day、week、month 或 year(默认 none)。
- 使用 --include <domains> 只包含指定域名,多个域名用逗号分隔(默认 none)。
- 使用 --exclude <domains> 排除指定域名,多个域名用逗号分隔(默认 none)。
- 使用 --raw 在结果中包含原始页面内容(默认 false)。
- 使用 --json 以 JSON 输出,便于程序化使用(默认 false)。
- 使用 --help 显示帮助信息。
- 选择 topic 类型:general 为跨内容类型的广泛网页搜索;news 优先新闻文章和当前事件;finance 聚焦金融信息和市场数据。
- 选择搜索深度:basic 快速搜索,适合大多数查询;advanced 更深入、更全面,但更慢且 API 成本更高。
- 按时间范围过滤结果:day 为最近 24 小时;week 为最近 7 天;month 为最近 30 天;year 为最近 365 天。
- 进行域名过滤:只搜索文档站点,例如 scripts/search.ts "React hooks" --include docs.react.dev,developer.mozilla.org。
- 进行域名过滤:排除社交媒体,例如 scripts/search.ts "AI news" --exclude twitter.com,reddit.com。
- 默认输出为人类可读格式,包含搜索词、结果数量、耗时、AI Answer、结果标题、URL、摘要和 Score。
- 需要程序化解析时使用 --json,输出包含 query、results、answer、response_time;results 中每项包含 title、url、content、score、published_date。
- 解析结果字段:title 为页面标题;url 为来源 URL;content 为相关摘录;score 为相关性评分(0-1,越高越好);published_date 为发布日期(若可用);raw_content 为完整页面内容(仅在使用 --raw 时出现)。
- 当前事件搜索示例:scripts/search.ts "OpenAI GPT-5 announcement" --topic news --time week --answer。
- 文档查询示例:scripts/search.ts "Deno deploy edge functions tutorial" --depth advanced --results 10。
- 事实核验示例:scripts/search.ts "world population 2024" --include un.org,worldbank.org,census.gov --json。
- 金融研究示例:scripts/search.ts "NVIDIA stock analysis 2024" --topic finance --answer。
- 若出现 "TAVILY_API_KEY environment variable is not set":从 https://tavily.com 获取 API key,执行 export TAVILY_API_KEY="your-api-key-here",或用内联方式运行:TAVILY_API_KEY="your-key" deno run --allow-env --allow-net=api.tavily.com scripts/search.ts "query"。
- 若出现 "Invalid Tavily API key" 或 401:验证 API key 正确且没有多余空格;检查 API key 是否过期;验证 Tavily 账户是否活跃。
- 若出现 "Tavily API rate limit exceeded" 或 429:等待片刻后重试;降低请求频率;考虑升级 Tavily 计划以提高限额。
- 若无结果返回:尝试更宽泛的搜索词;移除可能过严的域名过滤;检查该主题是否在线存在;对困难查询尝试 --depth advanced。
适用边界 · 注意事项
- 信息已在知识库中且无需验证,或询问不会变化的历史事实时,不要使用。
- 处理本地文件或代码,或已有更具体的技能(如文档查找)时,不要使用。
- 需要访问付费墙或登录后内容,或要求不受 Tavily 索引覆盖、抓取频率、最大查询长度/结果数量和 API 速率限制影响时,不要使用。