STIX 2.1、Maltego XML、PDF报告：MailAccess 7种导出格式怎么选、怎么用

MailAccess 是一款免费的邮件 OSINT 工具，通过 80+ 模块覆盖 5300+ 平台，对单个邮箱进行身份聚类与泄露检测。调查完成后，它支持7 种导出格式：JSON、CSV、HTML、PDF、Markdown、STIX 2.1 和 Maltego XML。本文帮你搞清楚每种格式适合什么场景、以及如何一键导出。

一张表看懂 7 种导出格式

所有导出都以mailaccess_{邮箱}_{调查ID}.{扩展名}命名，统一在 backend/exporters/ 目录下实现，各格式共用同一个 BaseExporter 抽象接口，新增格式只需实现export()方法即可。

导出的三种触发方式

方式一：Web UI 的 Export 按钮

调查完成后，在报告页点击Export，选择格式即可下载，前端组件见 ExportBar.tsx。这是最省事的用法，适合绝大多数用户。

方式二：API 调用

GET /api/report/{investigation_id}/export?format=<format>

其中format可取json、csv、markdown、pdf、html、stix、maltego七个值，路由实现位于 investigations.py。适合自动化流水线里拉取报告。

方式三：CLI 的-o参数

调查结束时，CLI 会直接提示保存命令：

mailaccess investigate you@example.com -o report.pdf

-o支持.json .csv .md .pdf .html .stix .mtgx七种扩展名（.stix对应 STIX 2.1，.mtgx对应 Maltego XML），参数定义见 cli/main.py。一个小细节：CLI 会自动检测是否安装了 weasyprint——没装就提示保存 HTML 而不是 PDF，避免导出一半报错。

7 种格式逐个拆解

JSON：机器可读的"全量数据"

导出包含exposure_score、risk_level、findings、module_runs等全部字段的单一 JSON 对象，实现见 json_exporter.py。

适合：写脚本二次处理、存档回溯、或作为其他工具的数据源。

CSV：发现项拍平成表格

每条 finding 一行，方便直接丢进 Excel/Google Sheets，实现见 csv_exporter.py。注意 CSV 不含模块元数据。

适合：批量筛查结果做表格比对、导入案件管理或工单系统。

HTML：零依赖的"PDF 平替"

自包含的 HTML 报告，章节与 PDF 一致（暴露度评分、Defender's Brief、时间线、发现项、模块日志），浏览器打开即用，页内带导航且发现项 URL 可点击，实现见 html_exporter.py。

mailaccess investigate you@example.com -o report.html

适合：没装 PDF 依赖的环境、本地查看、或作为附件挂到工单里。

PDF：给"人"看的正式报告

由 weasyprint 渲染的可视化报告，包含暴露度评分、风险等级、执行摘要和按模块分节的发现项，实现见 pdf_exporter.py。

⚠️注意：PDF 导出需要额外依赖，安装方式为：

pip install mailaccess[pdf]

没装时 API 会返回PDF export requires weasyprint错误（HTTP 422），此时可改用 HTML 格式。此外 PDF 生成为异步过程，大型调查会比其他格式稍慢一些。

适合：交付客户、打印归档、正式报告场景。

Markdown：无缝进 Wiki 和 Issue

按模块分节 + 发现项表格的结构化 Markdown，实现见 markdown_exporter.py。

适合：粘贴到 Wiki、GitHub/GitLab Issue、Confluence 或 Obsidian 笔记。

STIX 2.1：威胁情报平台的"通行证"

导出标准 STIX 2.1 bundle（基于stix2库），由发现项生成EmailAddr、Identity、Indicator与Relationship对象，并建立related-to/attributed-to关系边，核心逻辑见 stix_exporter.py。

适合：导入 OpenCTI、MISP、Anomali 等 TI 平台，或与 SOC 团队共享指标。这是 7 种格式里唯一"说情报界语言"的选项。

Maltego XML：直接进图谱

Maltego 兼容的实体导出，可直接导入 Maltego Desktop 做图形化 OSINT 分析，实现见 maltego_exporter.py。

💡进阶玩法：如果只是偶尔导入，用该导出格式即可；若要在 Maltego 里"边查边拖"，MailAccess 还内置了 Maltego 本地 transform 服务（POST /maltego/email_investigate），启动后自动生成maltego/MailAccess.mtz配置包，可在 Maltego 里直接触发完整调查，详见 integrations.md。

按场景选格式：30 秒决策指南

新手建议：日常先用默认的 JSON 存档，需要汇报就导 HTML（零依赖最省心），正式交付再上 PDF；做威胁情报或图谱分析时，才需要 STIX 2.1 和 Maltego XML 这两个"专业户"。

参考资料

• 导出格式完整文档：docs/exports.md
• 导出器源码目录：backend/exporters/
• API 说明：docs/api.md
• 新增导出格式指南：CONTRIBUTING.md