cookiescanner

README

Cookie Tester

Cookie Tester is a simple utility to analyze website cookie status and generate reports for GDPR-compliance.

Installation

Requires MacOS/Linux system.

First, install Google Chrome in your operating system. Or you can start a headless Chrome in docker with

$ docker container run -d -p 9222:9222 zenika/alpine-chrome --no-sandbox \ 
 --remote-debugging-address=0.0.0.0 --remote-debugging-port=9222

Then, install the CookieTester using go get.

$ go get github.com/CovenantSQL/CookieTester

Usage

CookieTester is capable of geneating reports in json/html/pdf format.

$ CookieTester --help
usage: CookieTester [<flags>] <command> [<args> ...]

website cookie usage report generator

Flags:
  --help                 Show context-sensitive help (also try --help-long and --help-man).
  --chrome=CHROME        chrome application to run as remote debugger
  --verbose              run debugger in verbose mode
  --timeout=1m0s         timeout for a single cookie scan
  --wait=WAIT            wait duration after page load in scan
  --log-level=LOG-LEVEL  set log level

Commands:
  help [<command>...]
    Show help.

  cli [<flags>] <site>
    generate report for a single website

  version
    get debugger version

  server [<flags>]
    start a report generation server

$ CookieTester cli --help
usage: CookieTester cli [<flags>] <site>

generate report for a single website

Flags:
  --help                 Show context-sensitive help (also try --help-long and --help-man).
  --chrome=CHROME        chrome application to run as remote debugger
  --verbose              run debugger in verbose mode
  --timeout=1m0s         timeout for a single cookie scan
  --wait=WAIT            wait duration after page load in scan
  --log-level=LOG-LEVEL  set log level
  --headless             run chrome in headless mode
  --port=9222            chrome remote debugger listen port
  --json                 print report as json
  --html=HTML            save report as html
  --pdf=PDF              save report as pdf

Args:
  <site>  site url

Examples

Generate HTML report for www.google.com using cli mode.

$ CookieTester cli --headless --html google.html www.google.com

Just wait for a while, you will found google.html showing results containing cookie descriptions like NID.