用途:让 AI 智能体通过 ClawLink 托管方式调用 Tavily,完成网页搜索、抓取与内容提取等任务。连接一次后,智能体即可读取并操作 Tavily。适用于任何能运行 shell 命令的智能体,如 Claude Code、Cursor、Codex、Cline 等。
主要能力(可用动作):tavily_search 执行网页搜索,可控制搜索深度、内容类型、结果数量和域名过滤;tavily_extract 从指定 URL 提取并解析干净的网页内容,可选图片提取和基于查询相关性的内容重排;tavily_crawl 基于图结构智能爬取网站,支持并行路径探索、深度与广度控制、域名过滤及自然语言指令引导;tavily_map 映射网站并发现其页面,返回结构化 URL 列表而不提取完整内容;tavily_get_usage 获取 API Key 与账户用量统计,查看额度消耗、限制及各端点用量。
使用方式:先执行一次 npx @useclawlink/cli login 打开浏览器授权(生成并存储密钥),再执行 npx @useclawlink/cli connect tavily 授权 Tavily。凭据存储在 ~/.clawlink/credentials.json,无需创建或粘贴 API Key。之后用 npx @useclawlink/cli actions tavily "<要做的操作>" 查找动作,用 npx @useclawlink/cli describe tavily <action-id> 查看输入,用 npx @useclawlink/cli run tavily <action-id> --input '<json>' 执行。应先做读取操作,任何写入操作前需与用户确认。
限制与注意事项:使用 tavily_search 需要有效的 Tavily 连接,401 表示认证失败;速率限制约 2 请求/秒,遇到 HTTP 429 应使用指数退避重试;搜索结果嵌套在 response_data.results 下,并非扁平列表。Tavily 本身无需 API Key,ClawLink 持有 OAuth 令牌,智能体仅持有用户的 ClawLink 凭据。若未连接或访问过期,重新运行 npx @useclawlink/cli connect tavily。动作列表为快照,实际可用动作以 npx @useclawlink/cli actions tavily 为准。其他功能、收费与价格信息暂未提供。