champion-tracker

Champion Tracker

Detect when product champions change jobs and qualify their new companies against ICP.

When to Use

• You have a list of known product users/champions (from reviews, LinkedIn posts, CRM exports)
• You want to detect when they change companies (high-intent re-sell signal)
• You want each job change scored against ICP before reaching out

Two Phases

Phase A: Discover Champions (agent-driven, one-time)

Build the initial champion list from public sources. This is done by the agent, not the script.

1. Scrape reviews — Use review-site-scraper skill to pull G2/Trustpilot reviews. Extract reviewer names + companies.
2. Search LinkedIn posts — Use the linkedin-post-research skill (Apify-based) to find people who posted about the product.
3. Resolve LinkedIn URLs — Use Fiber /v1/kitchen-sink/person (name + company → profile URL) or ContactOut via Orthogonal.
4. Compile CSV — Merge all sources into champions.csv with required columns.

Phase B: Track Job Changes (script-driven, repeatable)

Use champion_tracker.py for ongoing tracking.

Script Usage

Prerequisites

• APIFY_API_TOKEN in .env (for LinkedIn profile enrichment)
• Champion CSV with columns: name, linkedin_url (required); original_company, original_title, email, source, notes (optional)

Commands

Initialize baseline (first run):

# Dry run — see cost estimate
python3 skills/champion-tracker/scripts/champion_tracker.py init -i champions.csv --dry-run

# Create baseline
python3 skills/champion-tracker/scripts/champion_tracker.py init -i champions.csv

Check for job changes (subsequent runs):

# Dry run
python3 skills/champion-tracker/scripts/champion_tracker.py check --dry-run

# Detect changes and output CSV
python3 skills/champion-tracker/scripts/champion_tracker.py check -o changes.csv

View status:

python3 skills/champion-tracker/scripts/champion_tracker.py status

Output CSV Columns

Column	Description
champion_name	Full name
linkedin_url	LinkedIn profile URL
previous_company	Company at baseline
previous_title	Title at baseline
new_company	Current company (changed)
new_title	Current title
change_detected_date	Date this check was run
position_start_date	When they started the new role
days_since_change	Days since new position started
icp_score	0-4 ICP qualification score
icp_verdict	Strong Fit / Good Fit / Possible Fit / Weak Fit
icp_notes	Scoring breakdown
email	Email if available
notes	Original notes from champion CSV

ICP Scoring (0-4)

Signal	Points	What it checks
B2B signal	1.0	Title contains sales/SDR/revenue/growth keywords
Outbound motion	1.0	Sales leadership title (VP Sales, Head of Growth, etc.)
Company size	1.0 / 0.5	SMB/mid-market = 1.0; unknown = 0.5 benefit-of-doubt
Seniority	1.0	VP, Director, Head of, C-level, Founder

Verdicts: Strong Fit (>=3) / Good Fit (>=2) / Possible Fit (>=1.5) / Weak Fit (<1.5)

Cost

• ~$3 per 1,000 LinkedIn profiles enriched
• 50-80 champions ≈ $0.15-0.25 per run
• --dry-run always shows cost before any API calls

File Structure

skills/champion-tracker/
  SKILL.md                    # This file
  scripts/
    champion_tracker.py       # Main CLI script
  input/
    champions_template.csv    # Template for manual additions
  snapshots/                  # Created at runtime
    baseline.json             # Latest full snapshot
    archive/                  # Timestamped copies
  output/                     # Created at runtime
    changes-YYYY-MM-DD.csv    # Generated output

Dependencies

• Reuses LinkedInEnricher from skills/lead-qualification/scripts/enrich_leads.py
• Falls back to inline implementation if import fails
• Requires: requests (Python package), APIFY_API_TOKEN (env var)