bitquery-automation

bitquery-automation skillの概要

bitquery-automationでできること

bitquery-automation は、Composio の Rube MCP server を通じて Bitquery タスクを自動化するための Claude skill です。Bitquery のブロックチェーンデータを使う必要があり、かつハードコードされたツール名や古いスキーマに依存したくないワークフロー向けに設計されています。この skill の中心的なルールは明快です。まず利用可能な Rube tools を検索し、現在のスキーマと接続状態を確認してから Bitquery actions を実行します。

Workflow Automationチームに向いているケース

bitquery-automation skill は、すでに Claude と MCP tools を使っていて、再現性のある Bitquery ワークフローを作りたい開発者、アナリスト、自動化担当者に適しています。典型的な用途は、利用可能な Bitquery actions の探索、ウォレットやトークンデータの確認、ブロックチェーンデータ取得フローの構築、自然言語の分析依頼をツール実行に裏づけられた計画へ落とし込むことです。

主な違い：まずスキーマを発見する

API フィールドを推測するだけの一般的なプロンプトとは異なり、bitquery-automation は実行前に RUBE_SEARCH_TOOLS を呼び出すようエージェントに指示します。これは重要です。MCP tool schemas は変わる可能性があり、Bitquery actions には固有の必須フィールドがある場合があり、誤った前提は呼び出し失敗や不完全なデータにつながります。この skill 自体は小さいものですが、価値は正しい順序を徹底できる点にあります。つまり、ツールを発見し、接続を確認し、実行し、返されたデータを処理するという流れです。

導入前に知っておきたい制約

この skill は、単体で動く Bitquery SDK、クローラー、ダッシュボードではありません。Rube MCP と、Composio 経由で管理される有効な Bitquery 接続が必要です。リポジトリ内の該当パスには SKILL.md だけが含まれているため、補助スクリプト、サンプル、同梱リファレンスはありません。Rube を使った Bitquery 自動化のために、規律あるエージェントワークフローを導入したい場合にインストールしてください。完成済みのアプリケーションテンプレートが必要な場合には向いていません。

bitquery-automation skillの使い方

bitquery-automationのインストールとセットアップ

Composio skills repository から skill をインストールします。

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

次に、MCP server endpoint を追加して、クライアントで Rube MCP を設定します。

https://rube.app/mcp

skill を使う前に、RUBE_SEARCH_TOOLS が利用できることを確認してください。続いて、toolkit bitquery を指定して RUBE_MANAGE_CONNECTIONS を使い、接続が ACTIVE でない場合は返された認証フローを完了します。接続がアクティブになるまで、エージェントに Bitquery タスクを実行させないでください。多くの失敗はプロンプトそのものではなく、MCP アクセス不足や Bitquery 接続の未完了が原因になります。

skillに渡すべき入力

適切な bitquery-automation usage のためには、具体的なブロックチェーン上の問い、対象チェーンまたはネットワーク、エンティティ種別、識別子、期間、出力形式をエージェントに伝えます。弱い入力は「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.”

このように依頼すると、エージェントは具体的なユースケースに沿ってツールを検索し、現在のスキーマにリクエストを対応づけ、必須フィールドを推測で埋めることを避けられます。

実務でおすすめの進め方

信頼性の高い bitquery-automation guide は、次の4ステップで進めます。

1. 特定の Bitquery タスクに対して skill を使うようエージェントに依頼する。
2. 実際のユースケースをクエリとして使い、最初に必ず RUBE_SEARCH_TOOLS を実行させる。
3. toolkit bitquery について RUBE_MANAGE_CONNECTIONS を確認し、ACTIVE であることを確かめる。
4. 発見で返されたスキーマに基づいて、選択した Bitquery tool を実行する。

最初のツール検索で複数の候補が返ってきた場合は、実行前に、どのツールを選んだのか、なぜそれを選んだのかをエージェントに説明させましょう。これは、「transaction」「trade」「transfer」「balance」がそれぞれ異なる Bitquery 機能に対応し得る分析系プロンプトで特に役立ちます。

利用前に読むべきファイル

まず composio-skills/bitquery-automation/SKILL.md を確認してください。前提条件、Rube MCP のセットアップ、ツール発見、接続管理、基本的な実行パターンなど、完全な運用モデルが記載されています。この skill のパスには README.md、rules/、resources/、references/、scripts/ は存在しないため、上流の SKILL.md が信頼すべき情報源です。toolkit 固有の挙動については、composio.dev/toolkits/bitquery にあるリンク先の Bitquery toolkit documentation も確認してください。

bitquery-automation skillのFAQ

ClaudeからBitqueryを使うにはbitquery-automationだけで十分ですか？

Claude 環境から Rube MCP にアクセスでき、Composio 経由の Bitquery 接続がアクティブであれば十分です。この skill には Bitquery の認証情報、カスタムクエリ、ローカルデータパイプラインは含まれていません。利用可能な Bitquery tools を安全に発見し、呼び出す方法をエージェントに教えるものです。

通常のプロンプトより何が優れていますか？

通常のプロンプトでは、ツール名を幻覚したり、存在しないフィールドを作り出したりすることがあります。bitquery-automation は、RUBE_SEARCH_TOOLS による実際のツール発見を必須にすることで信頼性を高めます。これがインストールする主な理由です。エージェントは記憶に頼るのではなく、現在の Rube/Bitquery スキーマに適応するべきだからです。

初心者にも使いやすいですか？

MCP の基本を理解しているユーザーにとっては使いやすいですが、MCP server を一度も設定したことがない人向けではありません。セットアップ自体は短いものの、Rube MCP を接続し、Bitquery toolkit を認可し、失敗時にツール応答を確認できることを前提としたワークフローです。

このskillを使わないほうがよい場合は？

Bitquery を必要としないタスク、自前データベースを使ったオフラインのブロックチェーン分析、エージェント判断を挟まず監査済みの決定的なコードが求められる本番ワークフローには使わないでください。また、組織としてサードパーティの MCP 接続や Composio 管理の toolkit アクセスを認可できない場合にも適していません。

bitquery-automation skillを改善する方法

bitquery-automation向けプロンプトを改善する

結果を改善する最短の方法は、会話的ではなく運用可能な形でタスクを書くことです。チェーン、アセット、ウォレット、コントラクト、時間範囲、フィルター、希望する出力を含めてください。また、生の返却フィールドがほしいのか、要約された回答がほしいのか、再利用可能なワークフローがほしいのかも明示します。

よりよいプロンプトの型は次のとおりです。

“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.”

よくある失敗を避ける

最も多い失敗は、発見を省略してツールスキーマを推測することです。次に多いのは、Bitquery 接続がアクティブになる前に実行しようとすることです。3つ目は、ネットワーク、識別子、期間を指定せずに曖昧な分析質問を投げることです。これらを防ぐには、最初の Bitquery 呼び出しの前に、発見、接続確認、短い実行計画を明示的に求めてください。

最初の出力後に反復する

最初の応答を受け取ったら、どの tool slug と schema fields が使われたのかをエージェントに示してもらいます。結果が広すぎる場合は、チェーン、コントラクト、ブロック範囲、timestamp、transaction type、address list で絞り込みます。結果が少なすぎる場合は、同じ tool call を無理に繰り返すのではなく、より正確なユースケースで発見をやり直すよう依頼します。

チームのワークフロー向けに拡張する

チームで bitquery-automation を改善するには、よく使う Bitquery タスクに沿った社内サンプルを追加すると効果的です。たとえば、トークン監視、ウォレット調査、DEX trade summaries、コンプライアンスレビュー用エクスポートなどです。これらのサンプルはスキーマを意識した形にしてください。古いフィールド名をプロンプトに固定するのではなく、毎回ツールを再発見するようエージェントに指示します。これにより、この skill の最大の利点を保ちながら、繰り返し実行するワークフローをより速く進められます。