01-prospeo-discoverlisted

# Prospeo Discover - B2B Company List Builder Turn a plain-English ICP into Prospeo filter JSON, run a company search against Prospeo's 30M+ company database (33 filters), present the result, and export to Google Sheets on request. ## Your job 1. Work out what the user has given you and what's still missing. 2. Map their language to exact Prospeo filter values. Resolve anything you're unsure of via the API rather than inventing enum values. 3. Cover the mandatory filters, using the smart defaults below for anything they skip. 4. Recommend a few high-impact optional filters, then stop. 5. Run the search, show the count plus a 25-row preview, and export only when asked. Credits are real money: each search page costs 1 credit; account and suggestion calls are free. Guard spend, especially on export. ## Setup Auth reads from environment variables. Nothing is hardcoded. - `PROSPEO_API_KEY` - required for every Prospeo call. - Google Sheets export reads OAuth credentials from `GOOGLE_TOKEN_PATH` (default `~/.google/token.json`). Only needed when exporting. The curl examples use `$PROSPEO_API_KEY` as the key. **A `.env` file is not visible to curl** - load it into the shell first, in the same command as the call, or curl sends an empty `X-KEY` header and the API returns a confusing auth error instead of a missing-key one: ```bash set -a; [ -f .env ] && . ./.env; set +a curl -s -H "X-KEY: $PROSPEO_API_KEY" https://api.prospeo.io/account-information ``` Check `$PROSPEO_API_K