bitquery-automation
作者 ComposioHQbitquery-automation 可帮助 Claude 通过 Composio Rube MCP 自动化 Bitquery 工作流：发现当前 tools、检查 Bitquery 连接，并基于实时 schemas 执行操作。
该 skill 评分为 66/100，表示可收录到目录中，但能力有限。目录用户可以了解它如何通过 Composio/Rube MCP 实现 Bitquery 自动化，以及 agent 应如何开始使用；不过应预期它更像一个轻量级连接器 skill，而不是功能丰富的 Bitquery 工作流库。
- Frontmatter 有效，并清楚声明了必需的 MCP 依赖：Rube。
- 前置条件和设置步骤说明，在使用 Bitquery tools 之前需要先具备 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS。
- 该 skill 反复要求 agent 先发现当前 tool schemas，有助于减少因 schema 过期或参数错误导致的执行失败。
- 除 SKILL.md 外，没有支持文件、脚本、参考资料或 README，因此采用效果完全取决于这份简短说明。
- 该流程主要是通用的 Rube MCP discovery/connect/execute 模式，几乎没有提供 Bitquery 专属任务指导或具体示例。
bitquery-automation skill 概览
bitquery-automation 能做什么
bitquery-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 自动化执行 Bitquery 相关任务。它适合那些需要从 Bitquery 获取区块链数据、但又不希望依赖硬编码工具名或过期 schema 的工作流。这个 skill 的核心规则很简单：先搜索当前可用的 Rube tools，再在确认最新 schema 和连接状态后执行 Bitquery actions。
最适合 Workflow Automation 团队
bitquery-automation skill 更适合已经在 Claude 中使用 MCP tools，并希望构建可重复 Bitquery 工作流的开发者、分析师和自动化流程搭建者。常见任务包括探索可用的 Bitquery actions、检查钱包或代币数据、搭建区块链数据检索流程，以及把自然语言分析需求转化为由工具执行的计划。
核心差异：先发现 schema，再执行
普通 prompt 往往会猜测 API 字段，而 bitquery-automation 会要求 agent 在执行前先调用 RUBE_SEARCH_TOOLS。这一点很重要，因为 MCP tool schemas 可能变化，Bitquery actions 也可能暴露特定的必填字段；一旦假设错误，就可能导致调用失败或返回数据不完整。这个 skill 本身很小，但价值在于强制执行正确顺序：发现工具、验证连接、执行任务，然后处理返回数据。
采用前需要了解的限制
这个 skill 不是独立的 Bitquery SDK、爬虫或 dashboard。它依赖 Rube MCP，并且需要通过 Composio 管理一个可用的 Bitquery connection。该仓库路径下只有 SKILL.md，没有 helper scripts、examples 或打包好的 references 可以参考。如果你想要的是一套基于 Rube 的、纪律性更强的 Bitquery 自动化 agent 工作流，它值得安装；如果你需要的是完整应用模板，它并不合适。
如何使用 bitquery-automation skill
bitquery-automation 安装与设置
从 Composio skills repository 安装该 skill：
npx skills add ComposioHQ/awesome-claude-skills --skill bitquery-automation
然后在你的客户端中配置 Rube MCP，添加 MCP server endpoint：
https://rube.app/mcp
使用该 skill 之前，先确认 RUBE_SEARCH_TOOLS 可用。接着使用 RUBE_MANAGE_CONNECTIONS，将 toolkit 设置为 bitquery；如果连接状态不是 ACTIVE，请完成返回的认证流程。在连接变为 active 之前，不要让 agent 执行 Bitquery 任务；多数失败并不是 prompt 本身的问题，而是缺少 MCP 访问权限或 Bitquery connection 尚未完成。
你需要提供哪些输入
想获得更好的 bitquery-automation usage 效果，需要向 agent 提供具体的区块链问题、目标 chain 或 network、实体类型、标识符、时间范围和输出格式。较弱的输入是“get token activity”。更好的输入是：
“Use bitquery-automation to find recent transfer activity for token contract 0x... on Ethereum for the last 24 hours. First discover the current Bitquery tools through Rube, verify the Bitquery connection, then return the fields available for transfers and summarize the top 10 transfers in a table.”
这样效果更好，因为 agent 可以围绕具体用例搜索工具，将你的请求映射到当前 schema，并避免猜测必填字段。
实际推荐工作流
一个可靠的 bitquery-automation guide 通常包含四步：
- 要求 agent 针对一个具体 Bitquery 任务调用该 skill。
- 要求先执行
RUBE_SEARCH_TOOLS，并用你的真实用例作为查询。 - 使用
RUBE_MANAGE_CONNECTIONS检查 toolkitbitquery，并确认状态为ACTIVE。 - 根据发现阶段返回的 schema，执行选定的 Bitquery tool。
如果第一次工具搜索返回多个候选项，在真正运行之前，让 agent 先解释它选择了哪个工具以及原因。对于分析类 prompt，这一点尤其有用，因为 “transaction”、“trade”、“transfer” 和 “balance” 可能对应 Bitquery 中不同的能力。
依赖前应该先读哪些文件
从 composio-skills/bitquery-automation/SKILL.md 开始阅读。它包含完整的运行模型：前置条件、Rube MCP 设置、工具发现、连接管理，以及核心执行模式。这个 skill 路径下没有 README.md、rules/、resources/、references/ 或 scripts/ 文件，因此上游 SKILL.md 就是事实来源。关于 toolkit 的具体行为，也建议查看链接的 Bitquery toolkit 文档：composio.dev/toolkits/bitquery。
bitquery-automation skill 常见问题
bitquery-automation 足够让 Claude 使用 Bitquery 吗？
如果你的 Claude 环境可以访问 Rube MCP，并且你已经通过 Composio 建立了 active 的 Bitquery connection，那么它是够用的。这个 skill 不包含 Bitquery credentials、自定义查询或本地数据管道。它的作用是教 agent 如何安全地发现并调用可用的 Bitquery tools。
它比普通 prompt 好在哪里？
普通 prompt 可能会幻觉出不存在的工具名，或者编造字段。bitquery-automation 通过要求使用 RUBE_SEARCH_TOOLS 进行实时工具发现来提升可靠性。这也是安装它的主要理由：agent 应该适配当前 Rube/Bitquery schema，而不是依赖记忆。
它适合新手吗？
如果用户理解 MCP 基础概念，它对新手是友好的；但如果完全没有配置过 MCP server，就不算零门槛。设置步骤不长，但整个工作流默认你能够连接 Rube MCP、授权 Bitquery toolkit，并在出错时查看 tool responses。
什么时候不该使用这个 skill？
如果任务不需要 Bitquery，或者你要基于自己的数据库做离线区块链分析，或者生产流程要求经过审计的确定性代码、不能包含 agent 决策，就不应该使用它。如果你的组织无法授权第三方 MCP connections 或 Composio 管理的 toolkit access，它也不适合。
如何改进 bitquery-automation skill
改进 bitquery-automation 的 prompt
提升结果质量最快的方法，是把任务写成可执行的操作说明，而不是泛泛对话。请包含 chain、asset、wallet、contract、time window、filters 和期望输出。同时说明你想要原始返回字段、摘要答案，还是可复用工作流。
更好的 prompt 模式：
“Use bitquery-automation for Workflow Automation. Discover current Bitquery tools first. Check the Bitquery connection. Then retrieve [data type] for [chain/entity] over [time range], using only fields confirmed by the discovered schema. If required fields are missing, ask before execution.”
避免常见失败模式
最常见的失败是跳过发现步骤，直接猜测 tool schema。第二类失败是在 Bitquery connection 变为 active 之前就尝试执行。第三类失败是提出过于模糊的分析问题，没有指定 network、identifiers 或 time range。避免这些问题的方式，是在第一次 Bitquery 调用之前，明确要求完成工具发现、连接验证，并给出简短执行计划。
根据第一次输出继续迭代
初次返回后，可以要求 agent 展示它使用了哪个 tool slug 和哪些 schema fields。如果结果过宽，可以按 chain、contract、block range、timestamp、transaction type 或 address list 缩小范围。如果结果太稀疏，不要强行复用同一个 tool call，而是要求 agent 用更精确的用例重新执行 discovery。
为团队工作流扩展这个 skill
团队可以通过为常见 Bitquery 任务补充内部示例来改进 bitquery-automation，例如 token monitoring、wallet investigations、DEX trade summaries 或 compliance review exports。注意这些示例也应保持 schema-aware：告诉 agent 每次都重新发现工具，而不是把旧字段名固化在 prompt 里。这样既能保留该 skill 的核心优势，也能让重复工作流运行得更快。