awesome-claude-skills 之 Keap 自动化：基于 Rube MCP（Composio）的 CRM 工作流实战指南

• AI 技能
• AI 插件
• 人工智能
• 工作流自动化

本指南围绕仓库中 keap-automation 技能 展开，讲解如何通过 Rube MCP（Composio 的统一 MCP 网关）驱动 Composio 的 Keap Toolkit，让 Claude 直接对 Keap 客户关系管理系统执行联系人与交易等自动化操作。读完本文，你将掌握从 MCP 连接、工具发现、连接状态校验到工具执行与批量操作的完整可复制流程，并了解 schema 漂移、分页与会话复用等生产环境关键注意事项。

技能定位与适用场景

Keap（原 Infusionsoft）是面向小型企业的 CRM 与自动化营销平台。本技能的价值在于：不再让 Claude 停留在"生成一段描述性文字"，而是通过标准化的 MCP 工具调用链，直接对真实业务数据执行操作——例如创建联系人、更新客户信息、跟进交易、维护营销自动化流程。

该技能属于仓库中 "App Automation via Composio" 分类下 78 个预构建工作流技能之一。根据 README.md 的说明，这类技能均基于 Rube MCP（Composio）编写，每个技能都包含工具调用序列、参数指导、已知陷阱（Known Pitfalls）和快速参考表（Quick Reference），所有工具 slug 均来自 Composio API 的真实返回结果，而非凭空捏造。

技能的元数据定义如下：

--- name: keap-automation description: "Automate Keap tasks via Rube MCP (Composio). Always search tools first for current schemas." requires: mcp: [rube] ---

两个关键信息值得注意：

• description明确要求"Always search tools first for current schemas"——即执行任何工作流前必须先查询工具，这是整个技能的第一原则；
• requires.mcp: [rube]声明该技能依赖名为rube的 MCP 服务器，后续所有工具调用都建立在 Rube MCP 已连接的基础上。

前置条件

在运行任何 Keap 自动化工作流之前，需要满足三个前置条件：

1. Rube MCP 已连接：确认RUBE_SEARCH_TOOLS工具可用（对应环境中的RUBE_SEARCH_TOOLSMCP 工具存在且能正常响应）；
2. Keap 连接处于激活状态：通过RUBE_MANAGE_CONNECTIONS使用keaptoolkit 建立连接，且连接状态必须为ACTIVE；
3. 始终先调用RUBE_SEARCH_TOOLS：以获取当前最新的工具 schemas，避免因 schema 变更导致调用失败。

环境搭建：接入 Rube MCP

Rube MCP 的接入方式极为轻量，无需申请 API Key：

在客户端配置中将https://rube.app/mcp添加为 MCP 服务器，添加端点后即可直接使用，无需额外 API Key。

添加完成后，按以下顺序完成连通性验证：

1. 调用RUBE_SEARCH_TOOLS，确认其正常响应；
2. 调用RUBE_MANAGE_CONNECTIONS，指定 toolkit 为keap；
3. 若连接状态不是ACTIVE，按返回的授权链接完成 OAuth/授权设置；
4. 连接状态确认ACTIVE后再运行任何工作流。

工具发现：一切操作的前置动作

由于 Composio 的 Keap 工具 schemas 会随上游 API 演进而变化，技能强制要求在工作流执行前先做工具发现。标准发现调用如下：

RUBE_SEARCH_TOOLS queries: [{use_case: "Keap operations", known_fields: ""}] session: {generate_id: true}

该调用会返回：

• 可用工具的tool slugs（后续执行阶段直接引用）；
• 每个工具的输入 schema（字段名、类型、必填项）；
• 推荐的执行计划（execution plans）；
• 已知的陷阱提示（known pitfalls）。

这意味着你把具体的 Keap 业务诉求（如"为某个联系人创建一条备注""查询某个交易的状态"）放入use_case后，返回结果本身就是一份针对当前 schema 的可执行说明书。

核心工作流模式

技能定义了三步式工作流，这也是所有 Composio 自动化技能通用的执行骨架。

Step 1：发现可用工具

将具体业务任务写入 use_case，复用已有会话 ID 以保持上下文连续：

RUBE_SEARCH_TOOLS queries: [{use_case: "your specific Keap task"}] session: {id: "existing_session_id"}

use_case描述越具体，返回的工具集合与执行计划越精准。例如查询"向 Keap 创建一条新联系人记录并分配负责人"，返回结果会直接给出创建联系人所需的 tool slug 与完整参数 schema。

Step 2：检查连接状态

执行任何工具前，确认 Keap 连接仍处于激活状态：

RUBE_MANAGE_CONNECTIONS toolkits: ["keap"] session_id: "your_session_id"

这一步防止出现"工具已发现、连接已过期"导致的中途失败。若返回状态非ACTIVE，应先重新授权再继续。

Step 3：执行工具

通过RUBE_MULTI_EXECUTE_TOOL批量执行发现阶段返回的工具：

RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: "TOOL_SLUG_FROM_SEARCH", arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: "your_session_id"

关键点：

• tool_slug必须严格取自RUBE_SEARCH_TOOLS的返回结果，禁止硬编码；
• arguments必须完全符合搜索返回的 schema（字段名与类型均需一致）；
• memory参数必须始终携带，即使为空也要传{}；
• 同一工作流内复用session_id，新工作流则生成新会话。

补充：批量操作与完整 schema

对于批量处理场景，可使用RUBE_REMOTE_WORKBENCH配合run_composio_tool()在远端工作台中执行；当某个工具的 schema 以schemaRef形式引用外部定义时，使用RUBE_GET_TOOL_SCHEMAS获取完整 schema。

已知陷阱（Known Pitfalls）

技能文档明确列出了生产环境中高频踩坑点，逐条对照执行可显著提升成功率：

其中"分页遗漏"尤其值得重视：Composio 的批量查询类工具（如联系人列表、交易列表）在数据量大时返回分页结果，若忽略分页 token 会导致数据残缺，进而引发后续决策或写入错误。

快速参考表

这张表覆盖了从"找工具"到"拿 schema"的完整链路，可直接作为 Agent 执行时的速查手册。

与仓库生态的关系

本技能不是孤立存在：它和composio-skills/目录下的 78 个 SaaS 自动化技能（如 Close、HubSpot、Salesforce 等 CRM 类技能）共用同一套 Rube MCP 基础设施与三步工作流骨架，只是toolkit与业务对象不同。若你同时接入了其他 Composio 技能，会发现本指南中的RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等工具调用模式可以无缝迁移。

进一步了解技能与应用的通用连接方式，可参考仓库根部的 connect 技能，它展示了通过 Composio Tool Router 让 Claude 跨越 1000+ 应用执行真实操作的整体机制；技能格式与安装方式（放入~/.config/claude-code/skills/）详见 README.md 的 Getting Started 章节。

小结

Keap 自动化的核心方法论可以浓缩为一句话：先发现，再连接，后执行。通过RUBE_SEARCH_TOOLS拿到当前真实 schema，通过RUBE_MANAGE_CONNECTIONS保证连接激活，通过RUBE_MULTI_EXECUTE_TOOL按 schema 执行——同时始终携带memory、复用会话、处理分页，即可构建稳定可靠的 Keap 自动化工作流。将该技能文件 composio-skills/keap-automation/SKILL.md 放入你的 Claude 环境后，Claude 便能在这些护栏约束下自主完成 Keap 客户运营任务。

• AI 技能
• AI 插件
• 人工智能
• 工作流自动化