SC
scan-data-parser
>
Install
mkdir -p .claude/skills/scan-data-parser && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15373" && unzip -o skill.zip -d .claude/skills/scan-data-parser && rm skill.zipInstalls to .claude/skills/scan-data-parser
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Transform raw airodump-ng CSV output into the structured networks.json file, applying merge/upsert logic when previous discoveries exist. Use when: parsing scan results, converting CSV to JSON, updating discoveries after a scan.228 chars✓ has a “when” trigger
About this skill
scan-data-parser
Goal
Transform raw airodump-ng CSV output into the structured
networks.json file, applying merge/upsert logic when previous
discoveries exist.
Script
Execute parse-scan.sh via terminal:
bash scripts/parse-scan.sh --client <client_id> --csv <csv_path>
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string | yes | Client workspace identifier |
| csv_path | string | yes | Path to airodump-ng CSV evidence file |
Procedure
- Identify the latest CSV file in
clients/<id>/evidence/ - Run the script in terminal with the CSV path
- Read the output to confirm the number of networks parsed
- Read
clients/<id>/discoveries/networks.jsonto verify results - Report the discovery count to the operator
Outputs
| Artefact | Location | Format |
|---|---|---|
| Discoveries file | clients/<id>/discoveries/networks.json | JSON array |
| Audit log entries | clients/<id>/logs/audit.log | JSON Lines |
Merge/Upsert Logic
The script handles merge automatically:
- New BSSID → appended to
networks.json - Existing BSSID → updates
last_seen,signal_dbm,clients_oui(union),capture_source; preservesfirst_seen
Constraints
- Must not lose existing discovery data
first_seenis immutable once set- Validates CSV structure before parsing
- All timestamps normalised to ISO 8601 UTC