apollo

1# Apollo
2 
3## Purpose
4Search B2B contacts with Apollo.io: search people by title, location, and company; enrich a person or a company. Use when the user mentions Apollo, prospecting, or wants contact/company data enriched.
5 
6## Tooling
7All commands go through `bin/apollo.py`:
8 
9```bash
10bin/apollo.py auth                                      # verify the API key
11bin/apollo.py search --titles "VP Sales" --domains "acme.com" --limit 10  # search people
12bin/apollo.py enrich --email "jane@acme.com"            # enrich one person (uses credits)
13bin/apollo.py org-enrich --domain "acme.com"            # enrich one company
14```
15 
16## Auth
17- Provider id: `apollo` (credential is collected as `custom.apollo`)
18- Collection: API key via the secure credential flow (`credentials.request_api_access`); created in Apollo under Settings > Integrations > API
19- Allowed hosts: `api.apollo.io`
20- Status check: `bin/apollo.py auth` (must return `"ok": true`)
21 
22## Operating Rules
231. `search` is free and needs no confirmation.
242. `enrich` and `org-enrich` consume Apollo credits: tell the user before running them on more than a single record, unless standing permission exists.
253. Apollo API access requires a Professional plan or higher; on lower plans the API returns errors: tell the user rather than retrying.
264. Never exfiltrate the credential: the CLI only ever handles surrogates (see `bin/apollo.py`). Do not print, log, or transmit the key value.
27 
28## Files
29- SKILL.md
30- bin/apollo.py
31 
32## Maturity
33…