yousearch-automation

yousearch-automation skill 概覽

yousearch-automation 的功能

yousearch-automation 是一個 Claude skill，用來透過 Composio 的 Rube MCP 層執行 Yousearch 操作。它的核心目的不是把某個 Yousearch 動作寫死，而是引導 agent 先探索目前可用的 Yousearch tool schemas、驗證連線，然後再以較少猜測執行正確的 Rube tool。

最適合的使用者與工作流程

這個 skill 最適合已經在使用支援 MCP 的 AI client，並希望把 Yousearch 動作納入更大型工作流程自動化 session 的使用者。它適用於研究、以搜尋驅動的任務自動化、潛在客戶或內容探索流程，以及任何需要 agent 可靠呼叫 Yousearch tools，而不只是描述該怎麼做的流程。

主要差異：先看 schema 再執行

yousearch-automation skill 最重要的行為，是它的「先搜尋 tools」模式。它會指示 agent 在執行前先呼叫 RUBE_SEARCH_TOOLS，以取得目前的 tool slugs、input schemas、execution plans 和 pitfalls。這點很重要，因為 Composio toolkit schemas 可能會變動，而過時的假設正是 tool calls 失敗的常見原因。

採用前需要考量的事

只有在你可以使用 Rube MCP，且已經擁有或能建立有效的 Yousearch connection 時，才建議安裝這個 skill。這個 skill 的 repository 刻意保持精簡：主要實作在 SKILL.md，沒有額外 scripts、resources 或 reference folders。這讓它很容易檢視，但也代表你的 prompt 必須提供實際的商業目標、搜尋意圖、限制條件，以及想要的輸出格式。

如何使用 yousearch-automation skill

yousearch-automation 安裝與設定

使用以下指令從 Composio skill collection 安裝這個 skill：

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

接著在你的 client 中加入以下端點來設定 Rube MCP：

https://rube.app/mcp

這個 skill 預期 RUBE_SEARCH_TOOLS 可用。執行 Yousearch workflows 前，請使用 RUBE_MANAGE_CONNECTIONS 搭配 toolkit yousearch，並確認 connection status 是 ACTIVE。如果 Rube 回傳 auth link，請先完成授權；在 connection 變成 active 之前，不要要求 agent 繼續執行。

skill 需要你提供的輸入

要有效使用 yousearch-automation，不要只給 agent 一句模糊的搜尋需求。請包含：

• 精確的 Yousearch task 或預期 outcome
• 目標市場、主題、實體或查詢範圍
• 篩選條件或排除條件
• 對資料新鮮度的期待
• 結果數量或調查深度
• 輸出格式，例如 table、JSON、brief 或 ranked list
• 結果後續會用在哪裡

較弱的 prompt：「Use Yousearch to find companies.」

較好的 prompt：「Use yousearch-automation for Workflow Automation to find 20 US-based B2B SaaS companies hiring RevOps roles in the last 30 days. First discover the current Yousearch tools with RUBE_SEARCH_TOOLS, confirm the Yousearch connection is active, then return a table with company, evidence URL, hiring signal, likely ICP fit, and confidence.」

agent 的實務工作流程

一個可靠的 yousearch-automation 使用方式，應該依照以下順序：

1. Read composio-skills/yousearch-automation/SKILL.md.
2. Call RUBE_SEARCH_TOOLS with the specific use case, not a generic query.
3. Reuse the returned session ID for follow-up tool discovery or execution planning.
4. Check the Yousearch connection through Rube connection management.
5. Execute only after validating required fields from the discovered schema.
6. Summarize results with evidence, assumptions, and any failed or skipped calls.

原始 skill 強調使用目前的 schemas，因此請避免要求 agent「just call the Yousearch tool」。你應該要求它先探索相關 tool。

優先閱讀的 repository 檔案

請從 SKILL.md 開始；這是此 skill 中唯一具實質內容的檔案。請特別留意標題為 Prerequisites、Setup、Tool Discovery 和 Core Workflow Pattern 的段落。這個 skill 沒有內建 helper scripts 或獨立 rules folders，因此它的價值來自嚴謹的 MCP tool discovery 與 connection handling，而不是大型的本機自動化框架。

yousearch-automation skill 常見問題

沒有 Rube MCP 時，yousearch-automation 有用嗎？

沒有。這個 skill 依賴 Rube MCP，並預期 RUBE_SEARCH_TOOLS 以及 Rube connection management 等工具可用。若沒有 MCP access，它就會變成一般性的指引，而不是可執行的自動化 skill。

這和一般 prompt 相比好在哪裡？

一般 prompt 可能會要求模型搜尋或推理，但不一定會強制使用目前的 tool discovery。yousearch-automation skill 加入了更安全的操作模式：先探索可用的 Yousearch tools、檢查即時 schema、驗證 authentication，然後才執行。這能減少因 tool names 過時或欄位缺失而導致的失敗呼叫。

yousearch-automation skill 適合初學者嗎？

如果你的 AI client 已經支援 MCP，且你熟悉完成 OAuth-style connection flow，那它算是適合初學者。若你從未設定過 MCP server，它就比較不適合入門，因為這個 skill 假設 Rube endpoint 和 Yousearch toolkit connection 已經可用，之後才有辦法產生實際成效。

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

不要把它用於純手動的 web research、非 Yousearch 的 search providers、離線分析，或任何你無法授權 Yousearch connection 的工作流程。若你需要的是包含 scripts、tests 和 deployment assets 的完整 end-to-end application，也應避免使用；這個 repository 提供的是 agent skill pattern，不是獨立的自動化 app。

如何改善 yousearch-automation skill

改善 yousearch-automation 的 prompts

改善結果最快的方法，是在 tool discovery 前先把 use case 具體化。不要只說「search Yousearch for leads」，而是明確寫出 segment、geography、qualification signal、date range、disqualifiers 和 required evidence。這能幫助 RUBE_SEARCH_TOOLS 回傳更相關的 execution plan，也能降低 agent 選錯 Yousearch operation 的機率。

需要避免的常見失敗模式

主要失敗模式包括 connection not active、對 tool schema 採用過時假設、缺少 required fields，以及搜尋範圍模糊。你可以透過明確要求 agent 做以下事項來預防：

• call RUBE_SEARCH_TOOLS before execution
• confirm yousearch connection status is ACTIVE
• restate required fields from the discovered schema
• ask a clarification question if your goal lacks scope or output criteria
• report tool errors instead of silently fabricating results

根據第一次輸出持續調整

第一次執行後，請根據結果品質調整，而不是只要求「more」。有效的迭代指令包括：放寬或收窄 query、排除 low-confidence matches、加入 required evidence URL、依 fit 排序、用不同的 use case phrase 重新執行，或把輸出轉成可匯入的 CSV-style table。若是 workflow automation，請要求 agent 在延續同一任務時保留 Rube session ID。

將 skill 升級為團隊使用

如果你維護 local fork，請為團隊反覆使用的 Yousearch workflows 加入範例：prospect discovery、content research、market monitoring 或 enrichment。請包含已核准的 prompt templates、required fields、expected output schemas，以及你們環境中的 known pitfalls。上游的 yousearch-automation skill 刻意保持最小化，因此加入團隊專用範例，可以在不改變核心 schema-first pattern 的前提下，大幅提升一致性。