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."*