Pain-Language Engagers

Find warm leads by scraping LinkedIn for pain-language posts and their engagers. People who write about, react to, or comment on posts expressing operational frustrations are signaling they live with a problem your product solves. This skill turns those signals into a qualified lead list.

Core principle: Search for pain-language, not solution-language. Solution keywords ("AI automation", "workflow optimization") attract builders and VCs. Pain keywords ("can't find drivers", "check calls are killing us") attract operators living with the problem.

Phase 0: Intake

Before generating keywords or running anything, ask the user these questions. Present them as a numbered list and tell the user to answer what's relevant and skip what's not.

Product & Pain Context

What does your product/service do in one sentence?
What specific problem does it solve? Who feels this pain most acutely?
What does your ICP's day-to-day look like WITHOUT your product? (The frustrations, workarounds, manual processes)
What phrases would someone use when complaining about this problem on LinkedIn? (e.g., "check calls are killing us", "can't find drivers", "spending hours on manual data entry")

ICP Definition

What industries/verticals are your target buyers in?
What job titles or roles are your ideal buyers? (e.g., "VP Operations", "Broker owner", "Head of Logistics")
What titles should be EXCLUDED? (e.g., "Software Engineer", "AI researcher")
Any specific competitors whose employees should be filtered out?
Geographic focus? (e.g., "United States only", "global")

LinkedIn Signal Sources

Any LinkedIn company pages where your ICP is likely to engage? (Industry publications, communities, competitor pages)
Any specific LinkedIn posts or content creators your ICP follows?

Phase 1: Generate Pain-Language Keywords

Based on the intake answers, generate ~15-25 pain-language keywords in LinkedIn boolean search syntax. Organize into categories:

Staffing/Resource Pain — hiring difficulties, turnover, burnout
Operational Friction — manual processes, missed SLAs, communication breakdowns
Margin/Growth Pain — cost pressure, scaling challenges
Process Complaints — specific workflow frustrations

Key principle: Every keyword should be something a frustrated operator would actually type or say, not marketing language or solution framing.

Also generate:

ICP keyword list — industry terms for ICP classification (from answer #5)
Tech vendor exclusion list — competitor names + generic tech titles (from answers #7, #8)
Pain-pattern regexes — for filtering company page posts (derived from the keywords)
Broad topic patterns — industry terms for known industry page filtering
Hardcoded company pages — from answer #10, plus any the agent suggests based on the industry

Present the full keyword list to the user for approval/refinement before running. This is the most critical step — bad keywords = bad leads.

Once approved, save the complete config as JSON:

# Save config
skills/pain-language-engagers/configs/{client-name}.json

Config JSON structure:

{
  "client_name": "example-client",
  "pain_keywords": ["\"can't find X\"", "\"hiring Y\" problems"],
  "pain_patterns": ["can.t find X", "hiring Y", "manual.*process"],
  "icp_keywords": ["industry-term-1", "industry-term-2"],
  "tech_vendor_keywords": ["software engineer", "competitor-name"],
  "hardcoded_companies": ["https://www.linkedin.com/company/example/"],
  "industry_pages": ["https://www.linkedin.com/company/example/"],
  "broad_topic_patterns": ["industry", "sector", "niche-term"],
  "country_filter": "United States",
  "days_back": 60,
  "max_posts_per_keyword": 50,
  "max_posts_per_company": 100
}

Phase 2: Run LinkedIn Scraping Pipeline

Execute the pipeline script with the saved config:

python3 skills/pain-language-engagers/scripts/pain_language_engagers.py \
  --config skills/pain-language-engagers/configs/{client-name}.json \
  [--test] [--companies "url1,url2"]

Flags:

--config (required) — path to the client config JSON
--test — limit to 3 keywords, 5 posts per company (for validation)
--skip-discovery — skip keyword search, only scrape hardcoded/extra companies
--companies "url1,url2" — add extra company URLs to scrape

What the script does:

Keyword search — harvestapi/linkedin-post-search for each pain keyword
Post author extraction — People who wrote pain posts = direct leads (free, no API call)
Company page discovery — Extract company pages from keyword results
Company page engager scraping — harvestapi/linkedin-company-posts for each company page, pain-filtered
Profile enrichment — supreme_coder/linkedin-profile-scraper for all profiles (gets headline + location)
ICP classification — Using the client-specific ICP/vendor keyword lists from config
Dedup + CSV export

Cost estimate:

Keyword search: ~~$0.10 per keyword (~~$2 for 20 keywords)
Company page scraping: ~~$0.002 per post per company (~~$0.20 per company)
Profile enrichment: ~$0.003 per profile
Full run with 20 keywords + 10 companies: ~$5-10

Always run with --test first to validate the config produces relevant results before a full run.

Phase 3: Review & Refine

After the script completes, present results to the user:

ICP breakdown — counts by tier (Likely / Possible / Unknown / Tech Vendor)
Top 15 Likely ICP leads — name, role, company, engagement type
Sample of filtered-out leads — so user can catch false negatives
Keyword performance — which keywords produced the most leads, which were duds

If the user wants adjustments:

Update the config JSON (add/remove keywords, adjust ICP lists)
Re-run the script
Repeat until the user is satisfied

Common adjustments:

Too many Tech Vendor results — add more vendor names to tech_vendor_keywords
Missing obvious ICP leads — add more industry terms to icp_keywords
Irrelevant posts — refine pain_patterns to be more specific
Not enough results — add more keywords or reduce days_back constraint

Phase 4: Output

CSV exported to skills/pain-language-engagers/output/{client-name}-{date}.csv with columns:

Column	Description
Name	Full name
LinkedIn Profile URL	Profile link
Role	Parsed from headline
Company Name	Parsed from headline
Location	From profile enrichment
Source Page	Which company page(s) they engaged on
Post URL(s)	Links to the post(s) they engaged with
Engagement Type	Post Author, Comment, or Reaction
Comment Text	Their comment (if applicable — personalization gold)
ICP Tier	Likely ICP, Possible ICP, Unknown, or Tech Vendor
Niche Keyword	Which pain keyword matched

Tools Required

Apify API token — set as APIFY_API_TOKEN in .env
Apify actors used:
- harvestapi/linkedin-post-search (keyword search)
- harvestapi/linkedin-company-posts (company page scraping)
- supreme_coder/linkedin-profile-scraper (profile enrichment)

Example Usage

Trigger phrases:

"Find people complaining about [problem] on LinkedIn"
"LinkedIn pain-based prospecting for [product]"
"Find leads who are discussing [pain point]"
"Scrape LinkedIn for [industry] pain posts"
"Run the pain-language engagers pipeline for [client]"

With existing config:

python3 skills/pain-language-engagers/scripts/pain_language_engagers.py \
  --config skills/pain-language-engagers/configs/happy-robot.json

Test mode:

python3 skills/pain-language-engagers/scripts/pain_language_engagers.py \
  --config skills/pain-language-engagers/configs/happy-robot.json --test