icypeas-automation

icypeas-automation skill 개요

icypeas-automation이 하는 일

icypeas-automation은 Composio의 Rube MCP를 통해 Icypeas 리드 리서치와 보강(enrichment) 작업을 실행하기 위한 Claude skill입니다. 하나의 고정된 Icypeas 액션을 하드코딩하는 대신, 에이전트가 먼저 현재 Icypeas tool schema를 찾고, 연결 상태를 확인한 뒤, 사용자의 영업 또는 리서치 워크플로에 맞는 Rube tool을 실행하도록 안내합니다.

리드 리서치 팀에 가장 잘 맞는 경우

이 skill은 이미 Icypeas를 사용 중이거나, 잠재고객 발굴, 이메일 탐색, 회사/인물 정보 보강, 관련 리드 리서치 업무를 AI 에이전트가 도와주길 원하는 경우에 가장 유용합니다. 세일즈 오퍼레이션, 그로스 팀, 리크루팅 리서처, 에이전시의 prospecting 워크플로, 그리고 Claude가 단순히 수동 리서치 지침을 작성하는 데 그치지 않고 Icypeas tool을 안전하게 호출하길 원하는 기술 사용자에게 잘 맞습니다.

핵심 차별점: schema discovery를 먼저 수행

icypeas-automation skill에서 가장 중요한 동작은 실행 전에 반드시 RUBE_SEARCH_TOOLS를 호출하도록 한다는 점입니다. MCP tool schema는 변경될 수 있고, Icypeas 액션도 현재 Composio toolkit에 따라 서로 다른 필수 필드를 노출할 수 있기 때문입니다. 이 방식은 일반적인 프롬프트에 비해 실패한 호출, 오래된 예시, 존재하지 않는 파라미터를 지어내는 문제를 줄여줍니다.

도입 요건과 한계

이 skill을 사용하려면 AI 클라이언트에서 Rube MCP를 사용할 수 있어야 하며, Icypeas toolkit 연결이 RUBE_MANAGE_CONNECTIONS를 통해 활성화되어 있어야 합니다. 이 skill의 저장소는 의도적으로 가볍게 구성되어 있습니다. 핵심 가이드는 SKILL.md에 있으며, 추가 스크립트, 규칙, 참조 파일은 없습니다. 완전한 CRM 동기화 파이프라인, 검증 레이어, 맞춤형 중복 제거 로직이 필요하다면 skill 주변에 별도로 구성해야 할 가능성이 큽니다.

icypeas-automation skill 사용 방법

icypeas-automation 설치 및 설정 경로

소스 저장소에서 다음 명령으로 skill을 설치합니다.

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

그다음 클라이언트에 MCP 서버로 https://rube.app/mcp를 추가해 Rube MCP를 설정합니다. 이 skill은 로컬 스크립트가 아니라 rube MCP 서버에 의존합니다. Claude에게 Icypeas 워크플로 실행을 요청하기 전에 RUBE_SEARCH_TOOLS를 사용할 수 있는지 확인하고, toolkit icypeas와 함께 RUBE_MANAGE_CONNECTIONS를 사용해 연결 상태가 ACTIVE인지 점검하세요. 활성 상태가 아니라면 먼저 반환된 인증 흐름을 완료해야 합니다.

안정적인 실행을 위해 skill에 제공해야 할 입력

좋은 icypeas-automation usage 프롬프트에는 비즈니스 목표, 리드 기준, 필요한 출력 필드, 수량, 허용 가능한 불확실성, 제외 규칙이 포함되어야 합니다. 예를 들어 “리드 찾아줘”보다 “독일의 B2B SaaS 회사에서 세일즈 오퍼레이션을 이끌 가능성이 높은 리더를 찾아줘”가 더 좋습니다. 그래야 에이전트가 적절한 Icypeas tool을 찾고, 사용자의 기준을 현재 schema에 맞게 매핑할 수 있습니다.

유용한 입력 예시는 다음과 같습니다.

• 타깃 페르소나, 직급, 지역, 산업, 회사 규모 또는 도메인 목록
• 사람, 회사, 이메일, 보강 정보, 검증 중 무엇이 필요한지
• CSV 스타일 표, JSON, CRM 입력용 필드, 검토 요약 등 출력 형식
• “개인 이메일은 보강하지 말 것” 또는 “기존 계정은 제외” 같은 제약
• 최소 신뢰도, 최대 레코드 수, 필수 필드 같은 성공 기준

막연한 목표를 완성도 높은 프롬프트로 바꾸기

약한 프롬프트는 이렇게 말합니다. “Use Icypeas to get leads.”

더 강한 프롬프트는 이렇게 말합니다. “Use the icypeas-automation skill for Lead Research. First discover the current Icypeas tools with RUBE_SEARCH_TOOLS, then confirm the Icypeas connection is active. I need up to 50 prospects: VP Sales, Head of Revenue, or Sales Operations leaders at B2B SaaS companies with 50–500 employees in France and Belgium. Return name, title, company, company domain, LinkedIn URL if available, business email if available, source tool used, and confidence notes. Do not include agencies or consultancies.”

이런 프롬프트는 에이전트가 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인가요?

실질적으로는 그렇습니다. 이 skill은 Rube MCP를 통한 Composio의 Icypeas toolkit을 중심으로 설계되어 있습니다. 활성 Icypeas 연결이 없어도 설치는 가능하지만, toolkit 연결이 인증되고 활성화되기 전까지는 유용한 리드 리서치 워크플로를 실행할 수 없습니다.

Claude에게 리드를 수동으로 조사해 달라고 하면 안 되나요?

일반 프롬프트로도 리서치 기준을 작성하거나 검색 전략을 제안할 수는 있습니다. 하지만 MCP tool이 사용 가능하고 discovery가 완료되어 있지 않다면 현재 Icypeas 액션을 안정적으로 호출할 수 없습니다. icypeas-automation skill은 현재 tool schema 검색, 인증 확인, 확인된 필드로 실행, tool 수준 실패 처리라는 반복 가능한 패턴을 더해줍니다.

초보자도 사용하기 쉬운가요?

AI 클라이언트가 이미 MCP를 지원하고 외부 tool 연결 인증에 익숙하다면 초보자도 사용할 수 있습니다. 다만 클릭 한 번으로 끝나는 스프레드시트 앱을 기대하는 사용자에게는 덜 적합합니다. 이 skill은 Rube MCP 사용 가능 여부를 확인하고, tool 응답을 살펴보며, 에이전트가 후속 질문을 할 때 리드 기준을 명확히 해줄 수 있다는 전제를 둡니다.

이 skill을 사용하지 않는 편이 나은 경우는 언제인가요?

지원되지 않는 데이터 소스가 필요하거나, 완전한 오프라인 리서치가 필요하거나, 검증 없는 이메일 정확도를 보장해야 하거나, 복잡한 후속 CRM 거버넌스가 필요한 경우에는 icypeas-automation을 사용하지 않는 편이 좋습니다. 필요한 prospecting 기준을 에이전트와 공유할 수 없거나, 조직에서 모든 서드파티 enrichment 호출 전에 수동 승인을 요구하는 경우에도 잘 맞지 않습니다.

icypeas-automation skill 개선 방법

더 촘촘한 기준으로 icypeas-automation 결과 개선하기

icypeas-automation 출력 품질을 높이는 가장 좋은 방법은 실행 전에 리서치 요청 범위를 좁히는 것입니다. “tech companies”처럼 넓은 범주 대신 “HR software를 판매하는 B2B SaaS 회사, 직원 100–1,000명, 본사 UK, staffing agencies 제외”처럼 명확한 필터를 사용하세요. 분명한 필터는 관련 없는 enrichment 호출을 줄이고, 반환된 리드가 실제로 사용할 만한지 판단하기 쉽게 만듭니다.

주의해야 할 일반적인 실패 패턴

대부분의 실패는 비활성 연결, schema discovery 생략, 필수 필드 누락, 모호한 리드 정의에서 발생합니다. tool 호출이 실패하면 에이전트에게 해당 사용 사례에 대해 RUBE_SEARCH_TOOLS를 다시 실행하고, 시도한 파라미터를 반환된 schema와 비교하라고 요청하세요. 결과 품질이 낮다면 수량을 늘리기 전에 ICP를 먼저 다듬어야 합니다. 타기팅이 약한 상태에서는 레코드를 더 많이 받아도 문제가 해결되지 않습니다.

첫 결과 이후 반복 개선하기

첫 실행은 보정용 패스로 간주하세요. 작은 배치로 요청하고, 오탐(false positive)을 검토한 다음, 제외 규칙과 선호 신호를 프롬프트에 반영합니다. 예를 들어 “첫 배치에 컨설턴트가 포함되었으니 agencies, independent consultants, 직원 20명 미만 회사는 제외하는 규칙으로 다시 실행해줘”라고 요청할 수 있습니다. 이렇게 하면 단순히 “다시 해봐”라고 하는 것보다 두 번째 실행 결과가 더 좋아집니다.

팀에 일관성이 필요하다면 로컬 워크플로 규칙 추가하기

업스트림 skill에는 SKILL.md만 있기 때문에, 반복적인 리드 리서치 프로세스를 가진 팀은 자체 wrapper instructions를 추가하는 것이 좋습니다. 예를 들어 승인된 필드, 명명 규칙, 중복 제거 규칙, 컴플라이언스 메모, CRM import format, 검토 체크포인트를 정의할 수 있습니다. 이러한 추가 지침은 먼저 live Rube tool schema를 discovery해야 한다는 핵심 요건을 바꾸지 않으면서도, icypeas-automation guide를 프로덕션 환경에서 더 안정적으로 사용할 수 있게 해줍니다.