agentql-automation
作者 ComposioHQagentql-automation 可帮助 Claude 通过 Composio Rube MCP 运行 AgentQL 浏览器自动化，并提供以 schema 优先的工具发现、连接检查和更安全的执行步骤。
该 skill 评分为 68/100，表示可以收录，但更适合作为轻量级集成指南来展示，而不是完整打包的工作流 skill。目录用户可以获得足够信息，了解它如何通过 Rube MCP 路由 AgentQL 自动化，以及 agent 应如何发现工具并验证连接；但仓库证据显示，具体任务示例有限，也没有支持文件，因此实际采用时可能需要额外试验。
- 有效的 skill frontmatter 声明了必需的 `rube` MCP，并清晰说明适用场景：通过 Composio/Rube 自动化 AgentQL 操作。
- 前置条件和设置步骤明确，包括检查 `RUBE_SEARCH_TOOLS`、使用 `RUBE_MANAGE_CONNECTIONS`，以及确认 AgentQL 连接处于 ACTIVE 状态。
- 该 skill 要求 agent 先搜索工具以获取当前 schema，有助于提升触发准确性，并减少基于过期工具信息的猜测。
- 未提供支持文件或安装命令；配置需要手动添加 Rube MCP endpoint，并配置 AgentQL 连接。
- 工作流指导主要停留在工具发现和连接检查的元层面，因此针对具体自动化任务，用户可能还需要额外的 AgentQL 或业务领域知识。
agentql-automation skill 概览
agentql-automation 适合用来做什么
agentql-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 运行 AgentQL 浏览器自动化任务。它面向这样的工作流：AI agent 需要先发现当前的 AgentQL 工具 schema，确认 AgentQL 连接处于可用状态，然后再通过 Rube 工具层执行面向浏览器的操作，而不是凭经验猜工具名或使用已经过期的参数。
它要解决的核心问题并不是“从零编写浏览器自动化脚本”，而是帮助 agent 按正确顺序调用合适的 Composio AgentQL 工具：先检查连接、发现 schema，再执行任务。
最适合的用户和项目
这个 skill 适合已经在 Claude 中使用 MCP tools，并希望通过 Rube 访问 AgentQL 的用户。对于涉及网页、结构化抽取、浏览器动作，或基于 AgentQL 的网页浏览任务来说，它尤其有用，因为这些场景里的工具可用性可能会随时间变化。
如果你想要一套可重复使用的提示词模式，通过 Composio 调用 AgentQL，那么它很适合安装。相反，如果你不使用 Rube MCP、没有 AgentQL 连接，或者只需要静态代码示例而不需要实时工具执行，它的价值就比较有限。
核心差异：先看 schema，再执行
agentql-automation skill 最重要的行为，是它坚持先调用 RUBE_SEARCH_TOOLS。这一点很关键，因为 Rube 可以返回当前可用的工具 slug、输入 schema、推荐执行计划以及已知注意事项。对于浏览器自动化来说，这能减少因工具名或参数假设过时而导致的失败。
这个 skill 还把连接状态检查纳入工作流：在运行 AgentQL 操作前，先使用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit agentql。
如何使用 agentql-automation skill
agentql-automation 安装与配置上下文
从 Composio skills repository 安装该 skill，然后确保你的客户端可以使用 Rube MCP：
npx skills add ComposioHQ/awesome-claude-skills --skill agentql-automation
该 skill 预期 Rube MCP 已作为 MCP server 配置，地址为：
https://rube.app/mcp
在依赖该 skill 之前，先确认 RUBE_SEARCH_TOOLS 可用。然后使用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit agentql。如果 AgentQL 尚未激活，请按照返回的认证链接完成授权，并重新运行连接检查，直到状态为 ACTIVE。
为了获得更好执行效果，skill 需要哪些输入
较弱的提示词是：“Use AgentQL to automate this site.”
更好的提示词会说明任务、目标、成功标准和约束：
“Use agentql-automation for Browser Automation. First search Rube tools for the current AgentQL schema. Then check the AgentQL connection. On https://example.com/products, find all visible product names and prices from the first results page. Return structured JSON with name, price, and source_url. Do not purchase, submit forms, or bypass login.”
这样能提升输出质量，因为 agent 可以把目标转换成具体的 RUBE_SEARCH_TOOLS 查询，选择正确的 AgentQL 工具，并避免不安全或含糊的浏览器动作。
推荐工作流
调用 agentql-automation skill 时，建议使用以下顺序：
- 要求 agent 针对具体用例调用
RUBE_SEARCH_TOOLS，不要只发泛泛的 “AgentQL operations” 查询。 - 在适当情况下复用返回的 session ID，让执行计划保持连贯。
- 在尝试任何浏览器操作之前，先为
agentql调用RUBE_MANAGE_CONNECTIONS。 - 如果连接已激活，就使用发现到的 schema 运行选定的 AgentQL 工具。
- 要求 agent 说明它使用了哪个 tool slug、哪些必填字段，以及做了哪些假设。
当 AgentQL 任务从抽取切换到导航时，这套流程尤其有帮助，因为不同任务可能需要不同字段或执行计划。
采用前建议阅读的文件
repository 路径是 composio-skills/agentql-automation，重点需要查看的主文件是 SKILL.md。在提供的目录树中，没有可见的 helper scripts、resources、rules 或 README 文件，因此是否安装主要应基于 skill instructions 本身来判断。
请阅读 SKILL.md，了解前置条件、配置方式、工具发现机制和核心工作流模式。也建议查看 skill 中链接的官方 toolkit 文档：https://composio.dev/toolkits/agentql。
agentql-automation skill 常见问题
没有 Rube MCP，只用 agentql-automation 够吗？
不够。该 skill 明确要求使用 rube MCP server，并依赖 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS 等工具。没有这些工具时，它只能作为一份工作流说明，无法执行 AgentQL 自动化。
这比普通 AgentQL 提示词好在哪里？
普通提示词可能会让模型自己推断工具名，或直接调用 AgentQL。agentql-automation skill 增加了一套更安全的操作顺序：先发现可用工具，检查当前 schema，确认 AgentQL 连接，然后再执行。当 schema 或推荐执行计划可能变化时，这一点很有价值。
适合新手使用吗？
只有在用户已经熟悉支持 MCP 的客户端时，它才算对新手友好。浏览器自动化目标本身可以很简单，但配置仍然需要添加 Rube MCP endpoint、管理 AgentQL 连接，并理解执行前必须先做工具发现。
什么时候不该使用这个 skill？
不要把它用于非 AgentQL 的浏览器自动化、离线抓取脚本，或没有 MCP tool execution 可用的任务。对于需要绕过访问控制、未经审核提交敏感表单，或无法定义清晰成功标准的页面操作，也应避免使用。
如何改进 agentql-automation skill
让提示词比页面目标更具体
为了从 agentql-automation 获得更好的结果，请用可观察的页面动作和预期输出来描述浏览器任务。包含 URL、要抽取或修改的内容、必填字段、停止条件，以及禁止执行的动作。
更好的输入示例：
“Open the target page, identify the pricing table, extract plan names, monthly prices, annual prices if visible, and feature limits. Return a markdown table. Stop after the first pricing page. Do not click checkout or login links.”
这能给 agent 足够上下文，用来形成精确的 Rube 工具搜索，并验证任务是否完成。
避免常见失败模式
最常见的失败是跳过工具发现，直接使用假设中的 schema。请把“先调用 RUBE_SEARCH_TOOLS”写进每一次请求。另一个常见问题是在 AgentQL 尚未连接时就开始运行；应要求 agent 在执行前确认状态为 ACTIVE。
对于动态页面，请要求 agent 报告不确定性：缺失元素、登录墙、分页、被阻止内容，或预期页面结构与实际观察结果之间的差异。
首次运行后继续迭代
第一次输出后，根据工具返回的结果继续细化。如果字段缺失，可以要求使用更窄的 AgentQL 查询，或针对页面上的特定区域再跑一次。如果输出过宽，则添加限制条件，例如 “first 10 results”、“visible cards only” 或 “current page only”。
一个有效的迭代提示词是：
“Using the same AgentQL/Rube session if possible, rerun only the extraction step. Keep name and price, add availability, and ignore sponsored results.”
为团队使用强化这个 skill
团队采用 agentql-automation skill 时，可以通过补充本地示例来提升可靠性，例如常用站点案例、已批准的操作边界、预期输出 schema，以及连接故障排查说明。由于上游 skill 本身很精简，也没有支持文件，团队专属指导可以在不改变“schema-first”核心工作流的前提下，带来实际价值。