{"uid":"cap_loEBkxc-h9KSMK5V9bjGf","slug":"brainiac-macro-document-risk-detector-d40ba181","name":"BRAINIAC Macro Document Risk Detector","description":"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.","url":"https://www.brainiac.software/api/v1/file-security/macro-document-risk-detect?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}},"additionalProperties":false},"maxItems":40},"artifacts":{"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},"maxArchiveDepth":{"type":"number","maximum":5,"minimum":1},"maxInflateBytes":{"type":"number","maximum":2000000,"minimum":1000}}},"responseSchema":{"type":"json","example":{"items":[{"id":"macro-D1","title":"Suspicious macro document indicators","source":"Caller-supplied","status":"signal","reasons":["macro_storage_indicator","auto_exec_macro"],"detector":"macro-document-risk-detect","evidence":[{"fact":"magic=ole_cfb; extension=doc","subject":"D1","inference":"Macro risk from static markers only; document was not opened/executed.","confidence":"medium"}],"confidence":"high","relatedIds":["D1"],"observedFacts":["OLE/text window contains VBA/macro storage indicators.","Auto-execution macro entrypoint wording present."],"inferredThreat":"Macro-enabled documents with auto-exec markers are commonly used for initial access.","confirmedMalware":false}],"status":"detected","findings":[{"code":"macro_risk","kind":"conflict","detail":"Macro indicators: macro_storage_indicator, auto_exec_macro (confirmedMalware=false).","subject":"D1"}],"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,"networkAccessed":false,"paidProviderUsed":false,"externalScannerUsed":false,"malwareFreeNotClaimed":true,"confirmedMalwareClaimed":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p-Au-cA3i3f9347ozsG4J","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Statically analyzes documents for macro-based malware indicators such as VBA storage markers and auto-execution entry points without executing or externally scanning the file.","exampleAgentPrompt":"Can you check this Word document for macro-based malware risks? It's a .doc file I received as an email attachment — I want to know if it has any VBA macro storage indicators or auto-execution entry points before I open it.","exampleUseCases":[{"title":"Email attachment triage for malware","prompt":"I got a suspicious .doc file as an email attachment from an unknown sender. Can you check it for macro malware indicators — specifically any VBA auto-exec patterns or OLE/CFB storage markers — before I let anyone open it?"},{"title":"Automated document upload screening","prompt":"Before we store this uploaded Excel file in our system, run a static macro risk check on it and tell me if it has any auto-execution macro entry points or macro storage indicators, and how confident you are."},{"title":"Security review of legacy Office files","prompt":"We have a batch of old .doc files from an acquired company and I need to flag any that contain suspicious macro patterns like auto-exec VBA. Can you analyze this one and tell me the observed facts and inferred threats?"}],"resultDescription":"Returns a structured JSON object with a status field ('detected' or otherwise), an items array listing each file's macro risk findings (including confidence, observed facts, inferred threat, and whether confirmed malware is claimed), a findings array with coded conflict details, audit timestamp, item count, and an extensive limitations block clarifying that analysis is static-only, no files are executed, no external scanners are used, and absence of signals is not a malware-free verdict.","failureModes":["File too large (exceeds 100MB sizeBytes limit or 12MB base64 limit) — request rejected","No file or text content supplied — empty or malformed request","Unsupported file format with no parseable OLE/CFB structure — limited or no findings returned","Nested archive depth or decompression limits exceeded — partial analysis with noted limitations","Invalid base64 encoding — parse error returned","Payment not completed via x402/USDC — 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need fast, privacy-preserving static macro risk detection without sending files to external threat-intel services or requiring an API key. It is ideal for agents operating in regulated or air-gapped environments where files cannot leave the caller's control, or when you need a lightweight triage signal (macro storage, auto-exec markers) on Office documents before deeper investigation. It does not claim malware-free verdicts and explicitly separates observed facts from inferred threats, making it suitable for compliance-conscious workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:41.158Z","isFirstParty":false,"canonicalSlug":"brainiac-macro-document-risk-detector-d40ba181"}