keap-automation

keap-automation skill の概要

keap-automation でできること

keap-automation は、Composio の Rube MCP server を通じて Keap CRM の操作を実行するための Claude skill です。価値の中心は、固定された Keap 用スクリプトではありません。まず現在利用できる Keap tool schemas を発見し、接続を確認したうえで、正しい tool 名と必須フィールドを使って CRM アクションを実行する手順をエージェントに徹底させる点にあります。

Keap の contact、CRM、マーケティング、営業オペレーション関連の作業を、API パラメータを記憶や推測に頼らずエージェントに支援させたいときに使います。

CRM Operations チームに向いているケース

keap-automation skill は、すでに Keap を使っていて、MCP 経由で AI 支援ワークフローを組みたい CRM Operations、RevOps、自動化担当者、サポートチームに特に向いています。実行前に必ず RUBE_SEARCH_TOOLS を使うことが明示されているため、利用可能な tool がその時点で何かに依存するタスクでとくに有効です。

相性のよい作業には、適切な Keap 操作の特定、現在の Keap 接続の確認、構造化された入力の準備、schema が判明してからワークフローを実行することなどがあります。

汎用プロンプトとの違い

汎用プロンプトでは、Claude に「Keap contacts を更新して」と依頼し、フィールド名を推測に頼ってしまうことがあります。keap-automation は、エージェントをより安全な順序に誘導します。

• RUBE_SEARCH_TOOLS で tools を発見する
• RUBE_MANAGE_CONNECTIONS で Keap 接続を管理または確認する
• 架空の引数ではなく、返された schemas を使う
• 発見から実行まで session context を維持する

この「発見を先に行う」パターンが、最大の違いであり、導入する主な理由です。

インストール前に確認したい導入条件

この skill には Rube MCP と有効な Keap 接続が必要です。オフラインの Keap リファレンスとしては有用ではなく、SKILL.md 以外にサポートスクリプト、例、追加の参照ファイルも含まれていません。クライアントが MCP tools に接続できない場合や、Keap の認証を完了できない場合、この skill は実際の操作を実行できません。

keap-automation skill の使い方

keap-automation のインストール前提

Composio skill collection から skill をインストールし、その後 AI クライアントで Rube MCP を設定します。repository path は composio-skills/keap-automation で、最初に読むべき重要ファイルは SKILL.md です。

一般的なインストールコマンドは次のとおりです。

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

次に、クライアント設定で 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. エージェントが execution tool を呼び出す前に、具体的なユースケースで検索している。

この skill の重要な運用ルールは、「必ず最初に RUBE_SEARCH_TOOLS を呼び出す」ことです。Composio の tool slugs、必須フィールド、推奨される実行計画は変わる可能性があるため、この手順が重要になります。

粗い目的を実行しやすいプロンプトに変える

弱いプロンプト:

“Update my Keap contacts.”

keap-automation を使う場合のより良いプロンプト:

“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.”

このように具体化すると、業務上の目的、検索キー、変更内容、重複処理の制約、実行許可の境界がエージェントに伝わるため、出力の質が上がります。

実務で使いやすいワークフロー

各セッションの最初に、広い言い方ではなく、実際のタスクに合わせて tool discovery を行います。たとえば単に “Keap operations” と検索するのではなく、“create Keap contact with phone and company”、“list Keap contacts by tag”、“update opportunity stage” のように検索します。

発見後、エージェントに次の内容を要約させます。

• 選択された tool slug
• 必須入力
• 設定する価値のある任意入力
• リスクまたは不足しているフィールド
• 接続が active かどうか
• 提案される実行ステップ

schema と対象レコードが明確になってから、実行を承認してください。これは bulk updates、tagging、campaign enrollment、contact creation で特に重要です。小さなフィールド指定の誤りが、多数の CRM レコードに影響する可能性があります。

keap-automation skill FAQ

keap-automation の実行に必要なものは？

MCP 対応クライアント、https://rube.app/mcp に設定された Rube MCP、RUBE_SEARCH_TOOLS へのアクセス、そして toolkit keap を指定した RUBE_MANAGE_CONNECTIONS で管理される有効な Keap 接続が必要です。

これらが揃っていない場合、skill はワークフローを説明することはできますが、Keap に対する実操作は実行できません。

keap-automation は初心者にも使いやすいですか？

Keap で何をしたいかを説明できるユーザーにとっては、初心者にも扱いやすい skill です。ただし、ワンクリックで完結する CRM 自動化製品ではありません。対象レコード、望む変更、操作が読み取り専用なのか書き込みを伴うのかを説明できる必要があります。初心者は、変更を承認する前に、発見された schema と実行計画をエージェントに表示させるべきです。

この skill を使わないほうがよい場合は？

静的な Keap チュートリアルが必要な場合、Rube MCP 外のカスタム連携が必要な場合、または live discovery なしで Keap API フィールドの確定リストがほしい場合は、keap-automation を使うべきではありません。また、大規模で破壊的な更新にも注意が必要です。filters、record IDs、rollback expectations、review step を提示できない場合は避けてください。

Keap を直接使う場合と何が違いますか？

手動確認や視覚的なワークフローには Keap の UI が適しています。keap-automation skill は、運用上の目的を正しい Composio/Rube tool call に変換したいとき、特に反復的な CRM タスクで有効です。schema の推測を減らせますが、機密性の高い CRM 変更に対する人間の承認を置き換えるものではありません。

keap-automation skill を改善する方法

keap-automation のプロンプトを具体化する

結果を改善する最短の方法は、正確な運用コンテキストを与えることです。object type、lookup method、変更する fields、許可される副作用、エージェントに実行までさせるのか準備だけさせるのかを含めます。

より強い入力パターン:

• “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 が inactive であること、レコード照合条件が曖昧であること、意図しない重複作成、filters のプレビューなしに bulk changes を承認してしまうことがあります。書き込み操作では、発見された tools が対応している場合、実行前に対象件数を確認するようエージェントに依頼してください。

最初の出力後に詰める

最初の計画を受け取ったあと、不明点があるまま承認しないでください。次のような追加質問をします。

• “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 のガイドとしては、まず SKILL.md を読み、Prerequisites、Setup、Tool Discovery、Core Workflow Pattern という名前のセクションに注目してください。現在の skill package には追加の scripts や reference folders はありません。そのため、実用上の挙動の大部分は、ローカルコードではなく、文書化された Rube MCP の順序を丁寧に守ることから生まれます。