@sellable/mcp 0.1.220 → 0.1.221

package/skills/providers/prospeo.md

@@ -6,6 +6,114 @@ Prospeo is a data enrichment API for finding verified emails and company data. U
 
 Prospeo supports search + import in the campaign builder flow.
 
+## Provider Decision Tree
+
+- Known account list or CSV: use `load_csv_domains` or `save_domain_filters`, then `search_prospeo`.
+- Company/account lookalikes: use `search_prospeo_companies`, review the account sample, then use `confirm_prospeo_company_accounts` with the returned `companySearchToken` to create a `domainFilterId`; only then call `search_prospeo` for people at those accounts. Account rows are not people leads yet.
+- Person search with known filters: use `search_prospeo` directly.
+- LinkedIn activity, content-source, or post-engagement intent: stay on Signal Discovery or Sales Nav, not Prospeo.
+
+Company/account lookalikes must follow:
+
+```text
+search_prospeo_companies -> confirm_prospeo_company_accounts -> search_prospeo
+```
+
+Example account discovery:
+
+```json
+search_prospeo_companies({
+  "seedDomains": ["tryredrover.com"],
+  "filters": {
+    "company_lookalike": { "company_oids": ["cmp_red_rover"], "minimum_tier": "T1" },
+    "company_attributes": {
+      "uses_ai": true,
+      "has_api": true,
+      "has_chrome_extension": true,
+      "pricing": true
+    },
+    "company_news": {
+      "categories": ["Funding & Investment"],
+      "timeframe_days": 90
+    },
+    "company_awards": { "include": ["G2"], "match_mode": "CONTAINS" },
+    "company_website_search": {
+      "include_keywords": ["pricing"],
+      "url_contains": ["/docs", "/developers"],
+      "has_developer_docs_page": true,
+      "has_security_page": true
+    },
+    "company_products_services": {
+      "products_include": ["AI"],
+      "service_tags_include": ["automation"]
+    },
+    "company_integrations": { "include": ["Salesforce"] },
+    "company_key_customers": { "include": ["Walmart"] },
+    "company_google_discovery": { "seo_keywords": ["sales automation"] },
+    "company_headcount_by_location": {
+      "entries": [{ "country": "United States", "city": "Austin", "min_headcount": 10 }]
+    },
+    "company_icp": {
+      "titles_include": ["Head of RevOps"],
+      "company_sizes": ["midmarket"],
+      "departments": { "include": ["Sales"], "match_mode": "ANY" }
+    },
+    "company_website_traffic": { "min_monthly_visits": 50000 },
+    "company_key_execs": {
+      "event_types": ["VP of Sales Appointed"],
+      "timeframe_days": 180
+    }
+  }
+})
+```
+
+After the user approves account IDs from that response:
+
+```json
+confirm_prospeo_company_accounts({
+  "companySearchToken": "token-from-search_prospeo_companies",
+  "selectedCompanyIds": ["cmp_influx"],
+  "name": "Red Rover lookalike accounts"
+})
+```
+
+Use the returned `domainFilterId` in `search_prospeo` with people filters. Do not reconstruct raw account rows or domains manually as Prospeo-sourced provenance.
+
+Unsupported/caveats:
+
+- `company_intent` is unsupported by Prospeo public API.
+- Support-channel AI Attribute guesses like phone/email/chat/ticket/social are not exposed.
+- Public API account rows do not expose row-level lookalike tier/score/reason; do not fabricate them.
+- Website traffic and key executive filters are experimental and may fail by account/API policy.
+
+Confirmed AI Attribute keys:
+
+- `demo`
+- `freetrial`
+- `downloadable`
+- `mobileapps`
+- `onlinereviews`
+- `pricing`
+- `uses_ai`
+- `has_api`
+- `has_chrome_extension`
+- `has_sso`
+- `has_uptime_guarantee`
+- `has_open_source`
+- `has_marketplace`
+- `has_blog`
+- `has_podcast`
+- `has_community_forum`
+- `has_knowledge_base`
+- `has_academy`
+- `has_affiliate_program`
+- `has_esg_reports`
+- `has_physical_offices`
+- `is_venture_backed`
+- `is_publicly_traded`
+- `has_soc2`
+- `data_residency` (`"EU"` only)
+
 ## Domain Filters (ABM / Account-Based Targeting)
 
 When a user gives company domains:
@@ -391,7 +499,7 @@ get_prospeo_credits({})
 | Max bulk size      | 10              | 100                        |
 | Duplicate handling | Charged         | FREE (same record twice)   |
 
-**Recommendation:** Use Prospeo when you have LinkedIn URLs. Use Apollo when you need to search by filters (titles, company size, industry, etc.).
+**Recommendation:** Use Prospeo when you have LinkedIn URLs, verified-contact searches, hiring-led company filters, domain/account lists, or account lookalikes. Use Sales Nav when LinkedIn activity/profile filters are the deciding signal.
 
 ## Credit Management