cyberbouncer
v0.1.1
Published
CLI for CyberBouncer — scan any website's security posture from the terminal or CI and gate on a minimum grade. "We check IDs at the door."
Maintainers
Readme
cyberbouncer
CLI for CyberBouncer — scan any website's security posture from the terminal or CI. Passive checks only (TLS, security headers, cookies, email auth, DNS, reputation), graded A–F. "We check IDs at the door."
Usage
npx cyberbouncer scan example.com
# CI gate: exit 1 if the grade is below B
npx cyberbouncer scan https://example.com --min-grade B
# Raw JSON report
npx cyberbouncer scan example.com --json
# LLM-ready remediation brief (paste into your AI assistant)
npx cyberbouncer scan example.com --promptOptions
| Flag | Purpose |
| --- | --- |
| --min-grade <A\|B\|C\|D> | Exit 1 if the grade is below this |
| --min-score <0-100> | Exit 1 if the score is below this |
| --json | Print the full JSON report |
| --prompt | Print an LLM-ready fix brief |
| --api-key <cbk_…> | API key (or env CYBERBOUNCER_API_KEY) |
Exit codes: 0 OK · 1 below the grade/score bar · 2 usage or scan error.
Rate limits
Free without a key (12 scans/min per IP). A free API key from your dashboard gets 100 scans/day (paid plans: 1,000–5,000/day).
Env
| Variable | Default | Purpose |
| --- | --- | --- |
| CYBERBOUNCER_API_KEY | — | Your cbk_… API key |
| CYBERBOUNCER_API_URL | https://cyberbouncer.io/api | API base override |
Scans are non-intrusive — no logins, no form submissions, no exploitation. Docs: cyberbouncer.io/docs/api
