👥search-contacts
- プラグイン
- carta-crm
- ソース
- GitHub で見る ↗
説明
Carta CRM から連絡先（人物）レコードを検索・取得します。 次のような場合に使用: ユーザーが「連絡先を探して」「連絡先を検索して」「人物を調べて」「[名前] の連絡先の詳細を見せて」「IDで連絡先を取得して」「連絡先を一覧表示して」「[会社名] の人を探して」「人物を検索して」または「/search-contacts」といった発言をした場合。 ID・名前・メールアドレス・役職・会社名・タグを含む連絡先の詳細を返します。 取得した連絡先 ID は、update-contact スキルと組み合わせて使用できます。
原文を表示
Searches for and retrieves contact (people) records from the Carta CRM. Use this skill when the user says things like "find a contact", "search contacts", "look up a person", "show me contact details for [name]", "get contact by ID", "list contacts", "find people at [company]", "search people", or "/search-contacts". Returns contact details including ID, name, email, title, company, and tags. The contact ID returned can be used with the update-contact skill.
ユースケース
- ✓連絡先を名前で検索したい
- ✓特定の人物の詳細情報を取得したい
- ✓メールアドレスから連絡先を調べたい
- ✓会社名から該当する人物を探したい
- ✓連絡先を一覧表示したい
本文（日本語訳）
概要
Carta CRM でコンタクトを検索します。
ユーザーが ID を指定した場合は、該当レコードを直接取得します。
それ以外の場合は、名前やキーワードで検索し、結果をわかりやすいサマリー形式で返します。
ユーザーが更新時に参照できるよう、常にコンタクト ID を表示してください。
ステップ 1 — 検索モードの決定
- ID 指定 — ユーザーがコンタクト ID を提供した場合 →
fetch_contact_by_idを呼び出す - 名前 / キーワード指定 — ユーザーが名前・メールアドレス・キーワードを提供した場合 →
search_contactsを呼び出す
判断が難しい場合は、デフォルトで検索モードとし、ユーザーに検索ワードを確認してください。
ステップ 2 — 検索の実行
ID 指定の場合:
mcp__carta_crm__fetch_contact_by_id({ id: "<contact id>" })
名前 / キーワード指定の場合:
mcp__carta_crm__search_contacts({
query: "<search term>",
limit: 20
})
ユーザーが特定のリストやフォルダを名前で指定した場合は、先に get_contact_lists を呼び出して
名前をリスト ID に解決してから、list_id を渡して検索範囲を絞り込んでください。
ユーザーがより多くの結果を求める場合は limit を増やしてください。
ページネーションには offset を使用してください。
ステップ 3 — 結果の表示
返されたコンタクトごとに、空でないすべてのフィールド（名前・役職・会社・メール・電話番号・タグ）を
わかりやすいサマリー形式で表示してください。
ユーザーが /update-contact を実行する際に必要となるため、ID は必ず目立つ形で表示してください。
fetch_contact_by_id は関連するディールやノートも返します —
ユーザーが特定の人物の詳細な背景を求めている場合は、それらも表示してください。
コンタクトが見つからなかった場合:
「お探しの条件に一致するコンタクトは見つかりませんでした。別の名前・メールアドレス・キーワードでお試しください。」
複数の結果が返された場合は、すべてを一覧表示し、合計件数も明記してください。
原文（English）を表示
Overview
Search for contacts in the Carta CRM. If the user provided an ID, fetch the single record directly. Otherwise search by name/keyword and return results in a readable summary. Always surface the contact ID so the user can reference it for updates.
Step 1 — Determine search mode
- By ID — user provided a contact ID → call
fetch_contact_by_id - By name / keyword — user provided a name, email, or keyword → call
search_contacts
If it's unclear, default to search and ask the user for a search term.
Step 2 — Execute the search
By ID:
mcp__carta_crm__fetch_contact_by_id({ id: "<contact id>" })
By name / keyword:
mcp__carta_crm__search_contacts({
query: "<search term>",
limit: 20
})
If the user mentions a specific list or folder by name, call get_contact_lists first
to resolve the name to a list ID, then pass list_id to narrow the search.
Increase limit if the user asks to see more results. Use offset to paginate.
Step 3 — Present results
For each contact returned, display all non-empty fields in a readable summary,
including name, title, company, email, phone, and tags.
Always show the ID prominently — the user will need it to run /update-contact.
fetch_contact_by_id also returns related deals and notes — surface those if the
user is looking for context on a specific person.
If no contacts are found:
"No contacts found matching your search. Try a different name, email, or keyword."
If multiple results are returned, list them all and note the total count.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。