Agentic Awesome Skills 实战：基于 Rube MCP 的 ActiveCampaign 自动化技能深度指南-港品优选

Agentic Awesome Skills 实战：基于 Rube MCP 的 ActiveCampaign 自动化技能深度指南

【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills

ActiveCampaign 是常用的 CRM 与营销自动化平台，而 AAS（Agentic Awesome Skills）仓库中的activecampaign-automation技能为 Agent（Claude、Codex 等）提供了一条可复用的自动化路径：通过 Rube MCP 暴露的 Composio ActiveCampaign 工具集，直接完成联系人管理、标签维护、列表订阅、自动化注册与联系人任务创建。本文以该技能的 SKILL.md 为骨架，逐条展开前置条件、连接流程、五大核心工作流的工具调用序列与关键参数，并结合技能文件结构规范补充元数据解读，帮助你在一线 Agent 工作流中准确、安全地使用这套自动化能力。

技能定位：一份 agent 可直接执行的 ActiveCampaign 操作手册

在 AAS 仓库中，activecampaign-automation是一份典型的社区来源（source: community）技能文件，风险等级标记为risk: critical，添加日期为2026-02-27。它的定位非常明确：把 ActiveCampaign CRM 与营销自动化的高频操作封装成一组工具调用序列，供 Agent 按图索骥执行。

技能的description字段直接说明了能力边界：

"Automate ActiveCampaign tasks via Rube MCP (Composio): manage contacts, tags, list subscriptions, automation enrollment, and tasks. Always search tools first for current schemas."

翻译过来即：通过 Rube MCP（底层是 Composio 的 ActiveCampaign toolkit）自动执行联系人、标签、列表订阅、自动化注册与任务五类操作，并且要求每次执行前先搜索工具以获取最新的 schema。这一"先搜后用"的原则贯穿整个技能，也是它与静态 API 文档最大的区别：工具参数可能随 Composio 侧更新而变化，Agent 不应凭记忆调用。

该技能的副本还同时存在于仓库的plugins/agentic-awesome-skills/skills/activecampaign-automation/SKILL.md，并且data/aas-v1/skill-content-index.v1.json中的技能内容索引也收录了它的元数据，说明它在 AAS 的插件分发面与目录索引面均已登记，属于被正式收录的目录技能。

前置条件：Rube MCP 连接与连接状态确认

使用本技能之前，必须满足三个前置条件，缺一不可：

Rube MCP 已连接：客户端配置中需要确认RUBE_SEARCH_TOOLS工具可用，这是后续一切操作的探针。
ActiveCampaign 连接已激活：通过RUBE_MANAGE_CONNECTIONS建立active_campaigntoolkit 的连接，且状态必须为 ACTIVE。
执行前先查 schema：每次操作前先调用RUBE_SEARCH_TOOLS获取当前工具参数定义，防止参数漂移。

建立连接的完整步骤

Rube MCP 的接入方式非常轻量——无需申请 API Key，只需在 MCP 客户端配置中添加https://rube.app/mcp端点即可。随后按以下四步完成 ActiveCampaign 连接：

调用RUBE_SEARCH_TOOLS，确认 Rube MCP 正常响应；
调用RUBE_MANAGE_CONNECTIONS，传入 toolkit 名称active_campaign；
若连接状态不是 ACTIVE，跟随返回的授权链接完成 ActiveCampaign 账号认证；
在运行任何工作流之前，再次确认连接状态显示 ACTIVE。

这一步是整个技能的地基：连接未激活时，后续所有ACTIVE_CAMPAIGN_*工具都会失败。Agent 在执行任务时应把状态确认作为强制的第一步，而不是跳过。

核心工作流一：创建与查找联系人

联系人是一切营销自动化操作的锚点，因此本技能将其列为第一工作流。

适用场景：用户需要新建联系人，或查询既有联系人。

工具调用序列：

步骤	工具	是否必需
1	`ACTIVE_CAMPAIGN_FIND_CONTACT`— 查找既有联系人	可选
2	`ACTIVE_CAMPAIGN_CREATE_CONTACT`— 创建新联系人	必需

FIND_CONTACT 关键参数：

email：按邮箱地址搜索；
id：按 ActiveCampaign 联系人 ID 搜索；
phone：按电话号码搜索。

CREATE_CONTACT 关键参数：

email：联系人邮箱（唯一必填项）；
first_name/last_name：联系人姓名；
phone：联系电话；
organization_name：所属组织；
job_title：职位；
tags：逗号分隔的标签列表，创建时立即生效。

实战要点与坑位：

创建联系人时email是唯一必填字段，其余均可省略；
电话搜索在底层走的是通用搜索参数，可能返回部分匹配结果，需要人工核对；
当在FIND_CONTACT中同时传email和phone时，结果是在客户端侧过滤的，不代表服务端精确匹配；
创建时传入的标签会被立即应用；
用已存在的邮箱创建联系人，可能触发对既有联系人的更新（upsert 语义），而不是报错——这在批量场景下既是便利也是风险。

核心工作流二：管理联系人标签

标签是 ActiveCampaign 中组织联系人、触发自动化的核心机制。

适用场景：用户需要给联系人添加或移除标签。

工具调用序列：

ACTIVE_CAMPAIGN_FIND_CONTACT— 按邮箱或 ID 找到联系人（前置）；
ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG— 添加或移除标签（必需）。

关键参数：

action：'Add'或'Remove'（必填）；
tags：标签名，可以是逗号分隔字符串或字符串数组（必填）；
contact_id：联系人 ID（与contact_email二选一）；
contact_email：联系人邮箱（contact_id的替代项）。

实战要点与坑位：

action取值是首字母大写的'Add'/'Remove'，传小写会报错；
tags支持两种形态：'tag1, tag2'（字符串）或['tag1', 'tag2']（数组）；
contact_id与contact_email必须提供其一，且contact_id优先级更高；
添加一个不存在的标签会自动创建它——这意味着拼写错误会悄悄引入脏标签；
移除不存在的标签是 no-op，不会报错，可放心执行。

核心工作流三：管理列表订阅

列表（List）是 ActiveCampaign 邮件营销的基本单元，订阅/退订是高频操作。

适用场景：用户需要将联系人订阅或退订某个列表。

工具调用序列：

ACTIVE_CAMPAIGN_FIND_CONTACT— 先找到联系人（前置）；
ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION— 订阅或退订（必需）。

关键参数：

action：'subscribe'或'unsubscribe'（必填）；
list_id：数字形式的列表 ID 字符串（必填）；
email：联系人邮箱（与contact_id二选一）；
contact_id：数字形式的联系人 ID 字符串。

实战要点与坑位：

与标签操作相反，订阅的action取值是全小写的'subscribe'/'unsubscribe'——两套工作流的字母大小写约定不同，是最容易踩的坑；
list_id必须是数字字符串（如'2'），不能传列表名称；
列表 ID 可通过 ActiveCampaign 的GET /api/3/lists接口获取，但该接口并未封装为 Composio 工具，实际中需要通过 ActiveCampaign UI 查看；
同时传email与contact_id时，contact_id优先；
退订操作会把状态置为'2'（unsubscribed），但联系人-列表的关系记录仍然保留，可用于后续重新订阅或审计。

核心工作流四：将联系人加入自动化

自动化（Automation）是 ActiveCampaign 营销流程的引擎，本工作流负责把联系人登记进已有自动化。

适用场景：用户希望将联系人注册到某个自动化工作流中。

工具调用序列：

ACTIVE_CAMPAIGN_FIND_CONTACT— 确认联系人存在（前置）；
ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION— 注册联系人（必需）。

关键参数：

contact_email：待注册联系人的邮箱（必填）；
automation_id：目标自动化的 ID（必填）。

实战要点与坑位：

联系人必须已存在于 ActiveCampaign，该工具不会隐式创建联系人；
自动化只能通过 ActiveCampaign UI 创建，API 无法创建——Agent 只能做注册动作；
automation_id必须指向一个已存在且处于激活状态的自动化；
该工具内部是两步过程：先按邮箱查找联系人，再执行注册，因此查找失败会导致整次调用失败；
自动化 ID 可从 ActiveCampaign UI 查看，或通过GET /api/3/automations接口获取；
把已在该自动化中的联系人再次注册，通常不会有任何效果（幂等），不应将其当作错误处理。

核心工作流五：创建联系人任务

任务（Task）用于跟进联系人，适合销售与客户成功场景的后续动作管理。

适用场景：用户需要为联系人创建跟进任务。

工具调用序列：

ACTIVE_CAMPAIGN_FIND_CONTACT— 找到要关联任务的联系人（前置）；
ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK— 创建任务（必需）。

关键参数：

relid：要关联的联系人 ID（必填，注意是数字 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是字符串形式的 ID，引用的是 ActiveCampaign 中配置好的任务类型；
relid是数字联系人 ID，不是邮箱地址，传错会导致任务挂错对象；
assignee是用户 ID，用户名到 ID 的映射需要到 ActiveCampaign UI 中解析。

常见组合模式：让多步骤操作更高效

单个工作流之外，技能还给出了三个可直接套用的组合模式。

联系人查找流程（Get-or-Create）

1. 调用 ACTIVE_CAMPAIGN_FIND_CONTACT 传入 email 2. 若找到，提取 contact ID 供后续操作复用 3. 若未找到，用 ACTIVE_CAMPAIGN_CREATE_CONTACT 创建 4. 用得到的 contact ID 执行标签、订阅或自动化操作

这是所有联系人相关任务的标准入口，先查后建，避免重复创建。

批量联系人打标签

1. 对每个联系人调用 ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG 2. 优先使用 contact_email，省去单独的查找调用 3. 批量操作之间保留合理间隔，遵守速率限制

注意：批量场景下用contact_email直接驱动标签操作，可以显著减少 API 往返次数，但代价是失去了显式的联系人存在性校验——是否可接受取决于业务对数据质量的容忍度。

ID 解析（邮箱转联系人 ID）

1. 调用 ACTIVE_CAMPAIGN_FIND_CONTACT 传入 email 2. 从响应中提取 id 字段

后续需要数字 ID 的场合（如创建任务、订阅列表）都依赖这一步先完成解析。

已知陷阱全景：踩坑清单与防御策略

技能在末尾集中总结了五类高频陷阱，堪称本技能最有价值的部分：

1. action 大小写约定不一致

标签操作：'Add'、'Remove'（首字母大写）；
订阅操作：'subscribe'、'unsubscribe'（全小写）；
混用大小写会直接导致调用错误。Agent 应在代码中为两类工具分别定义常量，而不是复用同一个枚举。

2. ID 一律使用字符串

联系人 ID、列表 ID、自动化 ID 都是数字字符串（如'123'）；
所有 ID 都应作为字符串传递，而不是整数，避免类型不匹配导致的序列化问题。

3. 自动化的能力边界

自动化不能通过 API 创建，只能做注册；
自动化必须处于激活状态才能接收新联系人；
重复注册已在自动化中的联系人可能无效果。

4. 速率限制

ActiveCampaign API 对每个账号有速率限制；
遇到429响应必须实现退避（backoff）重试；
批量操作之间要适当间隔，避免触发限流。

5. 响应解析要防御式

响应数据可能嵌套在data或data.data下，解析时要做兜底；
联系人搜索可能返回多条结果，应严格按 email 精确匹配，而不是直接取第一条。

快速参考：六项核心操作速查表

任务	工具 Slug	关键参数
查找联系人	`ACTIVE_CAMPAIGN_FIND_CONTACT`	email, id, phone
创建联系人	`ACTIVE_CAMPAIGN_CREATE_CONTACT`	email, first_name, last_name, tags
添加/移除标签	`ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG`	action, tags, contact_email
订阅/退订	`ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION`	action, list_id, email
加入自动化	`ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION`	contact_email, automation_id
创建任务	`ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK`	relid, duedate, dealTasktype, title

这张表也是 Agent 判断任务与工具匹配度的索引：接到用户请求时，先定位任务类型，再按对应工具的参数要求组装调用。

从 SKILL.md 结构看技能元数据

这份技能的 frontmatter 遵循了 AAS 仓库统一的技能文件规范（详见 docs/contributors/skill-anatomy.md）：

--- name: activecampaign-automation description: "Automate ActiveCampaign tasks via Rube MCP (Composio): ..." risk: critical source: community date_added: "2026-02-27" ---

其中各字段的含义在仓库规范中有明确界定：

name：技能标识符，使用小写加连字符格式，且必须与所在文件夹名一致——这里为activecampaign-automation；
description：一句话摘要，被生成索引和目录面（catalog）作为搜索与选择依据；
risk：安全分级，取值包括none/safe/critical/offensive/unknown。本技能标记为critical，意味着它涉及对外部业务系统（CRM）的写入型操作，Agent 在引用时应意识到这类操作的影响面；
source：来源分类，这里为community，表示由社区提交；
date_added：入库日期2026-02-27，用于目录面的时间追踪。

技能的正文部分则遵循"先说明适用场景（When to Use），再给工具序列与参数，最后列限制条件（Limitations）"的组织方式。data/aas-v1/skill-content-index.v1.json中的内容索引进一步证明该技能文件已被 AAS 的目录索引体系正式收录，可作为 Agent 本地目录检索的一部分被引用。

使用边界与准则

技能自身明确划定了使用边界：

仅在任务与该技能概述描述的范围明确匹配时使用，不要跨界用它处理其他 CRM 操作；
技能的输出不能替代针对具体环境的验证、测试或专家评审——每个账号的列表、自动化、任务类型配置都可能不同；
当必需的输入、权限、安全边界或成功标准缺失时，应当停下来向用户询问澄清，而不是猜测参数继续执行。

结合前置条件的"先搜 schema"原则，一个稳健的 Agent 执行模板应当是：确认 Rube MCP 与 ActiveCampaign 连接处于 ACTIVE → 调用RUBE_SEARCH_TOOLS拉取最新工具定义 → 按快速参考表匹配任务 → 严格按参数约定（大小写、字符串 ID、ISO 8601 时间）组装调用 → 对429退避、对嵌套响应防御式解析 → 对关键写入动作保留审计信息。

小结

activecampaign-automation这份技能的价值在于它把 ActiveCampaign 的六类高频操作沉淀成了一套"工具序列 + 参数约定 + 陷阱清单"的完整执行契约。对于想要在 Agent 工作流中集成 ActiveCampaign 自动化能力的开发者，建议直接以 SKILL.md 为模板落地实现，重点关注三类容易出错的约定：action 大小写、ID 字符串化、ISO 8601 带时区时间；同时始终把RUBE_SEARCH_TOOLS前置查询作为执行的铁律，以对抗工具 schema 的版本漂移。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析