composio-connect について
composio-connectは、1,000以上のアプリで操作を実行するフォールバック用スキルです。対応する専用スキルがない場合に、自然言語または明示したパラメーターで操作できます。
主な機能
- 011,000以上のアプリで操作を実行
- 02自然言語による操作実行
- 03アプリやカテゴリの一覧表示
- 04OAuthによるアプリ接続
- 05操作とパラメーターの指定
活用シーン
- 01専用スキルがない場合のNotionページ作成
- 02カテゴリ別の対応アプリ検索
- 03OAuthによるサービス認証
- 04指定パラメーターでの操作実行
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ casper-studios/ casper-marketplace --skill composio-connectインストール後、Claude Code で/composio-connectを入力して読み込まれたか確認します。
同梱ファイルreferences/apps-catalog.mdscripts/execute_action.py
詳細
Composio Connect
概要
1,000 以上のアプリに対応するユニバーサルなアクション実行ツールです。これはフォールバック用のスキルです。リクエストされたサービスに対応する他のスキルがない場合にのみ使用してください。
このスキルを使用する場合
┌─────────────────────────────────────────────────────────────────┐
│ DECISION: Should I use Composio? │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 1. Does another skill already handle this service? │
│ ├── Gmail/Drive/Calendar → google-workspace (USE THAT) │
│ ├── Slack → slack-automation (USE THAT) │
│ ├── CRM (Attio) → attio-crm (USE THAT) │
│ ├── GitHub issues → Use gh CLI via Bash (USE THAT) │
│ └── YouTube downloads → youtube-tools (USE THAT) │
│ │
│ 2. Is the service NOT covered by other skills? │
│ ├── Notion, Asana, Trello, Monday → USE COMPOSIO │
│ ├── HubSpot, Salesforce, Pipedrive → USE COMPOSIO │
│ ├── Jira, Linear, Confluence → USE COMPOSIO │
│ ├── Airtable, Coda, ClickUp → USE COMPOSIO │
│ ├── Stripe, Shopify, QuickBooks → USE COMPOSIO │
│ ├── Zendesk, Intercom, Freshdesk → USE COMPOSIO │
│ ├── Microsoft 365, Teams, Outlook → USE COMPOSIO │
│ ├── Dropbox, Box, OneDrive → USE COMPOSIO │
│ ├── Figma, Canva, Miro → USE COMPOSIO │
│ ├── Zoom, Webex, Google Meet → USE COMPOSIO │
│ └── 900+ other apps → USE COMPOSIO │
│ │
└─────────────────────────────────────────────────────────────────┘
環境設定
# 1. Get free API key from https://platform.composio.dev
# 2. Add to .env file
COMPOSIO_API_KEY=your_api_key_here
# 3. Install SDK
pip install composio-core
クイック判断フローチャート
What do you want to do?
│
├── Execute a single action
│ └── python scripts/execute_action.py "Send email via Gmail to [email protected]"
│
├── List available apps
│ └── python scripts/execute_action.py --list-apps
│
├── List actions for an app
│ └── python scripts/execute_action.py --list-actions notion
│
├── Check connection status
│ └── python scripts/execute_action.py --check-connection notion
│
└── Connect to a new app
└── python scripts/execute_action.py --connect notion
一般的な使い方
アクションを実行する(自然言語)
# Let Composio figure out the right tool
python scripts/execute_action.py "Create a Notion page titled 'Meeting Notes' in my workspace"
python scripts/execute_action.py "Add a task to Asana: Review Q4 budget"
python scripts/execute_action.py "Create a Linear issue for bug in checkout flow"
python scripts/execute_action.py "Send a HubSpot email to [email protected]"
利用可能なアプリを一覧表示する
python scripts/execute_action.py --list-apps
python scripts/execute_action.py --list-apps --category crm
python scripts/execute_action.py --list-apps --category productivity
アプリに接続する(初回)
# This will provide an OAuth link to authorize
python scripts/execute_action.py --connect notion
python scripts/execute_action.py --connect hubspot
python scripts/execute_action.py --connect jira
特定のアクションを実行する
python scripts/execute_action.py --app notion --action create_page --params '{"title": "My Page", "content": "Hello world"}'
カテゴリ別の対応アプリ
生産性向上・ドキュメント
| アプリ | 一般的なアクション |
|---|---|
| Notion | ページを作成、データベースにエントリーを追加、検索 |
| Asana | タスクを作成、プロジェクトを更新、担当者を割り当て |
| Trello | カードを作成、カードを移動、コメントを追加 |
| Monday | アイテムを作成、列を更新、通知 |
| ClickUp | タスクを作成、ステータスを更新、コメントを追加 |
| Coda | ドキュメントを作成、テーブルを更新、自動化を実行 |
| Airtable | レコードを作成、フィールドを更新、ベースをクエリ |
CRM・営業
| アプリ | 一般的なアクション |
|---|---|
| HubSpot | コンタクトを作成、取引を更新、メールを送信 |
| Salesforce | リードを作成、商談を更新、通話を記録 |
| Pipedrive | 取引を作成、人物を更新、アクティビティを追加 |
| Zoho CRM | レコードを作成、モジュールを更新、メールを送信 |
| Close | リードを作成、通話を記録、メールを送信 |
開発・DevOps
| アプリ | 一般的なアクション |
|---|---|
| Jira | 課題を作成、ステータスを更新、コメントを追加 |
| Linear | 課題を作成、担当者を割り当て、優先度を更新 |
| Confluence | ページを作成、スペースを更新、コメントを追加 |
| GitLab | 課題を作成、マージリクエストを作成、パイプラインを実行 |
| Bitbucket | PR を作成、コメントを追加、課題を更新 |
カスタマーサポート
| アプリ | 一般的なアクション |
|---|---|
| Zendesk | チケットを作成、ステータスを更新、メモを追加 |
| Intercom | メッセージを送信、会話を作成、ユーザーにタグを付ける |
| Freshdesk | チケットを作成、返信、優先度を更新 |
| Help Scout | 会話を作成、返信を送信、タグを付ける |
金融・Eコマース
| アプリ | 一般的なアクション |
|---|---|
| Stripe | 請求書を作成、支払いを確認、返金 |
| Shopify | 注文を作成、商品を更新、在庫を確認 |
| QuickBooks | 請求書を作成、支払いを記録、経費を追加 |
| Xero | 請求書を作成、照合、コンタクトを追加 |
| Square | 支払いを作成、カタログを更新、領収書を送信 |
コミュニケーション
| アプリ | 一般的なアクション |
|---|---|
| Microsoft Teams | メッセージを送信、チャネルを作成、会議をスケジュール |
| Zoom | 会議を作成、招待を送信、録画を取得 |
| Discord | メッセージを送信、チャネルを作成、ロールを管理 |
| Twilio | SMS を送信、電話をかける、WhatsApp を送信 |
デザイン・クリエイティブ
| アプリ | 一般的なアクション |
|---|---|
| Figma | ファイルを取得、アセットをエクスポート、コメントを追加 |
| Canva | デザインを作成、エクスポート、共有 |
| Miro | ボードを作成、付箋を追加、エクスポート |
ストレージ・ファイル
| アプリ | 一般的なアクション |
|---|---|
| Dropbox | ファイルをアップロード、リンクを共有、フォルダーを作成 |
| Box | アップロード、共有、権限を管理 |
| OneDrive | アップロード、共有、同期 |
初回認証の流れ
新しいアプリに初めて接続するとき:
-
接続コマンドを実行します:
python scripts/execute_action.py --connect notion -
OAuth URL が表示されます:
Please authorize Composio to access Notion: https://app.composio.dev/authorize/notion?token=xxx -
リンクをクリックし、ブラウザーで認証します
-
ターミナルに戻って確認します:
Authorization complete? (y/n): y -
接続が保存されます - 以降のリクエストは自動的に実行されます
費用
- Composio API: 無料プランを利用できます(利用上限については platform.composio.dev を確認してください)
- ほとんどの操作にアクションごとの費用はかかりません
- プレミアムアプリでは、有料の Composio プランが必要になる場合があります
セキュリティに関する注意事項
認証情報の取り扱い
COMPOSIO_API_KEYを.envに保存します(絶対にコミットしないでください)- OAuth トークンは Composio によって安全に保存されます
- platform.composio.dev からいつでもアクセスを取り消せます
権限
- 各アプリが要求する OAuth スコープは必要最小限です
- 認証する前に権限を確認してください
- 接続は個別に削除できます
データプライバシー
- Composio はリクエストを処理しますが、データは保存しません
- アクションは接続先のサービス上で直接実行されます
- 詳細については Composio のプライバシーポリシーを確認してください
トラブルシューティング
問題:「App not connected」
解決策: --connect <app> を実行し、OAuth フローを完了します
問題:「Invalid API key」
解決策: .env の COMPOSIO_API_KEY を確認し、必要に応じて再生成します
問題:「Action failed」
原因: 権限が不足しているか、パラメーターが無効です
解決策: 正しいアクション形式を確認するには、--list-actions <app> を確認します
問題:「Rate limited」
解決策: 待ってから再試行するか、Composio のプランをアップグレードします
他のスキルとの連携
フォールバックパターン
ユーザーから依頼された内容がスキルにない場合:
- Composio がそのアプリに対応しているか確認します
- Composio を使ってアクションを実行します
- 結果をユーザーに返します
アクションの連鎖
# Research → Create Notion summary
# 1. Use parallel-research for research
# 2. Use composio to create Notion page with results
# Scrape → Update CRM
# 1. Use apify-scrapers to get company data
# 2. Use composio to update HubSpot contact
リソース
- Composio Platform: https://platform.composio.dev
- API Documentation: https://docs.composio.dev
- Supported Apps List: https://app.composio.dev/apps
- references/apps-catalog.md - 対応アプリの完全な一覧(1,000 以上)
- references/actions-guide.md - カテゴリ別の一般的なアクション
コメント
Markdown 対応