# Prospeo Full Export

Export your entire Prospeo people search to CSV.

- Repository: https://github.com/growthenginenowoslawski/coldoutboundskills (797 stars)
- Category: Design
- License: MIT
- Last updated: 2026-10-05
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add growthenginenowoslawski/coldoutboundskills --skill prospeo-full-export -g -a claude-code -y`
Codex: `npx skills add growthenginenowoslawski/coldoutboundskills --skill prospeo-full-export -g -a codex -y`
Cursor: `npx skills add growthenginenowoslawski/coldoutboundskills --skill prospeo-full-export -g -a cursor -y`
Gemini CLI: `npx skills add growthenginenowoslawski/coldoutboundskills --skill prospeo-full-export -g -a gemini-cli -y`

## Description

Export your entire Prospeo people search to CSV. Build filters in Prospeo's UI, then use this skill to extract every result via the API, even searches over 25K. Handles pagination, rate limiting, deduplication, and state-by-state splitting automatically. Pair with /icp-prompt-builder on a 50-person sample to tune a qualification prompt BEFORE exporting 25K.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Prospeo Full Search Export

Extract your entire Prospeo people search to a CSV file. Build your search in Prospeo's UI, then let Claude pull every single result via the API, even if the search has more than 25,000 results.

## Required step: Qualify with /icp-prompt-builder (do not skip)

Before exporting more than 500 contacts, run Prospeo on a 50-contact sample, then invoke `/icp-prompt-builder` to tune a qualification prompt in 3-5 rounds of 10 (with your approval each round). Apply the tuned prompt to the full export to filter out bad fits.

**Why required:** email enrichment downstream costs $0.05-$0.15 per person. A 25K export that's 40% wrong-fit wastes $500-$1,500 on email-finding that goes nowhere. The ICP prompt builder takes 10-15 min and saves that cost 40-70% of the time.

**Safe skip:** only if your Prospeo filter is already extremely tight (e.g., 5 exact titles + 1 industry + narrow headcount) AND you've run the same filter successfully before. Even then, run `/icp-prompt-builder` on 10 samples as a sanity check, it's nearly free to confirm.

## What This Does

1. You build a search in Prospeo's web UI (filters for title, location, industry, company size, etc.)
2. You tell Claude what filters you used
3. Claude translates those filters into Prospeo API calls
4. Claude paginates through every page of results and exports to CSV
5. For large US searches (25K+), Claude automatically splits by state to get everything

## Setup (First Time Only)

### Step 1: Create a Prospeo Account

1. Go to [prospeo.io](https://prospeo.io) and sign up
2. Choose a plan that includes the **Search Person API** (most paid plans do)
3. Each API request that returns results costs **1 credit** and returns 25 contacts

### Step 2: Get Your API Key

1. Log into Prospeo
2. Go to **Settings > API** (or visit [prospeo.io/app/settings/api](https://prospeo.io/app/settings/api))
3. Copy your API key

### Step 3: Set Your API Key

The rest: https://github.com/growthenginenowoslawski/coldoutboundskills/blob/HEAD/skills/prospeo-full-export/SKILL.md