Skip to content

iwes247/online-data-removal

Repository files navigation

Online Data Removal Tool

Automates searching and opting out of data broker sites that list your personal information. Based on opt-out guides from Cloaked.com.

How it works

  1. Search phase — visits each broker site, searches for your name, and scrapes the free preview listing
  2. Review phase — saves results to reports/ so you can confirm matches before removal
  3. Opt-out phase — submits removal requests only for confirmed matches

Setup

pip install -r requirements.txt
playwright install chromium

Copy config.example.py to config.py and fill in your details. config.py is gitignored and will never be committed.

Run

# 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.70

Discover More Brokers

Scrape 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

Supported Sites (32 Total)

Original Brokers (5)

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

PeopleConnect Family (12)

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

Direct Removal Forms (4)

Site Search Opt-Out Notes
AdvancedBackgroundChecks ⚠️ CAPTCHA required
CyberBackgroundChecks ⚠️ CAPTCHA required
ClustrMaps ⚠️ Requires profile URL
AllAreaCodes ⚠️ Phone verification

Other Data Brokers (11)

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

Notes

  • 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: true in the approval report
  • Candidate-level approval is required: set approved_candidate_id for each approved broker
  • In --mode all, the approval template is written to the path you pass in --approved-report

Testing

pip install -r requirements-dev.txt
pytest -q

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages