tavily-automation

Tavily Automation - 通过 Rube MCP 自动化 Tavily 搜索任务

技能概述

Tavily Automation 是一个通过 Rube MCP 集成 Composio Tavily 工具套件的技能，帮助你在 Claude Code 等 MCP 客户端中动态发现和执行 Tavily 搜索 API 操作，无需手动管理 API 密钥或硬编码工具模式。

适用场景

1. AI Agent 搜索功能集成

当你的 AI 应用需要实时搜索能力时，通过此技能可以动态调用 Tavily 的各类搜索工具（普通搜索、深度搜索、学术搜索等），工具模式自动更新，无需维护 API 调用代码。

2. Claude Code 搜索任务自动化

在 Claude Code 会话中需要执行网络搜索、信息检索等任务时，使用 RUBE_MULTI_EXECUTE_TOOL 可以一次性编排多个 Tavily 工具调用，自动处理会话管理和模式验证。

3. 批量搜索与数据处理

需要对多个查询进行批量搜索、对比或聚合分析时，配合 RUBE_REMOTE_WORKBENCH 可以执行 run_composio_tool() 进行批量操作，并自动处理分页结果。

核心功能

动态工具发现

通过 RUBE_SEARCH_TOOLS 实时获取 Tavily 工具的当前模式、输入参数、推荐执行计划和已知陷阱，避免因工具更新导致的调用失败。工具模式会随 Composio 平台变化，每次执行前先搜索可确保兼容性。

连接管理自动化

使用 RUBE_MANAGE_CONNECTIONS 验证 Tavily 连接状态，如果未激活会自动返回认证链接。通过 Rube MCP 添加 https://rube.app/mcp 端点即可开始使用，无需在代码中存储 API 密钥。

灵活的工具执行

支持单工具执行（RUBE_MULTI_EXECUTE_TOOL）、远程工作台批量操作（RUBE_REMOTE_WORKBENCH）和完整模式获取（RUBE_GET_TOOL_SCHEMAS）。会话 ID 可在单个工作流中复用，跨工作流时生成新 ID 以保持隔离。

常见问题

什么是 Rube MCP，为什么需要它？

Rube MCP (rube.app/mcp) 是一个 MCP 服务器端点，提供了对 Composio 工具生态的统一访问接口。通过 Rube MCP，你可以使用 RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL 等工具动态管理和执行各类第三方工具（包括 Tavily）。使用 Rube MCP 无需在你的代码中直接管理 API 密钥，所有认证通过连接管理流程处理。

为什么必须先调用 RUBE_SEARCH_TOOLS？

Composio 平台的工具模式会随时更新，硬编码工具 slug 或参数结构会导致调用失败。RUBE_SEARCH_TOOLS 返回当前的工具列表、输入模式、推荐执行计划和已知陷阱，确保你的调用与平台状态一致。这是"Always search tools first for current schemas"原则的核心。

如何验证 Tavily 连接是否正常？

调用 RUBE_MANAGE_CONNECTIONS，传入 toolkits: ["tavily"] 和你的 session_id。如果返回的连接状态不是 ACTIVE，需要按照返回的 auth_link 完成认证流程。认证完成后再次调用确认状态为 ACTIVE，才能开始执行工具调用。建议在每次工作流开始前检查连接状态。