Metadata-Version: 2.4
Name: rulestamp-security-headers-csp-lint
Version: 0.1.8
Summary: Reads security headers and CSP line by line in your config file and names the lines that silently do nothing: retired headers, keywords missing their quotes, directives the browser throws away. (bundled Node.js runtime)
Author-email: Rulestamp <support@getreadystack.com>
License: Proprietary - see LICENSE.txt
Project-URL: Homepage, https://getreadystack.com/tools/security-headers-csp-lint?ref=pypi
Project-URL: Documentation, https://getreadystack.com/tools/security-headers-csp-lint?ref=pypi
Project-URL: Support, https://getreadystack.com/support
Keywords: CSP,Content-Security-Policy,security headers,HSTS,Permissions-Policy
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: nodejs-wheel-binaries>=20
Dynamic: license-file

# Security Headers Lint - CSP and Dead Headers

> Runs the same checker as our npm package on a Node.js runtime that pip installs for you (`nodejs-wheel-binaries`) - no system Node.js needed. Your files are checked locally.

![Security Headers Lint - CSP, HSTS and dead headers — finds the line](https://getreadystack.com/img/promo/security-headers-csp-lint_demo.gif)

Reads security headers and CSP line by line in your config file and names the lines that silently do nothing: retired headers, keywords missing their quotes, directives the browser throws away.

## Install

```
security-headers-csp-lint file
```

Node 18+. The same 28 rules as the VS Code extension, from a terminal or CI.

## Free

- Check the open config against all 28 rules - every finding shown, nothing withheld; Check only the lines you highlight; See every rule and what each retired header or dropped directive actually does; Reopen the last report
- `--rules` lists every rule

## With a licence ($29 once)

- Scan every config file in the workspace; Export the report as CSV, JSON or HTML; CI output that fails the build on errors; Add your own house policy rules; Re-check automatically on every save; Apply the safe fixes for you

```
security-headers-csp-lint --dir ./templates --report html --out report.html
```

Application security consultants doing secure code review bill roughly $120 to $275 an hour, and a security-header and CSP review is a one-to-two hour job per site.

## Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

```json
{ "mcpServers": { "security-headers-csp-lint": { "command": "security-headers-csp-lint", "args": ["--mcp"] } } }
```

Tools: `check_text` and `check_file` (free) · `check_dir` (licence). The agent gets every finding with the line number.

## Use in CI

```yaml
- name: Security Headers Lint - CSP and Dead Headers
  run: pip install rulestamp-security-headers-csp-lint && security-headers-csp-lint --dir . --ci
```


The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.

[Get a licence](https://getreadystack.com/api/buy/cl/polar_cl_DxnwX3BvMThBo4369WHczw3OVdSlhjnkHsoJb0ZEGWd)


<!-- security headers lint -->


## Install (PyPI)

```
pip install rulestamp-security-headers-csp-lint
security-headers-csp-lint --help
```
