01-prospeo-discover

# 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. ## API basics ``` Base URL: https://api.prospeo.io Auth header: X-KEY: $PROSPEO_API_KEY Content-Type: application/json ``` Three endpoints: - `GET /account-information` - plan and credit balance (free) - `POST /search-company` - the search (1 credit per page) - `POST /search-suggestions` - resolve locations, technologies, industries, and other open-ended values (fre...