Metadata-Version: 2.4
Name: brs-kb
Version: 4.0.2
Summary: XSS Knowledge Base — 4900+ Payloads, 169 Contexts, WAF Bypasses, Zero Dependencies
Project-URL: Homepage, https://github.com/EPTLLC/BRS-KB
Project-URL: Documentation, https://github.com/EPTLLC/BRS-KB#readme
Project-URL: Repository, https://github.com/EPTLLC/BRS-KB.git
Project-URL: Issues, https://github.com/EPTLLC/BRS-KB/issues
Project-URL: Changelog, https://github.com/EPTLLC/BRS-KB/blob/main/CHANGELOG.md
Project-URL: Discussions, https://github.com/EPTLLC/BRS-KB/discussions
Project-URL: API, https://brs-kb.easypro.tech
Author-email: Brabus <dev@easypro.tech>
Maintainer-email: EasyProTech LLC <contact@easypro.tech>
License-Expression: MIT
License-File: LICENSE
Keywords: appsec,bug-bounty,cvss,cwe,knowledge-base,owasp,payload,penetration-testing,red-team,security,security-research,vulnerability,waf-bypass,web-security,xss
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Provides-Extra: all
Requires-Dist: black>=23.0; extra == 'all'
Requires-Dist: mypy>=1.0; extra == 'all'
Requires-Dist: pre-commit>=2.20; extra == 'all'
Requires-Dist: pytest-cov>=4.0; extra == 'all'
Requires-Dist: pytest-xdist>=3.0; extra == 'all'
Requires-Dist: pytest>=7.0; extra == 'all'
Requires-Dist: ruff>=0.1; extra == 'all'
Requires-Dist: starlette>=0.36; extra == 'all'
Requires-Dist: uvicorn>=0.27; extra == 'all'
Provides-Extra: dev
Requires-Dist: black>=23.0; extra == 'dev'
Requires-Dist: mypy>=1.0; extra == 'dev'
Requires-Dist: pre-commit>=2.20; extra == 'dev'
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest-xdist>=3.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1; extra == 'dev'
Provides-Extra: server
Requires-Dist: starlette>=0.36; extra == 'server'
Requires-Dist: uvicorn>=0.27; extra == 'server'
Description-Content-Type: text/markdown

# BRS-KB

Deterministic, context-aware XSS payload intelligence for scanners, CI/CD and security tooling.

Python 3.10+. MIT License.

## Install

```bash
pip install brs-kb
```

## API

```
Base URL: https://brs-kb.easypro.tech/api/v1
API Key:  BRS-KB_free_kUOgkmm2lxr2sgIg_hFsmuBsFGB4fVpakvu0pzANStRIpeGs8
# Public read-only key for testing and CI/CD
```

```bash
curl -H "X-API-Key: BRS-KB_free_kUOgkmm2lxr2sgIg_hFsmuBsFGB4fVpakvu0pzANStRIpeGs8" \
  https://brs-kb.easypro.tech/api/v1/payloads?context=javascript&limit=10
```

Endpoints: `/health`, `/info`, `/contexts`, `/contexts/{id}`, `/payloads`, `/payloads/search`, `/analyze`, `/defenses`, `/stats`

Docs: https://brs-kb.easypro.tech/docs.html

## Python

```python
from brs_kb import get_vulnerability_details, list_contexts, search_payloads, get_waf_bypass_payloads

# 169 contexts
contexts = list_contexts()

# Context details with CVSS
details = get_vulnerability_details('javascript')
# {'severity': 'critical', 'cvss_score': 9.0, 'cwe': ['CWE-79'], ...}

# Search
results = search_payloads('websocket')

# WAF bypasses
waf = get_waf_bypass_payloads()  # 1999
```

## CLI

```bash
brs-kb info
brs-kb list-contexts
brs-kb get-context javascript
brs-kb analyze-payload "<script>alert(1)</script>"
brs-kb search-payloads "cloudflare"
brs-kb export payloads --format json
brs-kb serve --port 8080
```

## CI/CD

```yaml
# GitHub Actions
- name: Install BRS-KB
  run: pip install brs-kb

- name: Validate
  run: brs-kb info && python -c "from brs_kb import list_contexts; assert len(list_contexts()) > 100"
```

```bash
# Docker
docker pull ghcr.io/eptllc/brs-kb:latest
docker run -p 8080:8080 ghcr.io/eptllc/brs-kb:latest
```

## Dataset

- 4,931 payloads
- 169 contexts
- 1,999 WAF bypasses
- CVSS scores
- Browser compatibility
- Encoding metadata

## Integration

Native knowledge backend for [BRS-XSS](https://github.com/EPTLLC/brs-xss).

```bash
pip install brs-kb brs-xss
```

SIEM connectors: `siem_connectors/` (Splunk, Elasticsearch, Graylog)

## Test

```bash
pytest tests/ -v
```

## License

MIT

## Links

- https://brs-kb.easypro.tech
- https://github.com/EPTLLC/BRS-KB
- https://github.com/EPTLLC/brs-xss
