# BRAINIAC Archive Payload Risk Detector

> BRAINIAC Archive Payload Risk Detector is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-12).

Statically analyzes archive files (zip, tar, etc.) for risky member types and nested payloads that may indicate malware smuggling, without executing or sending files to external scanners.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/file-security/archive-payload-risk-detect?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-archive-payload-risk-detector-327e3822
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V5brGvajjaO7exI547ord

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-archive-payload-risk-detector-327e3822 -d '<json body>'
```

Example prompt: Can you statically scan this zip file I just received for risky or malicious members — things like embedded executables or scripts — and tell me whether it's safe to open? Here's the base64 content and the filename is 'delivery-docs.zip'.

## When to prefer this

Use this endpoint when you need a fast, privacy-preserving static risk assessment of archive files without sending data to external AV scanners or requiring API keys. Ideal for pre-ingestion screening pipelines, agent-side file triage, or compliance workflows where data must not leave the caller's trust boundary. Prefer this over full AV scanning services when speed, simplicity, and no-account pay-per-call operation are priorities, and when confirmed malware verdicts are not required (only risk indicators).

## Known failure modes

- Archive exceeds decompression cap (512000 bytes inflated) — partial inspection with capped results
- Archive depth exceeds max depth of 2 — nested members beyond depth 2 not inspected
- File base64 exceeds 12MB maxLength — request rejected
- Missing required filename field — validation error
- Corrupt or unrecognized archive format — unknown magic, may return no findings
- Empty archive — itemCount 0, no findings
- Overly large files array (>40 items) — request rejected

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

A JSON object containing: overall status (detected/not detected), a list of risk items with titles, reasons (e.g. risky_member_types), evidence facts per archive member (extension, magic bytes, size, depth), inferred threat description, confidence level, finding codes, checkedAt timestamp, and a set of limitations disclaiming that no execution or external scanning occurred and absence of findings is not a malware-free verdict.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "properties": {
    "id": {
     "type": "string",
     "maxLength": 80
    },
    "md5": {
     "type": "string",
     "maxLength": 64
    },
    "role": {
     "type": "string",
     "maxLength": 80
    },
    "sha1": {
     "type": "string",
     "maxLength": 80
    },
    "sha256": {
     "type": "string",
     "maxLength": 128
    },
    "source": {
     "type": "string",
     "maxLength": 200
    },
    "filename": {
     "type": "string",
     "maxLength": 260,
     "minLength": 1
    },
    "mediaType": {
     "type": "string",
     "maxLength": 120
    },
    "sizeBytes": {
     "type": "number",
     "maximum": 100000000,
     "minimum": 0
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "md5": {
      "type": "string",
      "maxLength": 64
     },
     "role": {
      "type": "string",
      "maxLength": 80
     },
     "sha1": {
      "type": "string",
      "maxLength": 80
     },
     "sha256": {
      "type": "string",
      "maxLength": 128
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "filename": {
      "type": "string",
      "maxLength": 260,
      "minLength": 1
     },
     "mediaType": {
      "type": "string",
      "maxLength": 120
     },
     "sizeBytes": {
      "type": "number",
      "maximum": 100000000,
      "minimum": 0
     },
     "fileBase64": {
      "type": "string",
      "maxLength": 12000000,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 40
  },
  "reports": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "text"
    ],
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "text": {
      "type": "string",
      "maxLength": 200000
     },
     "title": {
      "type": "string",
      "maxLength": 200
     },
     "source": {
      "type": "string",
      "maxLength": 200
     }
    },
    "additionalP
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "archive-Z1",
    "title": "Archive payload risk indicators",
    "source": "Caller-supplied",
    "status": "signal",
    "reasons": [
     "risky_member_types"
    ],
    "detector": "archive-payload-risk-detect",
    "evidence": [
     {
      "fact": "Archive members inspected=2 (depth cap 2, inflate cap 512000). 2 member(s) have risky extensions/types (e.g. payload.js, nested/drop.exe).",
      "subject": "Z1",
      "inference": "Archive inspected locally with depth/size caps; not executed / not sent to scanners.",
      "confidence": "medium"
     },
     {
      "fact": "depth=0; magic=unknown; size=8",
      "subject": "payload.js",
      "confidence": "medium"
     },
     {
      "fact": "depth=0; magic=pe_executable; size=11",
      "subject": "nested/drop.exe",
      "confidence": "medium"
     }
    ],
    "confidence": "medium",
    "relatedIds": [
     "Z1"
    ],
    "observedFacts": [
     "Archive members inspected=2 (depth cap 2, inflate cap 512000).",
     "2 member(s) have risky extensions/types (e.g. payload.js, nested/drop.exe)."
    ],
    "inferredThreat": "Nested/risky archive members are commonly used to smuggle payloads.",
    "confirmedMalware": false
   }
  ],
  "status": "detected",
  "findings": [
   {
    "code": "archive_payload",
    "kind": "conflict",
    "detail": "Archive indicators: risky_member_types (confirmedMalware=false).",
    "subject": "Z1"
   }
  ],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "itemCount": 1,
  "limitations": [
   "Files and analysis reports are copied only from caller-supplied fields. Uploaded bytes are never executed and are never sent to external malware scanners.",
   "Analysis is static/local only with strict decoded-size, archive-depth, entry-count, and decompression limits.",
   "Observed facts are separated from inferred threat hypotheses. Absence of matched patterns is not a malware-free verdict.",
   "Nested archive inspection lists metadata and may inflate only small members within decompression caps.",
   "No paid threat-intel feed is used and no API key is required."
  ],
  "fileExecuted": false,
  "apiKeyRequired": false,
  "maxArchiveDepth": 2,
  "maxInflateBytes": 512000,
  "networkAccessed": false,
  "paidProviderUsed": false,
  "externalScannerUsed": false,
  "malwareFreeNotClaimed": true,
  "confirmedMalwareClaimed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-archive-payload-risk-detector-327e3822/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
