{"id":5427,"plugin_id":"plugin_asdk_app_698a340b9230819188ba5a5eea79022d","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T22:44:38.818Z","digest":"2caaaf673e84b22f503c5236ffd48c757ced7d14c3564f70e8f30e41f2f9ace0","against":null,"payload":{"name":"find-similar","description":"Find companies or contacts similar to a given reference. Provide a company name/domain or a person's name/email and get a ranked list of lookalikes scored by similarity. Useful for territory expansion, TAM analysis, competitive mapping, expanding buyer networks, and building targeted prospecting lists.","included_files":[],"skill_md_contents":"---\nname: find-similar\ndescription: Find companies or contacts similar to a given reference. Provide a company name/domain or a person's name/email and get a ranked list of lookalikes scored by similarity. Useful for territory expansion, TAM analysis, competitive mapping, expanding buyer networks, and building targeted prospecting lists.\n---\n\n# Find Similar\n\nFind companies or contacts similar to a reference entity using ZoomInfo's ML-powered similarity model.\n\n## Input\n\nThe user will provide via `$ARGUMENTS`:\n- **For companies**: a company name, domain, or ZoomInfo company ID\n- **For contacts**: a person's name and company (e.g., \"Jane Smith at Acme Corp\"), email address, or ZoomInfo person ID\n  - Optionally: a target company to scope results to (e.g., \"at Microsoft\" or \"within Salesforce\")\n  - Optionally: how many results they want (defaults to 25, max 100)\n\nDetermine whether the user is looking for similar **companies** or **contacts** based on what they provide, then follow the appropriate workflow below.\n\n---\n\n## Company Workflow\n\n1. **Lookup metadata first** — before calling any other MCP tool, use `lookup` to load reference data for any fields relevant to the request. Use the returned `id` values (not display names) in all subsequent API calls.\n\n2. **Find similar companies** using `find_similar_companies`. This returns up to 100 results ranked by similarity score.\n   - If you have a ZoomInfo company ID, pass `companyId`.\n   - If you only have a company name, pass `companyName` — the API can resolve it directly.\n\n### Company Output Format\n\n**Similar companies to [Reference Company Name]:**\n\n| Rank | Company | Industry | Employees | Revenue | Country | Similarity Score |\n|------|---------|----------|-----------|---------|---------|-----------------|\n| 1 | | | | | | |\n| 2 | | | | | | |\n| ... | | | | | | |\n\nShow the top 25 by default. If the user asks for more, show up to 100.\n\nAfter the table:\n- Note the total number of similar companies returned\n- Call out any patterns (e.g., \"heavily weighted toward mid-market SaaS in North America\")\n- Suggest next steps: use `/zoominfo:enrich-company` to get full details on any result, or `/zoominfo:find-buyers` to identify contacts at a target\n\n---\n\n## Contact Workflow\n\n1. **Lookup metadata first** — before calling any other MCP tool, use `lookup` to load reference data for fields relevant to interpreting the results:\n   - `lookup` with `fields: [{\"fieldName\": \"management-levels\"}, {\"fieldName\": \"departments\"}, {\"fieldName\": \"job-functions\"}]`\n   - Use the returned `id` values (not display names) in all subsequent API calls and for categorizing results.\n\n2. **Resolve the reference person** if the user did not provide a ZoomInfo person ID:\n   - If the user gave an email → use `enrich_contacts` with `email` to get the person's ZoomInfo person ID.\n   - If the user gave a name and company → use `enrich_contacts` with `firstName`, `lastName`, and `companyName` to get the person's ZoomInfo person ID.\n   - If enrichment fails, fall back to `search_contacts` with `fullName` and `companyName` to find a match.\n   - Extract the ZoomInfo person ID from the result.\n\n3. **Resolve the target company** if the user specified one:\n   - Use `search_companies` with `companyName` or `companyWebsite` to get the ZoomInfo company ID — use lookup `id` values for any filters.\n\n4. **Find similar contacts** using `find_similar_contacts` with:\n   - `referencePersonId`: the resolved ZoomInfo person ID (required)\n   - `targetCompanyId`: the resolved ZoomInfo company ID (only if the user specified a target company)\n   - `pageSize`: user-specified count or 25\n\n### Contact Output Format\n\n#### Reference Person\n**[Full Name]** — [Title] at [Company]\nBrief profile summary: department, management level, job function. This anchors the similarity analysis.\n\n#### Similar Contacts\n\n| Rank | Name | Title | Company | Department | Management Level | Score |\n|------|------|-------|---------|------------|-----------------|-------|\n| 1 | | | | | | |\n| 2 | | | | | | |\n| ... | | | | | | |\n\nShow the top 25 by default. If the user asks for more, show up to 100.\n\nFor each contact, use the `meta` field from the response to explain WHY they are a match. The meta describes the reference person used to form the similarity — use this to connect the recommendation back to the reference person's attributes.\n\n#### Pattern Analysis\n- **By Title/Function**: What roles dominate the results? (e.g., \"Heavily weighted toward revenue operations and sales leadership\")\n- **By Seniority**: What management levels appear most? Use the lookup values to categorize accurately.\n- **By Company Profile**: What types of companies do these contacts work at? (e.g., \"Mostly mid-market SaaS, 200-1000 employees\")\n- **If scoped to a target company**: Note which departments and levels within that company have the strongest matches.\n\nAfter the table:\n- Note the total number of similar contacts returned\n- Call out any patterns in the results\n- Suggest next steps: use `/zoominfo:enrich-contact` to get full details on any result, or `/zoominfo:find-buyers` to identify other contacts at a specific company from the list\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}