# Netzhandwerker File Inspector

> Netzhandwerker File Inspector is a paid API for AI agents from tools.netzhandwerker.de, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Inspects a file (as base64 or text) to detect MIME type, extension, embedded objects, and suspicious findings like JavaScript in PDFs — structure and signature analysis only, no antivirus.

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/file/inspect
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-file-inspector-e6e36d37
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dXE70kw5MBpVsWPR0b0w7

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 netzhandwerker-file-inspector-e6e36d37 -d '<json body>'
```

Example prompt: Can you inspect this base64-encoded PDF file — filename 'report.pdf' — and tell me if it contains any embedded JavaScript or suspicious objects?

## When to prefer this

Use this endpoint when you need lightweight, fast file-type and structure inspection — especially to detect MIME/extension mismatches or embedded risky objects like JavaScript in PDFs — without needing a full antivirus scan. Ideal for pre-processing untrusted user uploads in an agent pipeline before further handling. Best for files up to ~9 MB supplied as base64.

## Known failure modes

- Base64 payload exceeds ~9 MB limit — request rejected
- Malformed base64 string causes parsing failure
- No input provided (neither text nor base64) — validation error
- Unsupported or unrecognizable file format — limited detection results
- Payment of 0.002 USDC not completed — 402 Payment Required response

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns a JSON object with: a note clarifying it is structure/signature analysis only (no antivirus), total byte size, a verdict string (e.g. 'nur_in_sandkasten'), detected MIME type and extension, a list of embedded object kinds with counts, a list of security findings each with an ID, human-readable evidence, and severity level, the magic bytes hex, the claimed extension, and whether the extension matches the detected type.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "description": "Alternativ: Textinhalt"
  },
  "base64": {
   "type": "string",
   "description": "Dateiinhalt als Base64, bis etwa 9 MB"
  },
  "filename": {
   "type": "string",
   "description": "Behaupteter Dateiname fuer den Abgleich der Endung"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Reine Struktur- und Signaturpruefung. Kein Virenscanner.",
  "bytes": 184213,
  "verdict": "nur_in_sandkasten",
  "detected": {
   "mime": "application/pdf",
   "extension": "pdf"
  },
  "embedded": [
   {
    "kind": "pdf_objects",
    "count": 412
   },
   {
    "kind": "pdf_pages",
    "count": 3
   }
  ],
  "findings": [
   {
    "id": "pdf_javascript",
    "evidence": "PDF enthaelt JavaScript-Eintrag.",
    "severity": "hoch"
   }
  ],
  "magic_hex": "255044462d312e340a25c7ec8fa2",
  "claimed_extension": "pdf",
  "extension_matches": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-file-inspector-e6e36d37/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.netzhandwerker.de](https://www.zero.xyz/host/tools.netzhandwerker.de/llms.txt)