bitquery-automation

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 最適合已經透過 MCP tools 使用 Claude，並且想建立可重複 Bitquery 工作流程的開發者、分析師與自動化流程建置者。常見任務包括探索可用的 Bitquery actions、查詢錢包或代幣資料、建立區塊鏈資料擷取流程，以及把自然語言分析需求轉成有工具支援的執行計畫。

關鍵差異：先做 schema discovery

一般 prompt 可能會猜測 API 欄位；不同的是，bitquery-automation 會要求 agent 在執行前先呼叫 RUBE_SEARCH_TOOLS。這一點很重要，因為 MCP tool schemas 可能會變更，Bitquery actions 也可能暴露特定必填欄位；只要假設錯誤，就可能導致呼叫失敗或資料不完整。這個 skill 本身很小，但價值在於強制正確順序：探索工具、驗證連線、執行，然後處理回傳資料。

採用前需要知道的限制

這個 skill 不是獨立的 Bitquery SDK、爬蟲或儀表板。它需要 Rube MCP，以及透過 Composio 管理的有效 Bitquery connection。此 repository path 只有 SKILL.md，因此沒有 helper scripts、examples 或 bundled references 可參考。如果你想要的是由 Rube 驅動、紀律明確的 Bitquery automation agent 工作流程，這個 skill 值得安裝；如果你需要完整的應用程式範本，則不適合。

如何使用 bitquery-automation skill

bitquery-automation 安裝與設定

從 Composio skills repository 安裝這個 skill：

npx skills add ComposioHQ/awesome-claude-skills --skill bitquery-automation

接著在你的 client 中加入 MCP server endpoint，設定 Rube MCP：

https://rube.app/mcp

使用這個 skill 之前，請先確認 RUBE_SEARCH_TOOLS 可用。接著使用 RUBE_MANAGE_CONNECTIONS，toolkit 設為 bitquery；如果連線狀態不是 ACTIVE，就完成回傳的 authentication flow。在 connection 變成 active 之前，不要要求 agent 執行 Bitquery tasks；多數失敗通常來自缺少 MCP access 或 Bitquery connection 尚未完成，而不是 prompt 本身。

你需要提供給 skill 的輸入

要讓 bitquery-automation usage 效果好，請提供具體的區塊鏈問題、目標 chain 或 network、entity type、identifiers、time range，以及 output format。較弱的輸入是「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 可以針對明確 use case 搜尋工具，把你的需求對應到目前的 schema，並避免猜測必填欄位。

實務上建議的工作流程

可靠的 bitquery-automation guide 通常遵循四個步驟：

1. 要求 agent 針對特定 Bitquery task 啟用這個 skill。
2. 要求先執行 RUBE_SEARCH_TOOLS，並用你的實際 use case 作為 query。
3. 針對 toolkit bitquery 檢查 RUBE_MANAGE_CONNECTIONS，並確認狀態為 ACTIVE。
4. 使用 discovery 回傳的 schema，執行選定的 Bitquery tool。

如果第一次 tool search 回傳多個候選工具，請先要求 agent 說明它選了哪個工具以及原因，再讓它執行。這對分析類 prompt 特別有用，因為 “transaction”、“trade”、“transfer” 和 “balance” 可能會對應到不同的 Bitquery capabilities。

依賴前應先閱讀的檔案

先從 composio-skills/bitquery-automation/SKILL.md 開始。它包含完整的操作模型：prerequisites、Rube MCP setup、tool discovery、connection management，以及核心 execution pattern。這個 skill path 沒有 README.md、rules/、resources/、references/ 或 scripts/ 檔案，因此 upstream SKILL.md 是唯一的 source of truth。若要確認 toolkit-specific behavior，也請查看連結的 Bitquery toolkit documentation：composio.dev/toolkits/bitquery。

bitquery-automation skill 常見問題

bitquery-automation 足夠讓 Claude 使用 Bitquery 嗎？

如果你的 Claude environment 可以存取 Rube MCP，且你已透過 Composio 建立 active Bitquery connection，那就足夠。這個 skill 不包含 Bitquery credentials、custom queries 或 local data pipeline。它的作用是教 agent 如何安全地探索並呼叫可用的 Bitquery tools。

它比一般 prompt 好在哪裡？

一般 prompt 可能會幻覺出不存在的 tool names，或自行編造 fields。bitquery-automation 透過要求使用 RUBE_SEARCH_TOOLS 進行即時 tool discovery 來提升可靠性。這正是安裝它的主要理由：agent 應該依照目前的 Rube/Bitquery schema 調整做法，而不是依賴記憶。

適合初學者嗎？

如果使用者了解 MCP 基礎，它算是初學者友善；但若從未設定過 MCP server，就不太適合直接上手。設定流程很短，不過工作流程預設你能連上 Rube MCP、授權 Bitquery toolkit，並在出錯時檢查 tool responses。

什麼時候不該使用這個 skill？

不需要 Bitquery 的任務不適合使用；如果你要從自己的資料庫做離線區塊鏈分析，或是生產流程要求經過稽核、完全 deterministic、不能有 agent 決策，也不適合。若你的組織無法授權第三方 MCP connections，或無法使用 Composio-managed toolkit access，這個 skill 也不是好選擇。

如何改進 bitquery-automation skill

改善 bitquery-automation 的 prompts

提升結果最快的方法，是把任務寫成可操作的需求，而不是聊天式提問。請包含 chain、asset、wallet、contract、time window、filters，以及期望的 output。也要說清楚你想要 raw returned fields、摘要回答，還是可重複使用的 workflow。

更好的 prompt pattern：

「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.」

避免常見失敗模式

最常見的失敗，是跳過 discovery、直接猜 tool schema。第二常見的是在 Bitquery connection 還沒 active 前就嘗試執行。第三種則是提出過於模糊的分析問題，沒有指定 network、identifiers 或 time range。要避免這些問題，請在第一次 Bitquery call 之前，明確要求 discovery、connection verification，以及一份簡短 execution plan。

依照第一次輸出迭代

收到初次回覆後，請要求 agent 顯示使用了哪個 tool slug 與哪些 schema fields。如果結果太廣，請用 chain、contract、block range、timestamp、transaction type 或 address list 縮小範圍。如果結果太少，請要求 agent 用更精準的 use case 重新執行 discovery，而不是硬套同一個 tool call。

為團隊工作流程擴充這個 skill

團隊可以為 bitquery-automation 加入內部常用 Bitquery tasks 的 examples，例如 token monitoring、wallet investigations、DEX trade summaries 或 compliance review exports。這些 examples 應該保持 schema-aware：要求 agent 每次都重新 discover tools，而不是把舊的 field names 固定寫進 prompts。這樣既能保留 skill 的主要優勢，也能讓重複性工作流程更快執行。