supadata-automation

supadata-automation skill の概要

supadata-automation の用途

supadata-automation は、Composio の Rube MCP server を通じて Supadata ワークフローを実行するための Claude skill です。supadata-automation skill の主な目的は、Supadata を一から学ばせることではありません。AI agent が現在の Supadata tool schema を発見し、ユーザーの Supadata connection を確認し、推測を減らして適切な Rube MCP tool call を実行できるようにすることです。

向いているユーザーと作業

この supadata-automation skill は、すでに Claude で MCP tools を使っていて、会話型のワークフローから Supadata 関連タスクを自動化したい場合に役立ちます。API 的な Supadata 操作を agent に任せたい、実行時に利用可能な tool capabilities を確認したい、処理前に Composio の接続要件を満たしたい、というユーザーに向いています。

一方で、単体で使える CLI、Supadata SDK の完全なラッパー、MCP を使わない自動化パッケージを探している場合にはあまり適していません。この skill は、利用するクライアントで Rube MCP が使えることを前提にしています。

最大の特徴: schema discovery を先に行う設計

supadata-automation で最も重要なのは、実行前に必ず RUBE_SEARCH_TOOLS を呼び出すよう促す点です。MCP tool schema や利用可能な Supadata 操作は変わる可能性があるため、これは重要です。固定の前提をハードコードするのではなく、現在の tool slug、必須入力、実行計画、注意点を発見してから使うよう agent に指示します。

導入前に必要な条件

skill をインストールまたは使用する前に、利用している AI クライアントが MCP をサポートしており、https://rube.app/mcp を server として追加できることを確認してください。また、Rube 経由で管理される有効な Supadata connection も必要です。これは toolkit supadata を指定して RUBE_MANAGE_CONNECTIONS で確認します。connection が有効でない場合、agent はワークフローを実行する前に、返された認証リンクに従う必要があります。

supadata-automation skill の使い方

supadata-automation のインストールとセットアップ手順

Composio skills repository から次のコマンドで skill をインストールします。

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

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

https://rube.app/mcp

インストール後、MCP server が RUBE_SEARCH_TOOLS を公開していることを確認してください。この skill のワークフローは、その tool を呼び出せることに依存しています。次に、toolkit supadata を指定して RUBE_MANAGE_CONNECTIONS を使い、connection status が ACTIVE であることを確認します。

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

repository path は composio-skills/supadata-automation で、読むべきメインファイルは SKILL.md です。この skill フォルダには追加の scripts、resources、rules、README files はないため、運用上のガイダンスはこの 1 ファイルに集約されています。

SKILL.md を確認するときは、まず次のセクションに注目してください。

• Prerequisites: MCP と Supadata connection の要件
• Setup: Rube MCP の追加と connection の有効化
• Tool Discovery: 必須の search-first パターン
• Core Workflow Pattern: 想定される呼び出し順序

あいまいな目的を実行しやすいプロンプトに変える

弱いプロンプトの例は、「Supadata を使ってこれをやって」です。

supadata-automation を使うなら、より良いプロンプトは次のようになります。

“Use the supadata-automation skill. First call RUBE_SEARCH_TOOLS for the Supadata task: [describe the exact operation]. Check my Supadata connection with RUBE_MANAGE_CONNECTIONS. If active, choose the matching tool from the discovered schema, show the required fields, ask me for missing values, then execute only after I confirm.”

このように書くと、agent に skill の discovery-first 設計に従わせ、存在しない tool 名を作らせず、必須フィールドが不足している場合は一度止まらせることができます。

確実に実行するための実践的なワークフロー

ほとんどの Supadata タスクでは、次の順序で進めます。

1. 目的の操作を自然な言葉で定義する。
2. RUBE_SEARCH_TOOLS で現在の Supadata tools を検索するよう agent に依頼する。
3. 返された schema を確認し、必須入力を列挙するよう依頼する。
4. RUBE_MANAGE_CONNECTIONS で Supadata toolkit が active と表示されていることを確認する。
5. 不足している ID、URL、filter、payload field を渡す。
6. agent に選択済みの Rube MCP tool を実行させる。
7. 結果を確認し、修正を依頼する場合は返された tool output を文脈に含める。

tool discovery を省略しないでください。この skill は、記憶された API 形状ではなく、現在の schema を前提に設計されています。

supadata-automation skill FAQ

supadata-automation は Rube MCP なしで使える？

いいえ。supadata-automation には Rube MCP が必要です。この skill には独自の API client や scripts は含まれていません。RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS が使えない場合、agent は想定されたワークフローに従えません。

通常のプロンプトより何が良い？

通常のプロンプトでは、agent が Supadata 操作を推測したり、古い前提で進めたりする可能性があります。supadata-automation skill は、利用可能な tools を先に検索し、Supadata connection を確認し、live schema を読んでから実行する、という明確な運用パターンを agent に与えます。現在の tool 定義に正確さが左右される Workflow Automation では、ここが主な価値です。

この skill は初心者向け？

目指す Supadata の結果が分かっているユーザーには扱いやすいですが、MCP の概念自体が初めてのユーザー向けではありません。コードを書く必要はありませんが、MCP server の追加、auth flow の完了、必須フィールドに関する agent からの質問への回答には慣れている必要があります。

使わないほうがよいケースは？

オフライン自動化、AI クライアント外で動く bulk scripts、Composio を使わない Supadata API 直接統合が必要な場合は、この skill を使うべきではありません。また、この skill は agent 経由の MCP tool 利用を前提としているため、version-controlled code による決定論的な batch execution が必要なワークフローにも向いていません。

supadata-automation skill を改善する方法

タスク入力を具体化して supadata-automation の結果を良くする

この skill は、タスク、対象 object、制約、期待する出力形式を明確に渡すほど効果を発揮します。「Supadata を自動化して」ではなく、次のように依頼します。

“Find the Supadata tool for [specific action]. Use these inputs: [known IDs, URLs, filters, time range, format]. If the schema requires anything else, ask before executing. Return the final result plus the tool name used.”

これにより、agent は正確な use_case で検索でき、不要な確認の往復を減らせます。

避けたい一般的な失敗パターン

よくある問題は、discovery の省略、connection status が inactive、必須フィールドの不足、存在しない tool の捏造です。これを防ぐには、agent に次のことを明示的に求めます。

• tool を選ぶ前に RUBE_SEARCH_TOOLS を呼び出す
• supadata connection が ACTIVE であることを確認する
• 実行前に必須 schema fields を引用して示す
• 不足値を推測せず、質問する
• 実行前に選択した tool slug を報告する

この確認は特に重要です。repository には SKILL.md しか含まれておらず、validation を強制する helper scripts はありません。

最初の tool output の後で反復する

最初の実行後、あいまいな修正依頼ですぐに再実行しないでください。返された tool output を貼り付けるか保持したうえで、意図した結果と比較するよう agent に依頼します。良い反復プロンプトの例は次のとおりです。

• “Which input field caused this result?”
• “Does the discovered schema support filtering by this value?”
• “Search tools again for a more specific Supadata operation.”
• “Show the smallest safe next call before executing.”

こうすることで、ワークフローを live tool capabilities に基づいたまま進められます。

maintainer が次に追加できるもの

supadata-automation guide は、task prompt の例、RUBE_SEARCH_TOOLS response のサンプル、一般的な Supadata operation pattern、inactive connection 向けの troubleshooting notes があるとさらに実用的になります。短い「before execution」チェックリストも、agent が skill を正しく起動し、ユーザー側の推測を減らすうえで役立ちます。