How thihal/consent-audit works
consent-audit is a browser-based consent and device-fingerprinting auditor. Its main workflow starts with a configured site or CLI request, runs isolated browser visits, captures consent-state evidence, classifies cookies and identifiers, checks findings, and writes JSON/Markdown reports. A second experiment compares selected identifiers across fresh contexts. The README also documents a Claude Code plugin/skill integration; its implementation details are not shown in the sampled source, so that branch is omitted.
Main entry points: audit.py Audit orchestration · cli.py CLI commands · browser.py Browser context capture · example.com.yaml Site settings
Components 15
Invocation and configuration
- Site settings
sites/example.com.yaml - CLI commands
consent_audit/cli.py
Browser experiments
- Audit orchestration
consent_audit/audit.py - Browser context capture
consent_audit/browser.py - Consent states
consent_audit/audit.py - Isolated contexts
consent_audit/audit.py
Evidence analysis
- Captured state
consent_audit/audit.py - Cookie and host classification
consent_audit/parse.py - Identity cookie parsing
consent_audit/parse.py - Cross-context matching
consent_audit/audit.py - Consent findings
consent_audit/audit.py
Findings and reports
- Report rendering
consent_audit/report.py - JSON and Markdown reports
Other components
- Engineer
- Target website
Connections 19
- Engineer → CLI commands: invokes
README.md - Engineer → Site settings: configures
README.md - CLI commands → Audit orchestration: runs audit
consent_audit/cli.py - CLI commands → Report rendering: renders result
consent_audit/cli.py - Site settings → Audit orchestration: supplies settings
README.md - Audit orchestration → Browser context capture: requests capture
consent_audit/audit.py - Browser context capture → Target website: visits
consent_audit/browser.py - Audit orchestration → Consent states: runs states
README.md - Audit orchestration → Isolated contexts: runs visits
README.md - Browser context capture → Captured state: captures state
consent_audit/browser.py - Audit orchestration → Captured state: builds records
consent_audit/audit.py - Audit orchestration → Cookie and host classification: classifies cookies
consent_audit/audit.py - Audit orchestration → Identity cookie parsing: parses identifiers
consent_audit/audit.py - Audit orchestration → Cross-context matching: compares IDs
README.md - Captured state → Consent findings: informs checks
consent_audit/audit.py - Cookie and host classification → Consent findings: supports checks
consent_audit/audit.py - Identity cookie parsing → Cross-context matching: extracts IDs
consent_audit/audit.py - Audit orchestration → Consent findings: assembles findings
consent_audit/audit.py - Report rendering → JSON and Markdown reports: writes formats