icypeas-automation

icypeas-automation skill の概要

icypeas-automation でできること

icypeas-automation は、Composio の Rube MCP 経由で Icypeas のリード調査やエンリッチメントを実行するための Claude skill です。特定の Icypeas アクションを固定で呼び出すのではなく、まず現在の Icypeas tool schema を検出し、接続状態を確認したうえで、ユーザーの営業・リサーチ業務に合った Rube tool を実行するようエージェントに指示します。

リード調査チームに向いているケース

この skill は、すでに Icypeas を使っている場合、または見込み客の発掘、メールアドレスの探索、企業・人物情報のエンリッチメント、関連するリード調査業務を AI エージェントに手伝わせたい場合に特に有効です。営業企画、グロースチーム、採用リサーチ、代理店のプロスペクティング業務、そして Claude に手作業の調査手順を書かせるだけでなく、Icypeas tools を安全に呼び出させたい技術寄りのユーザーに適しています。

最大の特徴: まず schema を検出する

icypeas-automation skill で最も重要なのは、実行前に必ず RUBE_SEARCH_TOOLS を呼び出すよう促す点です。MCP tool schema は変わる可能性があり、現在の Composio toolkit によって Icypeas アクションの必須フィールドが異なる場合があります。そのため、汎用プロンプトに比べて、失敗する tool call、古い例に基づく実行、存在しないパラメータの生成を減らしやすくなります。

導入要件と制約

この skill を使うには、利用中の AI クライアントで Rube MCP が利用可能であり、RUBE_MANAGE_CONNECTIONS を通じて Icypeas toolkit の接続が有効になっている必要があります。この skill のリポジトリは意図的に軽量です。主なガイダンスは SKILL.md にまとまっており、追加のスクリプト、ルール、参照ファイルはありません。完全な CRM 同期パイプライン、検証レイヤー、独自の重複排除ロジックが必要な場合は、この skill の周辺に別途仕組みを追加することになるでしょう。

icypeas-automation skill の使い方

icypeas-automation のインストールとセットアップ手順

ソースリポジトリから skill をインストールします。

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

次に、クライアント側で https://rube.app/mcp を MCP server として追加し、Rube MCP を設定します。この skill はローカルスクリプトではなく、rube MCP server に依存します。Claude に Icypeas ワークフローを実行させる前に、RUBE_SEARCH_TOOLS が利用可能であることを確認し、toolkit icypeas を指定して RUBE_MANAGE_CONNECTIONS を使い、接続が ACTIVE かどうかを確認してください。有効でない場合は、返された認可フローを先に完了させます。

安定して実行するために必要な入力

精度の高い icypeas-automation usage プロンプトには、ビジネス上の目的、リード条件、必要な出力項目、件数、許容できる不確実性、除外ルールを含めるべきです。たとえば「リードを探して」よりも、「ドイツの B2B SaaS 企業にいる営業企画責任者らしき人物を探して」のほうが、エージェントは適切な Icypeas tools を検索し、条件を現在の schema に合わせて入力しやすくなります。

有用な入力例:

• 対象ペルソナ、役職レベル、地域、業界、企業規模、またはドメインリスト
• 人物、企業、メール、エンリッチメント、検証のどれが必要か
• CSV 風の表、JSON、CRM 取り込み向けフィールド、レビュー用サマリーなどの出力形式
• 「個人メールはエンリッチしない」「既存アカウントは除外する」などの制約
• 最低信頼度、最大件数、必須フィールドなどの成功条件

粗い目的を実行可能なプロンプトに変える

弱いプロンプトの例: 「Icypeas を使ってリードを取得して。」

より強いプロンプトの例: 「Lead Research に icypeas-automation skill を使ってください。まず RUBE_SEARCH_TOOLS で現在の Icypeas tools を検出し、その後 Icypeas 接続が有効であることを確認してください。最大 50 名の見込み客が必要です。対象は、フランスとベルギーにある従業員 50〜500 名の B2B SaaS 企業で、VP Sales、Head of Revenue、または Sales Operations の責任者です。名前、役職、会社名、会社ドメイン、取得可能であれば LinkedIn URL、取得可能であれば業務用メール、使用した source tool、信頼度メモを返してください。代理店やコンサルティング会社は含めないでください。」

このプロンプトのほうが良い結果につながるのは、エージェントが tool を選び、必須フィールドを埋め、返されたレコードが調査目的に合っているか判断するための文脈が十分に含まれているためです。

リポジトリで最初に読むべきファイル

まず composio-skills/icypeas-automation/SKILL.md を確認してください。ここには、前提条件、セットアップ、tool discovery、接続確認、ワークフロー実行、エラー処理の期待値といった実運用上のパターンが書かれています。skill フォルダ内には追加の README.md、resources/、references/、rules/、scripts/ ファイルはありません。そのため、隠れた実装ロジックがある前提で探す必要はありません。実用上の価値は、特に実行前に tool discovery を行うという MCP ワークフローの規律にあります。

icypeas-automation skill FAQ

icypeas-automation は Icypeas ユーザー専用ですか？

実質的にはそうです。この skill は、Rube MCP 経由の Composio Icypeas toolkit を前提に設計されています。有効な Icypeas 接続がなくてもインストールはできますが、toolkit 接続が認可されて ACTIVE になるまでは、有用なリード調査ワークフローを実行できません。

Claude に手作業でリード調査を頼むだけではだめですか？

汎用プロンプトでも調査条件を書いたり、検索戦略を提案したりすることはできます。ただし、MCP tools が利用可能で、かつ検出済みでない限り、現在の Icypeas アクションを安定して呼び出すことはできません。icypeas-automation skill は、現在の tool schema を検索し、認証状態を確認し、既知のフィールドで実行し、tool レベルの失敗に対処するという再現可能な流れを追加します。

初心者にも使いやすいですか？

利用中の AI クライアントがすでに MCP に対応しており、外部 tool 接続の認可に抵抗がなければ、初心者にも扱いやすい skill です。一方で、ワンクリックで使えるスプレッドシートアプリのような体験を期待しているユーザーにはあまり向きません。この skill では、Rube MCP が利用できることを確認し、tool のレスポンスを確認し、エージェントから追加質問があればリード条件を明確にできることが前提になります。

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

対応していないデータソースが必要な場合、完全にオフラインで調査したい場合、検証なしでメール精度を保証したい場合、または下流の CRM ガバナンスが複雑な場合は、icypeas-automation を使うべきではありません。必要なプロスペクティング条件をエージェントに共有できない場合や、組織として第三者エンリッチメント call のたびに手動承認が必要な場合にも適していません。

icypeas-automation skill を改善する方法

条件を絞って icypeas-automation の結果を改善する

icypeas-automation の出力を改善する最も効果的な方法は、実行前に調査依頼を絞り込むことです。「テック企業」のような広いカテゴリではなく、「英国本社、従業員 100〜1,000 名、人材派遣会社を除く、HR ソフトウェアを販売する B2B SaaS 企業」のように明示的なフィルタに置き換えてください。条件が明確だと、不要なエンリッチメント call を減らせますし、返ってきたリードが使えるかどうかも判断しやすくなります。

よくある失敗パターン

失敗の多くは、接続が有効でない、schema discovery を飛ばしている、必須フィールドが欠けている、リード定義が曖昧、といった原因で起こります。tool call が失敗した場合は、対象ユースケースに対して RUBE_SEARCH_TOOLS を再実行し、試行したパラメータと返された schema を照合するようエージェントに依頼してください。結果の品質が低い場合は、件数を増やす前に ICP を見直します。ターゲティングが弱いままレコード数を増やしても、問題は解決しません。

初回出力のあとに反復する

初回実行はキャリブレーションとして扱いましょう。まず少量のバッチを依頼し、誤検出を確認してから、除外ルールや優先したいシグナルをプロンプトに追加します。たとえば、「最初のバッチにコンサルタントが含まれていたので、代理店、独立コンサルタント、従業員 20 名未満の企業を除外するルールで再実行してください」のように指示します。単に「もう一度試して」と頼むより、2 回目の結果が良くなります。

チームで一貫性が必要ならローカルの運用ルールを追加する

上流の skill には SKILL.md しかないため、繰り返し使うリード調査プロセスがあるチームでは、独自のラッパー指示を追加するとよいでしょう。たとえば、承認済みフィールド、命名規則、重複排除ルール、コンプライアンス上の注意、CRM インポート形式、レビューのチェックポイントなどです。こうした追加により、まず live Rube tool schema を検出するという中核要件を変えずに、icypeas-automation guide を本番利用に耐えやすい形にできます。