apollo

# Apollo Enrichment Skill

Enrich contacts and companies using [Apollo.io](https://apollo.io) API.

## Setup

1. Get your API key from [Apollo Settings](https://app.apollo.io/#/settings/integrations/api)
2. Set the environment variable:
   ```bash
   export APOLLO_API_KEY=your-api-key-here
   ```

## Usage

All commands use the bundled `apollo.py` script in this skill's directory.

### Enrich a Person

Get email, phone, title, and company data for a contact.

```bash
# By email
python3 apollo.py enrich --email "john@acme.com"

# By name + company
python3 apollo.py enrich --name "John Smith" --domain "acme.com"

# Include personal email & phone
python3 apollo.py enrich --email "john@acme.com" --reveal-email --reveal-phone
```

### Bulk Enrich People

Enrich up to 10 people in one call.

```bash
# From JSON file with array of {email, first_name, last_name, domain}
python3 apollo.py bulk-enrich --file contacts.json

# Reveal personal contact info
python3 apollo.py bulk-enrich --file contacts.json --reveal-email --reveal-phone
```

**contacts.json example:**
```json
[
  {"email": "john@acme.com"},
  {"first_name": "Jane", "last_name": "Doe", "domain": "techcorp.io"}
]
```

### Enrich a Company

Get industry, revenue, employee count, funding data.

```bash
python3 apollo.py company --domain "stripe.com"
```

### Search for People

Find prospects by criteria.

```bash
# By title and company
python3 apollo.py search --titles "CEO,CTO" --domain "acme.com"

# By title and location
python3 apollo.py search --titles "VP Sales" --locations "San Francisco"

# Limit results
python3 apollo.py search --titles "Engineer" --domain "google.com" --limit 10

# Exclude competitors (Hathora/Edgegap/Nakama)
python3 apollo.py search --titles "CTO" --exclude-competitors
```

**Filtering Options:**
- `--exclude-competitors` or `-x` — Automatically filters out employees from Hathora, Edgegap, and Nakama (Heroic Labs)

## Example Prompts

- *"Enrich john@acme.com with Apollo"*
- *"Get company i...