Skip to content

Latest commit

 

History

History

dataflow-tree

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 

README.md

DataFlowTree

Built with Hyperbrowser

A CLI tool that analyzes websites for PII data collection and privacy compliance. Uses AI to detect forms, tracking scripts, and personal data flows.

Features

🔍 Detects PII collection - Forms collecting email, phone, addresses, payment info
📊 Analytics tracking - Google Analytics, Segment, Facebook pixels
🌳 Visual flow trees - Colored ASCII output showing data flows
🚨 CI mode - Alerts on new PII endpoints for compliance monitoring

Setup

  1. Get an API key at https://hyperbrowser.ai

  2. Create environment file:

    echo "HYPERBROWSER_API_KEY=your_api_key_here" > .env
  3. Install dependencies:

    npm install

Usage

Analyze a website:

npx ts-node index.ts --url https://example.com

JSON output:

npx ts-node index.ts --url https://github.com --json

CI mode (exits 1 on new PII):

npx ts-node index.ts --url https://openai.com --ci

Help:

npx ts-node index.ts --help

Output

🌳 Data Flow Tree:
https://github.com
├─ POST /api/form   [PII: email, password, name]
└─ POST /collect   [Analytics]

📊 Summary:
🔴 PII requests: 1
🔵 Analytics requests: 1
⚪ Business requests: 1

Results are saved to out/flows.json for further analysis.


Follow @hyperbrowser_ai for updates.