Share
## https://sploitus.com/exploit?id=E3D63A42-E659-572B-8320-94DE6D19376D
# PoXiao v3.0.0
**Twenty-Four Solar Safety Toolchain** β SRC Hole-Punching Automation
> PoXiao is the first light at dawn; FrostMoon is the cold collection; VernalEquinox is comprehensive reconnaissance; JingZhe is the verification of all things; GuanXing is continuous monitoring; XiaZhi is concealed scanning. ---
## Core Principles
**First, identify the technology stack, then match CVEs, and eliminate false positives with three-layer noise reduction.**
Avoid blind payload bombing, donβt pursue excessive template countsβfocus on high-confidence results only. ---
## Toolchain Ecosystem
```
βββββββββββββββ
β PoXiao Dawn β
β Core Scanner β
β Fingerprint + CVE + β
β Noise Reduction + Report β
ββββββββ¬βββββββ
β Orchestration
ββββββββββ¬ββββββββΌββββββββ¬βββββββββ
βΌ βΌ βΌ βΌ βΌ
ββββββββ ββββββββ ββββββββ ββββββββ
β FrostMoon β β VernalEquinox β β JingZhe β β GuanXing β β XiaZhi β
β Subdomain β β Reconnaissance β β Verification β β Monitoring β β Stealth β
ββββββββ ββββββββ ββββββββ ββββββββ
```
| Tool | Command | Location |
|------|------|------|
| **PoXiao Dawn** | `poxiao scan` | Core Scanner: Technology Stack Fingerprint + CVE Exact Match + Three-Layer Noise Reduction + SRC Report |
| **FrostMoon** | `frostmoon` | Subdomain Collection: crt.sh + certspotter + OTX + DNS Bombs + Domain Analysis |
| **VernalEquinox** | `vernalequinox` | Passive Reconnaissance: WHOIS + ICP + DNS + Certificates + IP Intelligence + Wayback + GitHub Leaks |
| **JingZhe** | `jingzhe` | Vulnerability Verification: Default Credentials + Git Leaks + Swagger + Actuator + Configuration File Detection |
| **GuanXing** | `guanxing` | Asset Monitoring: Web Dashboard + Change Tracking + Authentication + Pagination |
| **XiaZhi** | `xiazhi` | Stealth Scanning: POC Template Engine + Proxy Pool + UA Rotation + WAF Bypass |
---
## Quick Start
```bash
# Installation
cd PoXiao
pip install -e . # Core Scanner
poxiao scan targets.txt # Scan Target List
poxiao scan example.com --report butian # Generate PoXiao Report
# Standalone Tools
frostmoon example.com --brute # Subdomain Collection
vernalequinox example.com # Passive Reconnaissance
jingzhe https://example.com # Vulnerability Verification
guanxing serve # Start Monitoring Dashboard
xiazhi scan example.com -t templates/ # POC Scanning
xiazhi scan example.com -t templates/ --stealth # Stealth Scanning
# Configuration Management
poxiao config init # Create Configuration File
poxiao config show # View Current Configuration
# MCP Server (AI Assistant Integration)
poxiao mcp # Start stdio MCP Server for Claude/CodeBuddy Calls
```
---
## MCP Server (AI Assistant)
PoXiao supports **MCP (Model Context Protocol)**, exposing core capabilities through **stdio** and **SSE(HTTP)** protocols. This allows AI assistants to directly call scanning functions and consume structured JSON results (pure stdlib, no additional dependencies). ```bash
poxiao mcp # stdio Transmission (Local AI Assistant Integration, Default)
poxiao mcp --transport sse # SSE/HTTP Transmission, Listening on 127.0.0.1:8765
poxiao mcp --transport sse --host 0.0.0.0 --port 9000
```
**stdio Client Configuration (Claude Desktop / CodeBuddy, etc.):**
```json
{
"mcpServers": {
"poxiao": { "command": "poxiao", "args": ["mcp"] }
}
}
```
**SSE Client Configuration (Cursor / SSE-Supported Clients):**
```json
{
"mcpServers": {
"poxiao": { "url": "http://127.0.0.1:8765/sse" }
}
}
```
> SSE defaults to listening only on the loopback address `127.0.0.1` (Privately Positioned to Avoid Miscommunication); To Allow Local Area Network Access, specify `--host` explicitly. Seven tools exposed:
| Tool | Description |
|------|------|
| `scan_targets` | Core Scanning: Live Check + Technology Stack + CVE + Sensitive Paths (Three-Layer Noise Reduction) |
| `check_alive` | Rapid Live Check |
| `subdomain_enum` | FrostMoon Subdomain Collection (Certificate Transparency + DNS Bombs + Domain Analysis) |
| `passive_recon` | VernalEquinox Passive Intelligence (Whois/Registration/DNS/Certificates/IP/History/GitHub) |
| `verify_target` | Jingzhe vulnerability auto-verification (default passwords/Swagger/Git/Actuatorβ¦) |
| `poc_scan` | Xiazi POC template scanning |
| `util_codec` | Encoding/decoding/encryption/decryption (base64/hex/jwt/autoβ¦) |
---
## Three-layer noise reduction (core differentiation)
```
Layer 1: Content features β Configuration files return HTML β false positives
Layer 2: Size clustering β 3+ paths with the same size (Β±8% tolerance) β CDN catch-all
Layer 3: Calibration matching β Randomly detect path matching β unified error pages
Effect: False positive rate reduced from 94% to ~5%
```
---
## Project structure
```
Boshi/
βββ src/
β βββ dawn/ # Core scanner (7 modules)
β β βββ engine.py # HTTP scanning + technology stack identification
β β βββ tech_stack.py # Vulnerability database (Server/Language/CMS/CDN/WAF)
β β βββ cve_match.py # CVE matching (257 built-in + NVD online)
β β βββ sensitive.py # Sensitive paths + three-layer noise reduction
β β βββ reporter.py # SRC report generation
β βββ frostmoon/ # Frost Moon β Subdomain collection
β βββ vernalequinox/ # Spring Equinox β Passive reconnaissance (10 modules)
β βββ jingzhe/ # Jingzhe β Vulnerability verification
β βββ guanxing/ # Guanxing β Asset monitoring
β βββ xiazhi/ # Xiazi β Hidden scanning + POC engine (10 modules)
β βββ config.py # Unified configuration system
β βββ target/ # Target management
β βββ utils/ # Shared tools
β
βββ templates/ # POC template library (215 templates)
βββ configs/ # Configuration files
β βββ brands.json # Bota brand database (107 brands)
β
βββ poxiao.py # Boshi entrance
βββ frostmoon.py # Frost Moon entrance
βββ vernalequinox.py # Spring Equinox entrance
βββ jingzhe.py # Jingzhe entrance
βββ guanxing.py # Guanxing entrance
βββ xiazhi.py # Xiazi entrance
βββ pyproject.toml
```
---
## Configuration system
```bash
# Create configuration file
poxiao config init
# Location of configuration file
# Windows: %USERPROFILE%\.poxiao\config.yaml
# Linux/Mac: ~/.poxiao/config.yaml
```
```yaml
# ~/.poxiao/config.yaml
scan:
concurrency: 5
timeout: 5.0
poc:
concurrency: 10
timeout: 10.0
stealth:
proxy_file: "~/.poxiao/proxies.txt"
global_qps: 10.0
cve:
nvd_api_key: "" # NVD API Key (optional)
recon:
shodan_api_key: "" # Shodan (optional)
monitor:
host: "127.0.0.1" # Only listens locally by default
port: 5099
```
---
## Environment variables
| Variable | Purpose |
|------|------|
| `POXIAO_SCAN_CONCURRENCY` | Scan concurrency |
| `POXIAO_SCAN_TIMEOUT` | Scan timeout |
| `POXIAO_NVD_API_KEY` | NVD API Key |
| `SHODAN_API_KEY` | Shodan API Key |
| `FOFA_KEY` / `FOFA_EMAIL` | FOFA API |
| `CENSYS_API_ID` / `CENSYS_API_SECRET` | Censys API |
| `GITHUB_TOKEN` | GitHub code leakage scanning |
| `POXIAO_MONITOR_USER` / `POXIAO_MONITOR_PASS` | Dashboard authentication |
---
## Actual measurement data
```
110+ vendorsβ scans
7.6 seconds / 30 targets
58.com β 89 subdomains (54 active)
CVE database: 257 built-in + NVD online queries
POC templates: 215
Bota brands: 107
```
---
## Technology stack
| Component | Technology |
|------|------|
| HTTP | httpx (asynchronous) |
| DNS | dnspython |
| Certificate transparency | crt.sh / certspotter / AlienVault OTX |
| IP intelligence | Shodan / Censys / FOFA |
| Historical URLs | Wayback Machine |
| Code leakage | GitHub Search API |
| Database | SQLite |
| Web | Flask + Bootstrap 5 |
| Configuration | YAML + environment variables |
| Language | Python 3.10+ |
---
## Design principles
- **Asynchronous first** β All network I/O uses asyncio
- **No external dependencies** β No Docker, Redis, SQLite single files required
- **Progressive output** β Output results as scanning progresses, without waiting for everything to be done
- **Tools are independent** β Each tool can be used independently or coordinated together
- **High confidence** β Three-layer noise reduction, false positive rate < 5%
---
*"Boshi is the first light in the early morning,"*
*"Frost Moon is the coldness of November,"*
*"Spring Equinox is the beginning of everything,"*
*"Jingzhe is the revival of everything,"*
*"Guanxing is looking up at the sky,"*
*"Xiazhi is the longest day of the year."*