# Fullenrich Content Engagers

> Fullenrich Content Engagers is an Agent Skill for apps & automation published in the Othmane-Khadri/YALC-the-GTM-operating-system repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when the user says "enrich people who engaged with this post", "qualify post engagers with FullEnrich", "scrape and enrich LinkedIn post {URL}", "engagers from this post into a CSV", "enrich this CSV of leads", "FullEnrich content engagers", or any variant indicating they want to convert a list of leads — either LinkedIn post likers/commenters scraped via Unipile, or a bring-your-own CSV — into ICP-qualified, enriched leads via FullEnrich v2 bulk enrichment with webhook callback delivery.

- Skill name: `fullenrich-content-engagers`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/Othmane-Khadri/YALC-the-GTM-operating-system/blob/HEAD/.claude/skills/fullenrich-content-engagers/SKILL.md
- Repository: Othmane-Khadri/YALC-the-GTM-operating-system (259 GitHub stars when collected)

## SKILL.md

# FullEnrich Content Engagers

One command turns a list of leads into a CSV of ICP-qualified prospects with verified work emails and phones. Two input modes:

- **URL mode** — scrape engagers from a LinkedIn post via Unipile
- **CSV mode** — bring your own list (any source: Sales Navigator export, PhantomBuster, Evaboot, manual paste, etc.)

Both modes converge on the same ICP filter + FullEnrich enrichment pipeline.

## When This Skill Applies

- "enrich people who engaged with this post {URL}"
- "qualify post engagers with FullEnrich"
- "scrape and enrich LinkedIn post {URL}"
- "engagers from {URL} into a CSV"
- "enrich this CSV of leads with FullEnrich"
- "qualify and enrich leads.csv"

## What This Skill Does NOT Do

- Does not write outreach copy. Pair with `personalize-message` after.
- Does not push to a CRM.
- **Does not spend credits without explicit user approval.** See "Credit safety contract" below.

## Credit safety contract (MANDATORY)

This skill spends FullEnrich credits, which cost real money. Safeguards:

1. **Always shows current balance** before doing anything.
2. **Always shows estimated cost** of the run.
3. **`--max-credits N` ceiling** (default 500) — auto-trims the contact list to fit.
4. **Hard-approval prompt** — blocks on stdin until the user types `yes`. If stdin is not a TTY, the script aborts unless `--yes` is passed.
5. **`--dry-run` mode** — scrapes engagers + applies ICP without spending a credit.

**When Claude invokes this skill on a user's behalf:**
1. ALWAYS run with `--dry-run` first to surface the engager count, ICP-pass count, and estimated cost.
2. Quote the EXACT estimated credit cost back to the user.
3. WAIT for explicit user confirmation before re-running without `--dry-run`.
4. Only pass `--yes` to the script when the user has approved the spend in this conversation.
5. Exception: respect locally modified scripts — the user took ownership.

## Prerequisites

URL mode requires all four:
```
FULLENRICH_API_KEY=    # https://app.fullenrich.com/app/api
UNIPILE_API_KEY=       # https://dashboard.unipile.com
UNIPILE_DSN=           # e.g. https://api18.unipile.com:14891
UNIPILE_ACCOUNT_ID=    # the LinkedIn account ID under Unipile
```

CSV mode requires only:
```
FULLENRICH_API_KEY=
```

Optional (both modes):
```
FULLENRICH_WEBHOOK_URL=  # public URL for FullEnrich callbacks; otherwise webhook.site fallback
```

## Workflow

1. **Resolve input source**
   - URL mode: resolve `social_id` via Unipile `get-post`, then `list-post-comments` + `list-post-reactions`.
   - CSV mode: parse `--csv` file, map columns (case-insensitive header aliases for `first_name`, `last_name`, `linkedin_url`, `title`, `company`, etc.).
2. **Dedupe** — keyed on `linkedin_url` when present, otherwise `first_name|last_name|company`. Rows missing first_name AND (linkedin_url OR company) are dropped.
3. **Apply ICP filter** — load `config/icp.json` (job-title regex, seniority allow-list, geo, company-size), score each contact 0–100, drop everything below the threshold.
4. **Estimate cost + confirm** — show the cost preview, block on stdin for `yes`.
5. **Enrich** — chunk into ≤100 contacts per FullEnrich bulk request with `enrich_fields: ["contact.work_emails", "contact.phones"]`.
6. **Receive callbacks** — webhook payloads land within ~30s per batch.
7. **Write outputs** — `qualified-engagers.csv` (passed ICP + enriched) and `qualified-engagers-disqualified.csv` (failed ICP, kept for inspection).

## CLI Reference

```
# URL mode
node scripts/run.mjs <linkedin-post-url-or-post-id> [flags]

# CSV mode
node scripts/run.mjs --csv path/to/leads.csv [flags]

Flags (shared):
    [--out path.csv]           # default qualified-engagers.csv
    [--icp config/icp.json]    # ICP rules file
    [--threshold 50]           # ICP minimum score (0-100)
    [--max <N>]                # URL mode: page cap. CSV mode: hard row cap. (default 500)
    [--max-credits <N>]        # hard credit ceiling (default 500)
    [--dry-run]                # filter + cost preview, no spending
    [--yes | -y]               # skip the interactive approval prompt
```

## CSV column conventions

The parser accepts the most common header naming conventions case-insensitively. For each contact field, the first matching header wins:

| Internal field | Accepted CSV headers |
|---|---|
| `first_name` | `first_name`, `firstname`, `first name`, `given_name` (or split from `name` / `full_name`) |
| `last_name`  | `last_name`, `lastname`, `last name`, `surname`, `family_name` (or split from `name` / `full_name`) |
| `linkedin_url` | `linkedin_url`, `linkedin`, `profile_url`, `linkedin profile`, `linkedin_profile_url` |
| `title` | `title`, `job_title`, `headline`, `position`, `current_position` |
| `company_name` | `company`, `company_name`, `current_company`, `organization`, `employer` |
| `domain` | `domain`, `company_domain`, `website` |

See `examples/sample-leads.csv` for a minimal working CSV.

## Reference

- Shared API client: `./scripts/lib/fullenrich-client.mjs`
- Shared webhook receiver: `./scripts/lib/fullenrich-webhook.mjs`
- Shared CSV writer: `./scripts/lib/csv.mjs`
- ICP config: `config/icp.json` (editable per use case)
- FullEnrich v2 docs: `https://docs.fullenrich.com/llms.txt`

---

Source: https://www.openparable.com/skill/apps-automation/fullenrich-content-engagers (OpenParable). Cite the canonical URL above.
