list-expander

Expand seed companies into a qualified TAM list via lookalike APIs and AI scoring.

Updated May 28, 2025
One-click install
npx skills add https://github.com/meloShaya/insteltech --skill list-expander-meloshaya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: list-expander
Source: https://github.com/meloShaya/insteltech/tree/main/crm/library/skills/list-expander
Command: npx skills add https://github.com/meloShaya/insteltech --skill list-expander-meloshaya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Niche B2B lists come out tiny because database keyword searches miss good-fit companies that aren't tagged with the obvious keyword. This Skill works bottom-up from ~10 known-good seed companies: it fingerprints how they actually appear in the company database, expands them through lookalike engines, mines high-precision filters, and pulls and AI-qualifies the full market at scale. ## Core Features & Use Cases - Seed fingerprinting and lookalike expansion: Discovers how seeds are tagged in Prospeo, then generates candidates via Prospeo company_lookalike, Exa findSimilar, and Parallel.ai entity search. - Filter mining with a precision scorecard: Mines industries and keyword n-grams from confirmed fits, then scores each candidate filter on volume and sampled precision before the wide pull. - Scaled qualification and verification: Scores thousands of companies with a cheap OpenAI model, verifies live websites to remove dead or parked domains, and produces a client-facing HTML transparency report with a verified-email TAM ceiling. - Use Case: A client says their medical-groups list of 200 companies should be much bigger. Feed 10 known-fit domains in, and the pipeline returns thousands of AI-qualified, website-verified companies plus a report showing exactly how the list was built. ## Quick Start Ask the AI to expand a list by running the list-expander pipeline starting with fingerprint.ts on your seed domains, for example: expand these 10 seed companies into a full qualified TAM for US multi-site medical groups.

Frequently Asked Questions about list-expander

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I expand a small B2B company list into a full TAM?

Start with about 10 seed domains known to fit, fingerprint them against Prospeo, generate lookalike candidates, mine and score filters from confirmed fits, then pull widely and AI-qualify every company. The pipeline scripts run with npx tsx and write artifacts to ~/output/list-expander/{run}/.

What lookalike data sources does the pipeline use?

It uses Prospeo company_lookalike as the required lane, plus optional Exa findSimilar and Parallel.ai entity-search lanes. Optional lanes are skipped with a log line when their API key is unset, so a run completes on Prospeo alone.

What API keys are required to run the list expansion scripts?

PROSPEO_API_KEY and OPENAI_API_KEY are required for company search and AI qualification. EXA_API_KEY and PARALLEL_AI_API_KEY are optional extra lookalike lanes, and keys load from the repo-root .env or ~/.env.

Why does Prospeo rate limit the pull and how is it handled?

The Prospeo account limit is global, so all processes pace requests through a shared slot file with a 450ms floor and a shared 45-second penalty after any 429. Identical request re-runs within 30 days are free, so re-pulling after a partial failure costs nothing.

How does the pipeline handle Prospeo result limits above 25k?

Any filter set whose total_count exceeds 24k is automatically sharded, first from country-wide into 51 US states, then by headcount-band bisection. This ensures the tail of large filter sets is never truncated during the wide pull.

Why verify company websites after AI qualification?

Database descriptions lag reality and happily qualify companies whose websites are dead or parked. The verify-website.ts pass fetches each qualified homepage live, classifies dead or suspended-parked sites, and re-judges live sites on current content before the list ships.