twux-sec/sanctioncheck
GitHub: twux-sec/sanctioncheck
一款轻量级命令行工具，用于实时查询四大国际制裁名单并支持模糊匹配，帮助用户快速完成合规筛查和尽职调查。
Stars: 1 | Forks: 0
# SanctionCheck
一款命令行筛查工具，可针对 **EU**、**UN**、**OFAC (US)** 和
**DGT (France)** 的公开综合制裁名单实时核查个人或实体名称。专为需要快速、可通过脚本执行且不依赖商业供应商的
AML / KYC / 尽职调查工作流程而构建。
## 功能
- 四大权威来源，原生解析（无需第三方 API 密钥）。
- 模糊匹配，能够容忍拼写错误、姓名颠倒、变音符号和音译
（由 `rapidfuzz` 驱动）。
- 本地缓存有效期为 24 小时 — 使用 `update` 刷新，使用 `--refresh` 强制刷新。
- 当上游源无法访问时，回退到捆绑文件。
- 漂亮的 `rich` 表格输出，以及用于管道传输到其他工具的 `--json` 选项。
## 安装
```
git clone https://github.com/twux-sec/sanctioncheck.git
cd sanctioncheck
pip install -e .
```
需要 Python 3.11+。
## 使用方法
```
# 默认：查询所有四个来源，阈值为 85%
sanctioncheck check "John Doe"
# 过滤来源
sanctioncheck check "Bank Melli Iran" --source ofac,un
# 降低阈值并显示别名匹配
sanctioncheck check "John Smith" -t 70 -v
# 强制重新下载所有列表
sanctioncheck update
# 检查本地缓存
sanctioncheck stats
# 通过管道将结果传递给 jq
sanctioncheck check "John Doe" --json | jq '.[0]'
```
### 名称语法
- **不区分大小写** — `John Doe`、`john doe` 和 `JOHN DOE` 都会匹配到同一条记录。
- **不区分变音符号** — `Élise Müller` 和 `Elise Muller` 是等效的。
- 对于由多个词组成的名称，**引号是可选的** — 两种形式都有效：
sanctioncheck check John Doe
sanctioncheck check "John Doe"
当名称包含 shell 元字符（`&`、`|`、`;`、`*`、`(`、`)`）时，请使用引号。
## 数据来源
| 列表 | 机构 | 格式 | URL |
| ---- | -------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------- |
| EU | European External Action Service | XML | https://webgate.ec.europa.eu/europeaid/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content?token=dG9rZW4tMjAxNw |
| UN | UN Security Council | XML | https://scsanctions.un.org/resources/xml/en/consolidated.xml |
| OFAC | US Treasury (Specially Designated Nationals) | XML | https://www.treasury.gov/ofac/downloads/sdn.xml |
| DGT | French Treasury (Gel des avoirs) | JSON | https://gels-avoirs.dgtresor.gouv.fr/ — 当公共 API 无法访问时，会附带回退文件 |
## 许可证
MIT — 参见 [许可证](LICENSE)。
## 主题
`osint` `sanctions` `aml` `compliance` `lcb-ft` `kyc` `ofac` `finint` `python` `screening`
标签：AML, API安全, DGT, JSON输出, KYC, OFAC, Python, 制裁名单筛查, 参数发现, 反洗钱, 合规科技, 实体筛查, 实时查询, 尽职调查, 开源, 文本匹配, 无后门, 模糊匹配, 欧盟制裁, 法国制裁, 离线缓存, 联合国制裁, 逆向工具, 金融合规, 风险控制