keap-automation

keap-automation skill 概覽

keap-automation 的功能

keap-automation 是一個 Claude skill，可透過 Composio 的 Rube MCP server 執行 Keap CRM 操作。它的主要價值不在於提供固定的 Keap 腳本，而是教代理先探索目前可用的 Keap tool schema、確認連線狀態，再用正確的工具名稱與必要欄位執行 CRM 動作。

當你希望代理協助處理 Keap 聯絡人、CRM、行銷或銷售營運任務，又不想讓它憑記憶猜 API 參數時，就適合使用 keap-automation skill。

最適合 CRM Operations 團隊

keap-automation skill 最適合已經使用 Keap、並希望透過 MCP 導入 AI 輔助流程的 CRM Operations、RevOps、自動化建置者與支援團隊。當任務取決於即時工具可用性時，它特別有用，因為此 skill 明確要求在執行前先呼叫 RUBE_SEARCH_TOOLS。

適合的工作包括找出正確的 Keap 操作、檢查目前的 Keap 連線、準備結構化輸入，並且只在 schema 已確認後才執行 workflow。

和一般 prompt 的差異

一般 prompt 可能只是要求 Claude「更新 Keap contacts」，然後依賴它假設的欄位名稱。keap-automation 會把代理導向更安全的順序：

• 使用 RUBE_SEARCH_TOOLS 探索工具
• 使用 RUBE_MANAGE_CONNECTIONS 管理或確認 Keap 連線
• 使用回傳的 schema，而不是自行編造參數
• 在探索與執行之間保留 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。repository path 是 composio-skills/keap-automation，第一個應該閱讀的關鍵檔案是 SKILL.md。

典型的安裝指令如下：

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

接著在 client configuration 中加入 https://rube.app/mcp 作為 MCP server。上游 skill 說明指出，MCP endpoint 本身不需要 API key，但 Keap 仍必須透過 Rube 完成連線。

第一個 workflow 前的必要設定

在要求 Keap 動作之前，請先確認以下條件：

1. RUBE_SEARCH_TOOLS 可用。
2. RUBE_MANAGE_CONNECTIONS 可以檢查 toolkit keap。
3. Keap connection status 為 ACTIVE。
4. 代理已針對特定 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 都應從工具探索開始，而且要使用你的精確任務，而不是籠統描述。例如，搜尋 “create Keap contact with phone and company”、“list Keap contacts by tag” 或 “update opportunity stage”，不要只搜尋 “Keap operations”。

探索完成後，請要求代理摘要以下資訊：

• selected tool slug
• required inputs
• optional inputs worth setting
• risks or missing fields
• whether the connection is active
• proposed execution step

只有在 schema 與目標 records 都清楚後，才核准執行。這對 bulk updates、tagging、campaign enrollment 和 contact creation 特別重要，因為一個小欄位錯誤就可能影響大量 CRM records。

keap-automation skill 常見問題

keap-automation 執行需要什麼？

它需要支援 MCP 的 client、設定在 https://rube.app/mcp 的 Rube MCP、可使用 RUBE_SEARCH_TOOLS，以及透過 RUBE_MANAGE_CONNECTIONS 搭配 toolkit keap 管理的有效 Keap 連線。

缺少上述任一項，skill 可以說明 workflow，但無法執行即時 Keap 操作。

keap-automation 適合初學者嗎？

對於了解自己 Keap 目標的使用者來說，它算是容易上手；但它不是一鍵式 CRM 自動化產品。使用者應該能描述目標 record、想要的變更，以及此動作是 read-only 還是允許寫入。初學者應在核准任何變更前，要求代理顯示探索到的 schema 與 execution plan。

什麼情況不該使用這個 skill？

當你需要的是靜態 Keap 教學、Rube MCP 以外的自訂整合，或是不經即時探索就保證完整列出 Keap API 欄位時，不應使用 keap-automation。如果是大型破壞性更新，也應避免使用，除非你能提供 filters、record IDs、rollback expectations，以及 review step。

和直接使用 Keap 有什麼不同？

Keap UI 更適合手動審查與視覺化 workflow。keap-automation skill 則更適合讓代理把營運目標轉換成正確的 Composio/Rube tool call，尤其是重複性的 CRM 任務。它能減少 schema 猜測，但不能取代使用者對敏感 CRM 變更的人工核准。

如何改善 keap-automation skill

讓 keap-automation prompt 更具體

改善結果最快的方法，是提供精確的營運情境。請包含 object type、lookup method、要變更的 fields、允許的 side effects，以及代理應該執行還是只準備計畫。

更強的輸入模式：

• “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 取得足夠資訊，選擇更安全的工具，並避免模糊的 CRM 操作。

需要避免的常見失敗模式

最主要的失敗模式，是跳過探索並直接假設工具參數。要避免這點，請明確要求：“Search tools first and use the returned schema.”

其他常見問題包括 Keap auth 未啟用、record matching 太模糊、意外建立重複資料，以及未預覽 filters 就核准批次變更。對於寫入操作，只要探索到的工具允許，請要求代理在執行前確認 target count。

依據第一次輸出持續迭代

第一次拿到計畫後，如果有任何不清楚的地方，不要直接核准。可以追問：

• “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 資料品質風險。

用正確期待閱讀 repository

若要閱讀 keap-automation guide，請先看 SKILL.md，並聚焦在 Prerequisites、Setup、Tool Discovery 與 Core Workflow Pattern 這些章節。目前的 skill package 沒有額外 scripts 或 reference folders，因此大多數實務行為都來自於仔細遵循文件中的 Rube MCP sequence，而不是本機程式碼。