Communitygithub.com

ActiveCampaign 自動化 via Rube MCP

Composio の ActiveCampaign ツールキットを介し、Rube MCP を使って ActiveCampaign の CRM とマーケティング自動化の操作を自動化します。

ActiveCampaign 自動化 via Rube MCP とは?

このスキルは、Rube MCP を介して Composio の ActiveCampaign ツールキットを使用し、ActiveCampaign での CRM およびマーケティング自動化タスクを自動化できるようにします。その目的は、連絡先の作成、タグの管理、リストへの登録・解除、自動化への登録、タスクの作成といった一般的なワークフローを効率化することです。このスキルは Rube MCP サーバーに依存しており、最初に `RUBE_SEARCH_TOOLS` を呼び出して現在のツールスキーマを取得し、`RUBE_MANAGE_CONNECTIONS` を使用してアクティブな ActiveCampaign 接続を確保する必要があります。Core Workflows のセクションでは、各操作の必要なツール、パラメータ、落とし穴をまとめ、アクションの大文字小文字の違いやレート制限、ID 解決など、さまざまな落とし穴を網羅した Know Pitfalls セクションもあります。使い方としては、まず連絡先を検索または作成し、その ID を使ってタグの追加・削除、リストへの登録、自動化への追加、タスクの作成を行います。開発者は、このスキルを使用する際には、常に最初に現在のツールスキーマを取得し、環境変数や接続が正しく設定されていることを確認する必要があります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/activecampaign-automation

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ActiveCampaign 自動化 via Rube MCP は何をしますか?

Composio の ActiveCampaign ツールキットを介し、Rube MCP を使って ActiveCampaign CRM とマーケティング自動化の操作を自動化します。

前提条件

  • Rube MCP が接続されていること(RUBE_SEARCH_TOOLS が利用可能であること)
  • RUBE_MANAGE_CONNECTIONS で active_campaign ツールキットを使用した ActiveCampaign 接続がアクティブであること
  • 最初に必ず RUBE_SEARCH_TOOLS を呼び出して、現在のツールスキーマを取得すること

セットアップ

Rube MCP の取得: クライアント設定で MCP サーバーとして https://rube.app/mcp を追加します。API キーは不要で、エンドポイントを追加するだけで動作します。

  1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを確認します。
  2. ツールキット active_campaign を指定して RUBE_MANAGE_CONNECTIONS を呼び出します。
  3. 接続がアクティブでない場合は、返された認証リンクに従って ActiveCampaign の認証を完了します。
  4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します。

コアワークフロー

1. 連絡先の作成と検索

いつ使用するか: ユーザーが新しい連絡先を作成したり、既存の連絡先を検索したい場合

ツールの順序:

  1. ACTIVE_CAMPAIGN_FIND_CONTACT - 既存の連絡先を検索します [オプション]
  2. ACTIVE_CAMPAIGN_CREATE_CONTACT - 新しい連絡先を作成します [必須]

検索の主要パラメータ:

  • email: メールアドレスで検索
  • id: ActiveCampaign の連絡先 ID で検索
  • phone: 電話番号で検索

作成の主要パラメータ:

  • email: 連絡先のメールアドレス(必須)
  • first_name: 連絡先の名
  • last_name: 連絡先の姓
  • phone: 連絡先の電話番号
  • organization_name: 連絡先の組織
  • job_title: 連絡先の役職
  • tags: 適用するタグのカンマ区切りリスト

落とし穴:

  • 連絡先作成時に必須なのは email のみです
  • 電話番号検索は内部的に一般的な検索パラメータを使用するため、部分一致が返される場合があります
  • FIND_CONTACT で email と phone を組み合わせると、結果はクライアント側でフィルタリングされます
  • 作成時に指定したタグはすぐに適用されます
  • 既存のメールアドレスで連絡先を作成すると、既存の連絡先が更新される場合があります

2. 連絡先タグの管理

いつ使用するか: ユーザーが連絡先にタグを追加または削除したい場合

ツールの順序:

  1. ACTIVE_CAMPAIGN_FIND_CONTACT - メールアドレスまたは ID で連絡先を検索します [前提条件]
  2. ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG - タグを追加または削除します [必須]

主要パラメータ:

  • action: 'Add' または 'Remove'(必須)
  • tags: タグ名のカンマ区切り文字列または文字列の配列(必須)
  • contact_id: 連絡先 ID(これか contact_email のいずれかを指定)
  • contact_email: 連絡先のメールアドレス(contact_id の代替)

落とし穴:

  • action の値は大文字で 'Add' または 'Remove'(小文字ではありません)
  • タグはカンマ区切りの文字列('tag1, tag2')または配列(['tag1', 'tag2'])で指定できます
  • contact_id か contact_email のいずれか一方を指定する必要があります。contact_id が優先されます
  • 存在しないタグを追加すると、自動的に作成されます
  • 存在しないタグを削除しても何も起こりません(エラーにはなりません)

3. リスト購読の管理

いつ使用するか: ユーザーが連絡先をリストに登録または登録解除したい場合

ツールの順序:

  1. ACTIVE_CAMPAIGN_FIND_CONTACT - 連絡先を検索します [前提条件]
  2. ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION - 登録または登録解除します [必須]

主要パラメータ:

  • action: 'subscribe' または 'unsubscribe'(必須)
  • list_id: 数値のリスト ID 文字列(必須)
  • email: 連絡先のメールアドレス(これか contact_id のいずれかを指定)
  • contact_id: 数値の連絡先 ID 文字列(email の代替)

落とし穴:

  • action の値は小文字で 'subscribe' または 'unsubscribe' です
  • list_id は数値の文字列(例: '2')であり、リスト名ではありません
  • リスト ID は GET /api/3/lists エンドポイントで取得できます(Composio ツールとしては利用不可。ActiveCampaign UI を使用)
  • email と contact_id の両方が指定された場合、contact_id が優先されます
  • 登録解除するとステータスは '2'(登録解除)に変わりますが、リレーションシップレコードは残ります

4. 連絡先を自動化に追加

いつ使用するか: ユーザーが連絡先を自動化ワークフローに登録したい場合

ツールの順序:

  1. ACTIVE_CAMPAIGN_FIND_CONTACT - 連絡先が存在することを確認します [前提条件]
  2. ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION - 連絡先を自動化に登録します [必須]

主要パラメータ:

  • contact_email: 登録する連絡先のメールアドレス(必須)
  • automation_id: 対象の自動化の ID(必須)

落とし穴:

  • 連絡先は ActiveCampaign にすでに存在している必要があります
  • 自動化は API 経由では作成できず、ActiveCampaign UI でのみ作成可能です
  • automation_id は既存のアクティブな自動化を参照している必要があります
  • このツールは 2 段階のプロセスを実行します。連絡先をメールアドレスで検索し、その後登録します
  • 自動化 ID は ActiveCampaign UI または GET /api/3/automations で確認できます

5. 連絡先タスクの作成

いつ使用するか: ユーザーが連絡先に関連するフォローアップタスクを作成したい場合

ツールの順序:

  1. ACTIVE_CAMPAIGN_FIND_CONTACT - タスクを関連付ける連絡先を検索します [前提条件]
  2. ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK - タスクを作成します [必須]

主要パラメータ:

  • relid: タスクを関連付ける連絡先 ID(必須)
  • duedate: タイムゾーン付き ISO 8601 形式の期限日(必須、例: '2025-01-15T14:30:00-05:00')
  • dealTasktype: 利用可能なタイプに基づくタスクタイプ ID(必須)
  • title: タスクのタイトル
  • note: タスクの説明/内容
  • assignee: タスクを割り当てるユーザー ID
  • edate: ISO 8601 形式の終了日(duedate より後である必要があります)
  • status: 0 は未完了、1 は完了

落とし穴:

  • duedate は有効な ISO 8601 日時とタイムゾーンオフセットである必要があります。プレースホルダー値は使用しないでください
  • edate は duedate より後である必要があります
  • dealTasktype は ActiveCampaign で設定されたタスクタイプを参照する文字列 ID です
  • relid は数値の連絡先 ID であり、メールアドレスではありません
  • assignee はユーザー ID です。ユーザー名は ActiveCampaign UI で ID に解決します

共通パターン

連絡先検索フロー

1. メールアドレスで ACTIVE_CAMPAIGN_FIND_CONTACT を呼び出す
2. 見つかった場合、後続の操作のために連絡先 ID を抽出する
3. 見つからなかった場合、ACTIVE_CAMPAIGN_CREATE_CONTACT で連絡先を作成する
4. 連絡先 ID をタグ、購読、または自動化に使用する

一括タグ付け

1. 各連絡先について、ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG を呼び出す
2. 個別の検索呼び出しを避けるため、contact_email を使用する
3. レート制限を尊重するために、適切な遅延を入れてバッチ処理する

ID 解決

連絡先メールアドレス → 連絡先 ID:

1. メールアドレスで ACTIVE_CAMPAIGN_FIND_CONTACT を呼び出す
2. 応答から id を抽出する

既知の落とし穴

アクションの大文字小文字:

  • タグのアクション: 'Add'、'Remove'(大文字)
  • 購読のアクション: 'subscribe'、'unsubscribe'(小文字)
  • 大文字小文字を間違えるとエラーが発生します

ID の種類:

  • 連絡先 ID: 数値の文字列(例: '123')
  • リスト ID: 数値の文字列
  • 自動化 ID: 数値の文字列
  • すべての ID は整数ではなく文字列として渡す必要があります

自動化:

  • 自動化は API 経由では作成できません。登録のみ可能です
  • 新しい連絡先を受け入れるには、自動化がアクティブである必要があります
  • すでに自動化に登録されている連絡先を再度登録しても効果がない場合があります

レート制限:

  • ActiveCampaign API にはアカウントごとにレート制限があります
  • 429 応答に対してはバックオフを実装してください
  • バッチ操作は適切な間隔を空けて行う必要があります

応答の解析:

  • 応答データは data または data.data の下にネストされている場合があります
  • フォールバックパターンを使用して防御的に解析してください
  • 連絡先検索で複数の結果が返される場合があります。精度を高めるにはメールアドレスで照合します

クイックリファレンス

タスクツールスラッグ主要パラメータ
連絡先の検索ACTIVE_CAMPAIGN_FIND_CONTACTemail, id, phone
連絡先の作成ACTIVE_CAMPAIGN_CREATE_CONTACTemail, first_name, last_name, tags
タグの追加/削除ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAGaction, tags, contact_email
購読/購読解除ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTIONaction, list_id, email
自動化に追加ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATIONcontact_email, automation_id
タスクの作成ACTIVE_CAMPAIGN_CREATE_CONTACT_TASKrelid, duedate, dealTasktype, title

使用時

このスキルは、概要に記載されたワークフローやアクションを実行する場合に適用されます。

制限事項

  • タスクが上記の範囲に明確に一致する場合にのみ、このスキルを使用してください。
  • 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
  • 必要な入力、権限、安全境界、成功基準が不足している場合は、立ち止まって明確化を求めてください。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

関連スキル