akii 0.1.0

HTTP header analyzer

AkII

A fast and lightweight HTTP security header analyzer.

AkII is an open-source security tool for analyzing HTTP response headers and identifying common security misconfigurations, such as weak or missing security headers.

⚠️ Early Development

AkII is in an early stage of development. Some features are still incomplete, and bugs are expected. The project is under active development, and new functionality will be added in future releases.

Features

• Analyze HTTP security headers
• Detect common CORS misconfigurations
• Detect missing or insecure Content Security Policy (CSP)
• Human-readable terminal output
• JSON output for automation
• Lightweight and extensible YAML-based rule engine

Why AkII?

AkII is designed for speed, automation, and extensibility.

AkII focuses on one task: analyzing HTTP security headers quickly and consistently.

It is suitable for:

• CI/CD pipelines
• Security automation
• Bug bounty workflows
• Batch scanning with wordlists
• Integration into custom tools

Installation

From PyPI (Recommended)

pipx install akii

or

pip install akii

From Source

git clone https://github.com/MintTester-IO/AkII.git
cd akii
pip install -e .

Uninstallation

If you installed AkII with pipx:

pipx uninstall akii

If you installed AkII with pip:

pip uninstall akii

If you installed AkII from source using pip install -e .:

pip uninstall akii
cd ..
rm -rf akii

Usage

Scan a single target:

akii -T https://example.com

Scan multiple targets:

akii -w targets.txt

Show request headers:

akii -T https://example.com --request

Show response headers:

akii -T https://example.com --response

Verbose mode:

akii -T https://example.com --verbose

Save the report:

akii -T https://example.com -o report.txt

Export JSON:

akii -T https://example.com -jo report.txt

Current Checks

• Cross-Origin Resource Sharing (CORS)
• Content Security Policy (CSP)

More security header checks will be added in future releases.

Project Structure

src/akii/
├── checks/      # Detection and analysis modules
├── core/        # Controller, CLI, reporting
├── http/        # HTTP client
├── templates/   # YAML rule definitions
└── ui/          # Terminal output

Roadmap

• HSTS analysis
• Cookie analysis
• Cache-Control analysis
• Permissions-Policy analysis
• Referrer-Policy analysis
• HTML reports
• Improved JSON reporting
• Plugin system

Contributing

Contributions are welcome.

If you find a bug, have a feature request, or would like to improve AkII, please open an issue or submit a pull request.

License

This project is licensed under the MIT License.