simple-analytics-automation
作成者 ComposioHQsimple-analytics-automation は、Composio Rube MCP 経由で Simple Analytics の自動化を行うエージェント向けのスキルです。simple_analytics 接続の確認、RUBE_SEARCH_TOOLS による現在のツールスキーマの検出、安全なワークフロー自動化タスクの実行を支援します。
このスキルの評価は 66/100 です。ディレクトリ掲載には許容範囲ですが、完成された自動化パッケージというより、軽量な MCP ワークフローガイドとして提示するのが適切です。エージェントが Rube MCP を使って Simple Analytics を扱うためのトリガーやセットアップの案内は十分にありますが、リポジトリ上の根拠には Simple Analytics の具体的なエンドツーエンドのタスク例や補助ファイルが含まれていないため、利用者はライブのツール検出に頼る前提で考えるべきです。
- 有効な frontmatter でスキル名が明示され、Simple Analytics 自動化に Rube MCP が必要であることも宣言されています。
- 前提条件とセットアップ手順では、Rube MCP の確認、Simple Analytics 接続の管理、利用前に接続が ACTIVE であることの確認方法が説明されています。
- Composio のツール定義が変更された場合でもスキーマの推測を減らせるよう、まず RUBE_SEARCH_TOOLS を呼び出すことを繰り返し指示しています。
- SKILL.md 以外のサポートファイル、スクリプト、参照資料、同梱サンプルはなく、実行はすべて Rube MCP のライブ検出に依存します。
- 確認できる抜粋は主に汎用的な検出・セットアップ手順で、一般的なタスク向けの具体的な Simple Analytics ワークフローやパラメータは示されていません。
simple-analytics-automation skill の概要
simple-analytics-automation でできること
simple-analytics-automation は、Composio の Rube MCP server を通じて Simple Analytics のタスクを自動化するための Claude skill です。価値の中心は、固定された分析コマンドをハードコードしている点ではありません。まず現在の Simple Analytics tool schema を見つけ、接続を確認し、そのうえで依頼された分析ワークフローに合った Rube tool を実行する、という進め方をエージェントに教える点にあります。
Workflow Automation ユーザーに向いているケース
この simple-analytics-automation skill は、すでに Simple Analytics を使っていて、レポート作成、データ参照、アカウント操作などの繰り返し作業を、API の細部を毎回手作業で追わずにエージェント支援で進めたいチームに適しています。ツールの入力仕様が将来変わる可能性がある Workflow Automation の場面にも向いています。実行前に RUBE_SEARCH_TOOLS を必ず使う前提のため、古い想定に依存しにくいからです。
導入に必要な条件
重要な依存先は Rube MCP です。利用する AI クライアントに、Rube MCP server として https://rube.app/mcp を設定しておく必要があります。また、Simple Analytics toolkit の接続は、toolkit simple_analytics を使って RUBE_MANAGE_CONNECTIONS 経由で有効化されている必要があります。Rube MCP が利用できない場合、または Simple Analytics の接続が認証されていない場合、この skill はセットアップ確認用のチェックリスト以上の役割は果たしません。
汎用プロンプトとの違い
汎用プロンプトでは、アシスタントに「Simple Analytics のデータを取得して」と依頼し、API を知っていることに期待する形になりがちです。この skill は、より安全な運用パターンを追加します。利用可能な Rube tools を検索し、現在の schema を確認し、認証状態を確かめてから、適切な Simple Analytics 操作を実行します。これにより、古い tool 名、足りないフィールド、推測したパラメータによる失敗を減らせます。
simple-analytics-automation skill の使い方
simple-analytics-automation のインストール前提
このリポジトリから skill をインストールできる環境であれば、次を使います。
npx skills add ComposioHQ/awesome-claude-skills --skill simple-analytics-automation
次に、AI クライアントに Rube MCP を設定します。
https://rube.app/mcp
この upstream skill は、Rube MCP tools、特に RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS が利用できることを前提にしています。インストール後は、まず composio-skills/simple-analytics-automation/SKILL.md を開いてください。現在のリポジトリツリーには追加の scripts/、resources/、references/ フォルダはないため、この skill ファイルが運用手順の主な情報源です。
ワークフロー実行前に用意する入力
エージェントに Simple Analytics のタスクを依頼する前に、次の情報を渡してください。
- 正確な Simple Analytics 上の目的。例: 「サイトのトラフィック指標を取得する」「利用可能な analytics operations を確認する」「定期レポートを準備する」
- 必要に応じて、サイト、ドメイン、日付範囲、フィルター、指標名
- ツールの発見だけを行うのか、アクセス確認まで行うのか、実際に操作を実行するのか
- 出力形式の要件。例: 表、CSV 化しやすい要約、JSON、短いエグゼクティブ向け要約
この skill で最も重要なルールは、最初に検索することです。優れたプロンプトでは、フィールドを推測するのではなく、現在の schema を確認するために RUBE_SEARCH_TOOLS を呼び出してよいことを明示します。
実用的なプロンプト例
弱いプロンプトは次のようなものです。
“Use Simple Analytics to get my stats.”
よりよい simple-analytics-automation の利用プロンプトは次のとおりです。
“Use the simple-analytics-automation skill. First verify Rube MCP is available and check the simple_analytics connection status. Then call RUBE_SEARCH_TOOLS for the current Simple Analytics tool schema for retrieving website traffic metrics. If the connection is active, fetch metrics for example.com for the last 30 days. Return a concise table with visitors, pageviews, top pages if available, and mention any fields or metrics that the discovered schema does not support.”
この形が有効なのは、接続確認、発見ステップ、対象ドメイン、期間、必要な指標、出力形式が明確になっているためです。
実行時に従うべきワークフロー
3 段階で進めます。
- 接続確認: Rube MCP が応答し、Simple Analytics が
RUBE_MANAGE_CONNECTIONS上で ACTIVE になっていることを確認します。 - ツール発見: 漠然としたクエリではなく、具体的なユースケースで
RUBE_SEARCH_TOOLSを実行します。例: “Simple Analytics traffic summary by domain and date range.” - 実行: 返された tool slug と schema をそのまま使い、制約があればそれも含めて結果を要約します。
以前の実行でうまくいったからといって、発見ステップを省略しないでください。この skill は、現在の Rube schema を信頼できる唯一の情報源として扱う設計です。
simple-analytics-automation skill FAQ
simple-analytics-automation は開発者専用ですか？
いいえ。利用している AI クライアントが MCP tools に対応していて、誰かが Rube MCP を接続済みであれば、非開発者でも使えます。ただし、MCP 設定と Simple Analytics の認証に依存するため、通常のチャットプロンプトよりセットアップは技術的です。
この skill を使わないほうがよい場合は？
オフライン分析が必要な場合、Composio/Rube を介さず Simple Analytics API に直接アクセスしたい場合、または完全に独自の分析パイプラインが必要な場合には使わないでください。simple-analytics-automation skill は Rube MCP tool の実行を前提にしているため、環境が MCP tools をエージェントに公開できない場合には適していません。
Simple Analytics のダッシュボードを置き換えますか？
いいえ。ダッシュボードを置き換えるものではなく、特定の参照、要約、繰り返しレポート作成フローを自動化して補完するものです。探索的にグラフを見ながら分析する場合は、Simple Analytics の画面のほうが速いこともあります。一方で、スケジュール実行、エージェント主導の処理、複数ステップの Workflow Automation タスクでは、この skill のほうが有用です。
なぜ最初にツール発見を必須にしているのですか？
Composio toolkit の schema、tool slug、必須フィールドは変わる可能性があるためです。RUBE_SEARCH_TOOLS は、現在の tool 名、入力 schema、実行計画、注意点を返します。これは simple-analytics-automation ガイドにおける主要な信頼性確保の仕組みであり、トラブルシューティング時に最初に確認すべき点です。
simple-analytics-automation skill を改善する方法
simple-analytics-automation のプロンプトを改善する
最も早い改善は、タスクの切り出し方をよくすることです。分析対象、期間、ドメイン、指標、出力形式、実行を許可するかどうかを含めてください。例:
“Discover the current Simple Analytics tools for listing top referrers for example.com over the previous calendar month. If supported, run the operation and return top referrers with counts. If not supported, report the closest available tool and the missing field.”
これにより、エージェントに明確な成功条件と安全な代替手段を与えられます。
防ぐべきよくある失敗
よくある失敗は、schema の発見を省略すること、Simple Analytics の接続が無効なこと、指標の指定が曖昧なこと、フィールド名を推測してしまうことです。次をエージェントに必ず行わせることで防げます。
RUBE_SEARCH_TOOLSが利用可能であることを確認する。- 実行前に
simple_analyticsの接続状態を確認する。 - 発見された schema を正確に使う。
- 実行ツールを呼び出す前に、不足しているドメイン、日付範囲、指標の詳細を尋ねる。
これらの確認は、巧妙なプロンプト文よりも重要です。
最初の結果をもとに反復する
最初の出力後は、実際に発見された tool が対応している内容に合わせて調整します。期待していた指標が結果に含まれていない場合は、“analytics report” のような広い指定ではなく、“Simple Analytics top pages by date range” のように、より絞ったユースケースで再検索するようエージェントに依頼してください。schema に pagination、filters、grouping options がある場合は、最初の要約をそのまま受け入れるのではなく、2 回目のパスで網羅性を高めます。
メンテナー向けのリポジトリ確認手順
simple-analytics-automation skill を評価または拡張するメンテナーは、まず SKILL.md から確認してください。前提条件のブロック、セットアップ手順、ツール発見の指示、コアとなるワークフローパターンに注目します。現在の skill には補助スクリプトや参照ファイルがないため、改善するなら、具体的なプロンプト例、接続が無効な場合のトラブルシューティング分岐、traffic summaries、referrer checks、recurring report generation などのタスクカテゴリ例を追加するのが有力です。