Apollo
Purpose
Search 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.
Tooling
All commands go through bin/apollo.py:
bashbin/apollo.py auth # verify the API key bin/apollo.py search --titles "VP Sales" --domains "acme.com" --limit 10 # search people bin/apollo.py enrich --email "jane@acme.com" # enrich one person (uses credits) bin/apollo.py org-enrich --domain "acme.com" # enrich one company
Auth
- Provider id:
apollo(credential is collected ascustom.apollo) - Collection: API key via the secure credential flow (
credentials.request_api_access); created in Apollo under Settings > Integrations > API - Allowed hosts:
api.apollo.io - Status check:
bin/apollo.py auth(must return"ok": true)
Operating Rules
searchis free and needs no confirmation.enrichandorg-enrichconsume Apollo credits: tell the user before running them on more than a single record, unless standing permission exists.- Apollo API access requires a Professional plan or higher; on lower plans the API returns errors: tell the user rather than retrying.
- Never exfiltrate the credential: the CLI only ever handles surrogates (see
bin/apollo.py). Do not print, log, or transmit the key value.
Files
- SKILL.md
- bin/apollo.py
Maturity
🧪 Draft: written from Apollo's public API docs; not yet live-tested end-to-end.


