Automates searching and opting out of data broker sites that list your personal information. Based on opt-out guides from Cloaked.com.
- Search phase — visits each broker site, searches for your name, and scrapes the free preview listing
- Review phase — saves results to
reports/so you can confirm matches before removal - Opt-out phase — submits removal requests only for confirmed matches
pip install -r requirements.txt
playwright install chromiumCopy config.example.py to config.py and fill in your details.
config.py is gitignored and will never be committed.
# Search only — see what sites have on you
python main.py --mode search
# Opt out only from brokers you approved in a report
python main.py --mode optout --approved-report reports/approval_template_YYYYMMDD_HHMMSS.json
# Both in sequence (requires approved report file path)
python main.py --mode all --approved-report reports/approval_template_YYYYMMDD_HHMMSS.json
# Optional: tune confidence threshold used in search report
python main.py --mode search --min-confidence 0.70Scrape the Cloaked opt-out guides to find additional data brokers:
python scripts/scrape_cloaked_guides.py
python scripts/scrape_cloaked_guides.py --output guides.json --categorize| Site | Search | Opt-Out | Notes |
|---|---|---|---|
| BeenVerified | ✅ | ✅ | Direct opt-out form |
| Spokeo | ✅ | ✅ | Requires listing URL |
| FastPeopleSearch | ✅ | ✅ | Direct opt-out |
| Whitepages | ✅ | ✅ | Suppression request |
| ZabaSearch | ✅ | ✅ | Direct opt-out |
These sites use a shared suppression system at suppression.peopleconnect.us.
The opt-out process requires email verification.
| Site | Search | Opt-Out | Notes |
|---|---|---|---|
| TruthFinder | ✅ | ✅ | Email verification required |
| InstantCheckmate | ✅ | ✅ | Email verification required |
| Intelius | ✅ | ✅ | Email verification required |
| PeopleFinder | ✅ | ✅ | Redirects to Intelius |
| USSearch | ✅ | ✅ | Email verification required |
| Addresses.com | ✅ | ✅ | Via Intelius |
| AnyWho | ✅ | ✅ | Via Intelius |
| PublicRecords | ✅ | ✅ | Via Intelius |
| ReversePhoneLookup | ✅ | ✅ | Via Intelius |
| OnlineSearches | ✅ | ✅ | Via Intelius |
| EasyBackgroundChecks | ✅ | ✅ | Via Intelius |
| FreeBackgroundChecksUSA | ✅ | ✅ | Via Intelius |
| Site | Search | Opt-Out | Notes |
|---|---|---|---|
| AdvancedBackgroundChecks | ✅ | CAPTCHA required | |
| CyberBackgroundChecks | ✅ | CAPTCHA required | |
| ClustrMaps | ✅ | Requires profile URL | |
| AllAreaCodes | ✅ | Phone verification |
These require manual opt-out via their specific processes.
| Site | Search | Opt-Out | Notes |
|---|---|---|---|
| AddressSearch | ✅ | Manual process | |
| Advanced-People-Search | ✅ | Manual process | |
| AllPeople | ✅ | Manual process | |
| BackgroundAlert | ✅ | Manual process | |
| BackgroundCheck.run | ✅ | Manual process | |
| BackgroundCheckers | ✅ | Manual process | |
| Centeda | ✅ | Manual process | |
| CorporationWiki | ✅ | Manual process | |
| Councilon | ✅ | Manual process | |
| CheckSecrets | ✅ | Manual process | |
| ClubSet | ✅ | Manual process |
- Sites with CAPTCHAs will be flagged for manual follow-up
- Sites that require email confirmation will be logged — you complete those manually
- Re-run the search phase periodically to check if listings reappear
- Search now stores confidence signals (name, age, location, etc.) for each listing
- Opt-out runs only for brokers marked
approved: truein the approval report - Candidate-level approval is required: set
approved_candidate_idfor each approved broker - In
--mode all, the approval template is written to the path you pass in--approved-report
pip install -r requirements-dev.txt
pytest -q