icypeas-automation

icypeas-automation skill 概覽

icypeas-automation 的用途

icypeas-automation 是一個 Claude skill，可透過 Composio 的 Rube MCP 執行 Icypeas 名單研究與資料補全任務。它不是把單一 Icypeas action 寫死，而是教 agent 先探索目前的 Icypeas tool schema、確認連線狀態，再依使用者的銷售或研究流程執行正確的 Rube tool。

最適合名單研究團隊使用

如果你已經在使用 Icypeas，或希望 AI agent 協助潛在客戶探索、email 查找、公司／人物資料補全，或其他相關名單研究作業，這個 skill 會特別有用。它適合銷售營運、成長團隊、招募研究人員、代理商開發流程，以及希望 Claude 能安全呼叫 Icypeas tools，而不只是撰寫手動研究指令的技術使用者。

關鍵差異：先探索 schema

icypeas-automation skill 最重要的行為，是堅持在執行前先呼叫 RUBE_SEARCH_TOOLS。這很重要，因為 MCP tool schema 可能會變動，而 Icypeas actions 也可能依目前 Composio toolkit 暴露不同的必填欄位。相較於一般提示詞，這能降低呼叫失敗、範例過時，以及憑空產生參數的風險。

採用條件與限制

若要使用這個 skill，你的 AI client 必須可使用 Rube MCP，且 Icypeas toolkit connection 必須透過 RUBE_MANAGE_CONNECTIONS 啟用。這個 skill 的 repository 刻意維持輕量：主要指引都在 SKILL.md，沒有額外 scripts、rules 或 reference files。如果你需要完整的 CRM 同步 pipeline、驗證層，或自訂去重邏輯，通常需要在 skill 外圍自行補上。

如何使用 icypeas-automation skill

icypeas-automation 安裝與設定路徑

從來源 repository 安裝 skill：

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

接著在你的 client 中加入 https://rube.app/mcp 作為 MCP server，以設定 Rube MCP。這個 skill 依賴的是 rube MCP server，而不是本機 script。在請 Claude 執行 Icypeas workflow 之前，請先確認 RUBE_SEARCH_TOOLS 可用，並使用 RUBE_MANAGE_CONNECTIONS 搭配 toolkit icypeas 檢查 connection 是否為 ACTIVE。如果尚未啟用，請先完成回傳的授權流程。

穩定執行所需的輸入

一個有效的 icypeas-automation usage 提示詞，應包含商業目標、名單條件、必要輸出欄位、數量、可接受的不確定性，以及任何排除規則。舉例來說，「Find likely sales operations leaders at B2B SaaS companies in Germany」會比「find leads」更好，因為 agent 才能搜尋正確的 Icypeas tools，並將你的條件對應到即時 schema。

實用輸入包含：

• 目標 persona、職級、地理區域、產業、公司規模或 domain list
• 你需要的是人物、公司、emails、enrichment，或 verification
• 輸出格式，例如 CSV-style table、JSON、CRM-ready fields，或 review summary
• 限制條件，例如「do not enrich personal emails」或「skip existing accounts」
• 成功標準，例如最低信心分數、最大筆數或必填欄位

把粗略目標轉成完整提示詞

較弱的提示詞是：「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.」

這樣的提示詞能提升結果品質，因為它提供足夠脈絡，讓 agent 選擇 tools、填入必填欄位，並判斷回傳紀錄是否符合研究目標。

使用 repository 前應先閱讀的檔案

請先看 composio-skills/icypeas-automation/SKILL.md。它包含實際操作模式：前置條件、設定、tool discovery、connection checking、workflow execution，以及 error-handling expectations。skill folder 中沒有額外的 README.md、resources/、references/、rules/ 或 scripts/ files，因此不要預期有隱藏的實作邏輯。它的實務價值在於 MCP workflow discipline，尤其是執行前先做 tool discovery。

icypeas-automation skill 常見問題

icypeas-automation 只適合 Icypeas 使用者嗎？

實務上是。這個 skill 是圍繞 Composio 透過 Rube MCP 提供的 Icypeas toolkit 設計。你可以在沒有 active Icypeas connection 的情況下安裝它，但在 toolkit connection 完成授權並啟用之前，它無法執行有實際價值的名單研究 workflow。

為什麼不直接請 Claude 手動研究名單？

一般提示詞可以撰寫研究條件或建議搜尋策略，但除非 MCP tools 可用且已被探索，否則無法可靠呼叫目前的 Icypeas actions。icypeas-automation skill 加入的是可重複執行的模式：搜尋目前 tool schemas、檢查驗證狀態、用已知欄位執行，並處理 tool 層級的失敗。

這對初學者友善嗎？

如果你的 AI client 已支援 MCP，且你能接受授權外部 tool connections，這個 skill 算是初學者友善。若你期待的是一鍵式試算表 app，就比較不適合。這個 skill 假設你能確認 Rube MCP 是否可用、檢視 tool responses，並在 agent 提出追問時釐清名單條件。

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

當你需要不支援的資料來源、完全離線研究、未經驗證卻保證 email 準確，或複雜的下游 CRM governance 時，不應使用 icypeas-automation。如果你無法與 agent 分享必要的開發條件，或你的組織要求每一次第三方 enrichment call 都必須人工核准，它也不太適合。

如何改進 icypeas-automation skill

用更精準的條件改善 icypeas-automation 結果

改善 icypeas-automation 輸出的最佳方式，是在執行前縮小研究需求。將「tech companies」這類寬泛分類，改成明確篩選條件：例如「B2B SaaS companies selling HR software, 100–1,000 employees, headquartered in the UK, excluding staffing agencies」。清楚的篩選條件能減少不相關的 enrichment calls，也更容易判斷回傳名單是否可用。

常見失敗模式與排查重點

多數失敗來自 inactive connections、略過 schema discovery、缺少必填欄位，或名單定義過於模糊。如果 tool call 失敗，請要求 agent 針對特定 use case 重新執行 RUBE_SEARCH_TOOLS，並把先前嘗試使用的參數與回傳 schema 對照。如果結果品質不佳，請先調整 ICP，再增加數量；更多筆紀錄無法修正目標設定不清的問題。

在第一批輸出後迭代

把第一次執行視為校準。先要求小批量結果，檢查 false positives，再把排除規則與偏好的訊號補進提示詞。舉例：「The first batch included consultants; rerun with a rule to exclude agencies, independent consultants, and companies with fewer than 20 employees.」這通常比單純叫 agent「try again」更能產生品質更好的第二輪結果。

若團隊需要一致性，加入本地 workflow 規則

由於 upstream skill 只有 SKILL.md，有固定名單研究流程的團隊，可能會想加入自己的 wrapper instructions：核准欄位、命名慣例、去重規則、合規備註、CRM import format，以及 review checkpoints。這些補充能讓 icypeas-automation guide 更適合正式環境長期使用，同時不改變核心要求：必須先探索即時 Rube tool schemas，再執行 workflow。