How to weekly new-JDG

## Why it has a real chance
Every new Polish sole trader (JDG) needs bookkeeping, ZUS handling, often OC insurance and a bank account in the first weeks. KRS covers companies; **CEIDG** covers sole proprietorships — a different and larger daily flow. The Ministry exposes a free CEIDG Data Warehouse API (`dane.biznes.gov.pl`, API v3) after a Biznes.gov.pl account and access request (Profil Zaufany / e-dowód / qualified signature). Documentation: https://pliki.biznes.gov.pl/akademia/20250117/HD%20CEIDG%20-%20API%20v3%20HD%20-%20Dokumentacja%20dla%20integrator%C3%B3w%20v1.1.pdf . Practical overview of free channels and rate limits: https://dane-firm.pl/poradnik/jak-pobrac-dane-z-ceidg .

This is complementary to (not a copy of) the existing KRS new-company alert recipe.

## Who does what
**Bot:** once API access exists, pulls new/changed CEIDG entries for one województwo + a few PKD codes; normalises a weekly CSV (legal name, NIP/REGON if present, start date, PKD, city — **company register fields only**); writes a short digest email; keeps an opt-out list.
**Human:** creates the Biznes.gov.pl account, requests Hurtownia danych access, stores the API credential in their password manager (never in a shared bot file), sells the first 3 accountant/insurer subscriptions, handles invoices and GDPR basis (legitimate interest / contract — confirm with their counsel).

## First 48 hours
1. Hour 0–8 (human): register on Biznes.gov.pl and submit the CEIDG data-warehouse access request; meanwhile bot drafts the sample digest layout and privacy note.
2. Hour 8–24 (bot): build the pipeline against the **test** host `test-dane.biznes.gov.pl` using the integrator docs; document the production rate limits from the official PDF.
3. Hour 24–40 (bot): produce one sample week from public CEIDG search pages if the API key is not yet live, clearly labelled “sample / manual”, to show buyers the format.
4. Hour 40–48 (human): send the sample to 10 local accountancy offices; price a monthly subscription only after two conversations — do not invent a market rate.

## Tooling ($0)
Official CEIDG API (free after access grant), Google Sheets, a free email tool for the digest.

## First-week metric
Access request submitted + 1 sample digest delivered to at least 5 prospects; then count paying subscribers (aim for the first paid month within 30 days of API access).

## Honesty notes
Respect API rate limits and the terms of Hurtownia danych. Send **register data only**, never scraped private emails or phone numbers from random websites. GDPR applies — document your lawful basis before cold outreach. Access is free but not anonymous; the human must approve every credential step.