agentql-automation

AgentQL 自动化技能 - 通过 Rube MCP 实现 AgentQL 任务自动化

技能概述

AgentQL Automation 是一个通过 Composio 的 Rube MCP 服务器实现 AgentQL 任务自动化的 Claude 技能，无需 API 密钥即可完成网页查询、数据采集和批量操作。

适用场景

1. 网页数据自动化采集

当需要从多个网页批量提取结构化数据时，使用本技能可以通过 AgentQL 的自然语言查询方式快速获取目标信息，无需编写复杂的选择器或爬虫代码。

2. 网页交互任务自动化

对于需要模拟用户操作网页的场景（如填写表单、点击按钮、滚动页面），本技能提供了完整的工具链支持，可用于自动化测试、数据录入等工作。

3. 多会话批量操作

当需要同时管理多个 AgentQL 任务或工作流时，本技能的会话复用和多工具执行功能可以显著提升效率，支持分页数据处理和复杂工作流编排。

核心功能

1. 智能工具发现

通过 RUBE_SEARCH_TOOLS 自动获取当前可用的 AgentQL 工具列表和最新的输入 schema，避免硬编码工具名称导致的不兼容问题。系统会返回推荐执行计划和已知陷阱，帮助正确使用工具。

2. 连接管理与验证

使用 RUBE_MANAGE_CONNECTIONS 检查 AgentQL 连接状态，在连接非活跃时提供认证链接引导完成配置。所有工具执行前都会验证连接状态，确保任务可靠运行。

3. 多工具协同执行

通过 RUBE_MULTI_EXECUTE_TOOL 支持单次调用执行多个 AgentQL 工具，配合会话 ID 复用实现复杂工作流。支持分页处理和结果聚合，适合大批量数据处理场景。

常见问题

AgentQL 自动化技能需要 API 密钥吗？

不需要。Rube MCP 服务器是一个免密钥的 MCP 服务，只需在客户端配置中添加 https://rube.app/mcp 作为服务器端点即可使用。但 AgentQL 本身的账号连接需要通过 Composio 进行一次性的 OAuth 授权。

如何获取 AgentQL 工具的正确 schema？

务必在执行任何操作前先调用 RUBE_SEARCH_TOOLS，传入你的具体使用场景。工具 schema 会经常更新，硬编码参数很容易导致调用失败。搜索结果会包含完整的输入参数格式和推荐执行计划。

连接状态显示非活跃怎么办？

使用 RUBE_MANAGE_CONNECTIONS 检查连接状态，如果返回非 ACTIVE 状态，系统会提供认证链接。点击链接完成 Composio 的 AgentQL 工具包授权后，再次检查状态确认变为 ACTIVE 即可正常使用。

本技能有什么使用限制？

本技能依赖于 Rube MCP 服务的可用性和 Composio AgentQL 工具包的功能范围。对于超大规模的批量任务，建议使用 RUBE_REMOTE_WORKBENCH 的 run_composio_tool() 方法以获得更好的性能。同时需要注意会话 ID 的正确复用，避免创建过多独立会话。