keap-automation

keap-automation skill 概览

keap-automation 能做什么

keap-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行 Keap CRM 操作。它的核心价值不在于提供一段固定的 Keap 脚本，而是引导 agent 先发现当前可用的 Keap tool schemas，验证连接状态，然后再使用正确的 tool names 和必填字段执行 CRM 动作。

当你希望 agent 协助处理 Keap 联系人、CRM、营销或销售运营任务，同时又不想让它凭记忆猜测 API 参数时，就适合使用 keap-automation skill。

最适合 CRM Operations 团队

keap-automation skill 最适合已经在使用 Keap，并希望通过 MCP 引入 AI 辅助工作流的 CRM Operations、RevOps、自动化搭建人员和支持团队。尤其是在任务依赖实时 tool 可用性的场景下，它很有价值，因为该 skill 明确要求在执行前先调用 RUBE_SEARCH_TOOLS。

适合的任务包括：找到正确的 Keap 操作、检查当前 Keap 连接、准备结构化输入，并且只在 schema 已知后再运行工作流。

它与通用 prompt 的区别

通用 prompt 可能只是让 Claude “update Keap contacts”，然后依赖它假设字段名。keap-automation 会把 agent 推向更安全的执行顺序：

• 使用 RUBE_SEARCH_TOOLS 发现 tools
• 使用 RUBE_MANAGE_CONNECTIONS 管理或验证 Keap 连接
• 使用返回的 schemas，而不是编造参数
• 在发现和执行之间保留 session context

这种“先发现、后执行”的模式，是它最主要的差异点，也是采用它的主要理由。

安装前需要考虑的事项

这个 skill 需要 Rube MCP 和一个可用的 Keap 连接。它不适合作为离线 Keap 参考资料，也不包含 SKILL.md 之外的支持脚本、示例或额外参考文件。如果你的 client 无法连接 MCP tools，或者 Keap auth 无法完成，这个 skill 就不能执行真实操作。

如何使用 keap-automation skill

keap-automation 安装上下文

从 Composio skill collection 安装该 skill，然后在你的 AI client 中配置 Rube MCP。仓库路径是 composio-skills/keap-automation，建议首先阅读的关键文件是 SKILL.md。

典型安装命令如下：

npx skills add ComposioHQ/awesome-claude-skills --skill keap-automation

然后在 client 配置中添加 https://rube.app/mcp 作为 MCP server。上游 skill 说明 MCP endpoint 本身不需要 API key，但 Keap 仍然必须通过 Rube 完成连接。

第一次运行工作流前的必要设置

在请求 Keap 操作之前，先确认以下条件：

1. RUBE_SEARCH_TOOLS 可用。
2. RUBE_MANAGE_CONNECTIONS 可以检查 toolkit keap。
3. Keap connection status 为 ACTIVE。
4. agent 在调用执行 tool 之前，已经针对具体 use case 做过搜索。

这个 skill 最重要的操作规则是：始终先调用 RUBE_SEARCH_TOOLS。这很关键，因为 Composio tool slugs、必填字段和推荐执行计划都可能发生变化。

把粗略目标改写成高质量 prompt

较弱的 prompt：

“Update my Keap contacts.”

更适合 keap-automation 使用的 prompt：

“Use the keap-automation skill. First call RUBE_SEARCH_TOOLS for the use case ‘find or update Keap contact by email and add a tag’. Check the Keap connection with RUBE_MANAGE_CONNECTIONS. If active, show me the required schema before executing. Contact email: [email protected]. Desired change: add tag Webinar Lead. Do not create a duplicate contact unless the discovered tool explicitly supports safe upsert behavior.”

这个更强的 prompt 能提升输出质量，因为它同时给出了业务目标、查找键、预期变更、重复记录处理约束和权限边界。

建议遵循的实际工作流

每次 session 都应从 tool discovery 开始，并使用与你的实际任务完全匹配的描述，而不是笼统短语。例如，搜索 “create Keap contact with phone and company”、“list Keap contacts by tag” 或 “update opportunity stage”，而不是只搜索 “Keap operations”。

发现 tools 之后，让 agent 总结：

• selected tool slug
• required inputs
• 值得设置的 optional inputs
• 风险或缺失字段
• 连接是否 active
• proposed execution step

只有在 schema 和目标记录都清楚之后，再批准执行。对于批量更新、打标签、加入 campaign 以及创建联系人等操作，这一点尤其重要，因为一个小字段错误就可能影响大量 CRM 记录。

keap-automation skill 常见问题

keap-automation 运行需要什么？

它需要一个支持 MCP 的 client，在 https://rube.app/mcp 配置 Rube MCP，能够访问 RUBE_SEARCH_TOOLS，并且通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit keap 管理一个 active Keap connection。

缺少这些条件时，该 skill 可以解释工作流，但无法执行实时 Keap 操作。

keap-automation 适合新手吗？

如果用户清楚自己的 Keap 目标，它对新手是友好的；但它不是一键式 CRM 自动化产品。用户应能描述目标记录、期望变更，以及该操作是只读还是允许写入。新手在批准任何更改前，应要求 agent 展示发现到的 schema 和执行计划。

什么时候不应该使用这个 skill？

当你需要的是静态 Keap 教程、Rube MCP 之外的自定义集成，或不经过实时发现就能保证准确的 Keap API 字段列表时，不应使用 keap-automation。如果要进行大规模破坏性更新，也应避免直接使用，除非你能提供过滤条件、record IDs、回滚预期和审核步骤。

它和直接使用 Keap 有什么不同？

Keap 的 UI 更适合人工复核和可视化工作流。keap-automation skill 更适合让 agent 把运营目标转换为正确的 Composio/Rube tool call，尤其适用于重复性的 CRM 任务。它能减少 schema 猜测，但不能替代人工对敏感 CRM 变更的审批。

如何改进 keap-automation skill 的使用效果

让 keap-automation prompt 更具体

提升结果质量最快的方法，是提供准确的运营上下文。包括对象类型、查找方式、要修改的字段、允许的副作用，以及 agent 应该直接执行还是只做准备。

更强的输入模式：

• “Object: contact”
• “Lookup: email”
• “Action: add tag”
• “If not found: report only”
• “Before execution: show schema and selected tool”
• “After execution: summarize changed record IDs”

这些信息能让 skill 有足够上下文选择更安全的 tools，并避免含糊的 CRM 操作。

需要避免的常见失败模式

最主要的失败模式是跳过 discovery，直接假设 tool arguments。可以通过明确说明来避免：“Search tools first and use the returned schema.”

其他常见问题包括 Keap auth 未激活、记录匹配条件模糊、意外创建重复联系人，以及未预览过滤条件就批准批量变更。对于写操作，只要发现到的 tools 支持，就应要求 agent 在执行前确认目标数量。

根据第一次输出继续迭代

拿到第一版计划后，如果有任何不清楚的地方，不要直接批准。可以继续追问：

• “Which required fields are still missing?”
• “Can this tool update by email, or does it require contact ID?”
• “Will this create a contact if no match is found?”
• “What is the safest read-only check before the write step?”

这些问题能改进执行路径，并降低 CRM 数据质量风险。

用正确预期阅读仓库

阅读 keap-automation guide 时，应先看 SKILL.md，重点关注名为 Prerequisites、Setup、Tool Discovery 和 Core Workflow Pattern 的部分。当前 skill package 中没有额外脚本或参考文件夹，因此大部分实际行为都来自严格遵循文档中的 Rube MCP sequence，而不是本地代码。