<!-- Copyright (c) 2026 defconxt. All rights reserved. -->
<!-- Licensed under AGPL-3.0 — see LICENSE file for details. -->

# API Reference — Detecting Voice Phishing Attacks

## Agent Script

### Commands

| Command | Description |
|---|---|
| `node agent.js analyze-cdr --cdr-file <csv>` | Analyze call detail records |
| `node agent.js detect-spoofing --cdr-file <csv>` | Detect caller ID spoofing |
| `node agent.js check-numbers --cdr-file <csv> --blocklist <file>` | Check against blocklist |
| `node agent.js analyze-audio --audio-file <wav>` | Analyze for deepfake |
| `node agent.js deepfake-checklist` | Detection checklist |
| `node agent.js process-report --reporter <email> --caller-number <num> --pretext <text>` | Process report |
| `node agent.js generate-advisory --attack-type <type>` | Awareness advisory |
| `node agent.js audit-telephony --provider <provider>` | Audit controls |
| `node agent.js stirshaken-report` | STIR/SHAKEN recommendations |

### Examples

```bash
node agent.js analyze-cdr --cdr-file /tmp/call_records.csv
node agent.js detect-spoofing --cdr-file /tmp/call_records.csv
node agent.js process-report --reporter user@company.com --caller-number "+18005551234" --pretext "IT support"
```
