{"id":21170058,"url":"https://github.com/covenantsql/cookiescanner","last_synced_at":"2025-04-13T09:44:31.785Z","repository":{"id":57510661,"uuid":"177974728","full_name":"CovenantSQL/CookieScanner","owner":"CovenantSQL","description":"Cookie Scanner for GDPR compliance","archived":false,"fork":false,"pushed_at":"2023-05-31T08:38:17.000Z","size":17647,"stargazers_count":187,"open_issues_count":8,"forks_count":47,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-27T01:11:36.466Z","etag":null,"topics":["cookie","covenantsql","cql","gdpr","privacy"],"latest_commit_sha":null,"homepage":"https://gdprexpert.io/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CovenantSQL.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-27T10:52:37.000Z","updated_at":"2024-12-06T09:02:56.000Z","dependencies_parsed_at":"2024-06-18T21:22:34.303Z","dependency_job_id":"ad504021-f2a3-4a34-8d28-0425d76ed41c","html_url":"https://github.com/CovenantSQL/CookieScanner","commit_stats":null,"previous_names":["covenantsql/cookietester"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CovenantSQL%2FCookieScanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CovenantSQL%2FCookieScanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CovenantSQL%2FCookieScanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CovenantSQL%2FCookieScanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CovenantSQL","download_url":"https://codeload.github.com/CovenantSQL/CookieScanner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248694173,"owners_count":21146944,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cookie","covenantsql","cql","gdpr","privacy"],"created_at":"2024-11-20T15:55:52.234Z","updated_at":"2025-04-13T09:44:31.761Z","avatar_url":"https://github.com/CovenantSQL.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cookie Scanner\n\nGDPR requires that all websites that provide services to European users must provide a complete report on the use of cookies to record user information and continue to use it with the express consent of the user.\nThere are several commercial Cookie Scanner online.\n\nBut we decide to make our implementation Open Source. Hope to help more people getting aware of the privacy problems.\n\nCookie Scanner is a simple utility to analyze website cookie status and generate reports for GDPR-compliance.\n\nFor how to use the \"Cookie Database\", please see [CQL QuickStart](https://developers.covenantsql.io/docs/en/quickstart)\n\n\u003cp align=\"center\"\u003e\n   \u003ca href=\"./example/reddit-cookie.pdf\"\u003e \u003cimg src=\"./example/reddit-cookie.png\" width=\"150\"\u003e\u003c/a\u003e\n   \u003ca href=\"./example/amazon-cookie.pdf\"\u003e \u003cimg src=\"./example/amazon-cookie.png\" width=\"150\"\u003e\u003c/a\u003e\n   \u003ca href=\"./example/netflix-cookie.pdf\"\u003e \u003cimg src=\"./example/netflix-cookie.png\" width=\"150\"\u003e\u003c/a\u003e\n   \u003ca href=\"./example/ebay-cookie.pdf\"\u003e \u003cimg src=\"./example/ebay-cookie.png\" width=\"150\"\u003e\u003c/a\u003e\n   \u003ca href=\"./example/google-cookie.pdf\"\u003e \u003cimg src=\"./example/google-cookie.png\" width=\"150\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nFrontpage sets Cookie without user Consent:\n- Amazon.com: [9 Cookies](./example/amazon-cookie.pdf)\n- Reddit.com: [9 Cookies](./example/reddit-cookie.pdf)\n- Netflix.com: [6 Cookies](./example/netflix-cookie.pdf)\n- Ebay.com: [5 Cookies](./example/ebay-cookie.pdf)\n- Google.com: [2 Cookies](./example/google-cookie.pdf)\n- Facebook.com: 0 Cookie\n\n### Features\n\n1. Nice HTML or PDF report\n\n1. Detailed cookie description\n\n1. We collected more than 10000 cookie description and put them in free DB service CQL:\n\n  - DSN: covenantsql://050cdf3b860c699524bf6f6dce28c4f3e8282ac58b0e410eb340195c379adc3a\n  - [Config \u0026 Key](./config)\n\n\n### Online Demo\n\nYour can just try Cookie Scanner on [gdprExpert.io](https://gdprexpert.io/)\n\n### Installation\n\nRequires MacOS/Linux system.\n\nFirst, install [`Google Chrome`](https://www.google.com/chrome/) in your operating system.\nOr you can start a headless Chrome in docker with\n\n```shell\n$ docker container run -d -p 9222:9222 zenika/alpine-chrome --no-sandbox \\ \n --remote-debugging-address=0.0.0.0 --remote-debugging-port=9222\n```\n\nThen, install the `CookieScanner` using `go get`.\n\n```shell\n$ go get github.com/CovenantSQL/CookieScanner\n```\n\n### Usage\n\nCookieScanner is capable of geneating reports in `json/html/pdf` format.\n\n```\n$ CookieScanner --help\nusage: CookieScanner [\u003cflags\u003e] \u003ccommand\u003e [\u003cargs\u003e ...]\n\nwebsite cookie usage report generator\n\nFlags:\n  --help                   Show context-sensitive help (also try --help-long\n                           and --help-man).\n  --chrome=CHROME          chrome application to run as remote debugger\n  --verbose                run debugger in verbose mode\n  --timeout=1m0s           timeout for a single cookie scan\n  --wait=WAIT              wait duration after page load in scan\n  --classifier=CLASSIFIER  classifier database for cookie report\n  --log-level=LOG-LEVEL    set log level\n\nCommands:\n  help [\u003ccommand\u003e...]\n    Show help.\n\n  cli [\u003cflags\u003e] \u003csite\u003e\n    generate report for a single website\n\n  version\n    get debugger version\n\n  server [\u003cflags\u003e]\n    start a report generation server\n\n$ CookieScanner cli --help\nusage: CookieScanner cli [\u003cflags\u003e] \u003csite\u003e\n\ngenerate report for a single website\n\nFlags:\n  --help                   Show context-sensitive help (also try --help-long\n                           and --help-man).\n  --chrome=CHROME          chrome application to run as remote debugger\n  --verbose                run debugger in verbose mode\n  --timeout=1m0s           timeout for a single cookie scan\n  --wait=WAIT              wait duration after page load in scan\n  --classifier=CLASSIFIER  classifier database for cookie report\n  --log-level=LOG-LEVEL    set log level\n  --headless               run chrome in headless mode\n  --port=9222              chrome remote debugger listen port\n  --json                   print report as json\n  --html=HTML              save report as html\n  --pdf=PDF                save report as pdf\n\nArgs:\n  \u003csite\u003e  site url\n```\n\n### Examples\n\nGenerate HTML report for `covenantsql.io` using cli mode.\n\n```shell\n$ CookieScanner cli \\\n    --headless \\\n    --classifier \"covenantsql://050cdf3b860c699524bf6f6dce28c4f3e8282ac58b0e410eb340195c379adc3a?config=./config/config.yaml\" \\\n    --html cql.html covenantsql.io\n```\n\nJust wait for a while, you will found `cql.html` showing results like this:\n\n![](./example.png)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcovenantsql%2Fcookiescanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcovenantsql%2Fcookiescanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcovenantsql%2Fcookiescanner/lists"}