DataInftra-CrossBoardTrustedDataPace-SanctionScreening

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

DataInftra-CrossBoardTrustedDataPace-SanctionScreening

★ 17 Open GitHub ↗

跨境可信数据空间基础设施建设，进出口制裁Skills

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DataInfra · 跨境可信数据空间 — 全球制裁筛查引擎

面向**律师、合规官、贸易合规与 KYC/AML 团队**的开源筛查工具链：在**客户尽调、交易对手审查、出口前筛查、争议与调查支持**等场景中，协助快速拉通「第三方名单聚合 → 政府官网核验 → 公开情报摘要 → 结构化交付物」的工作流。

> **重要声明（请律师同仁首先阅读）**  
> 本仓库提供的是**技术辅助工具与流程模板**，输出内容为基于公开数据源与自动化抓取的**事实整理与风险线索汇总**，**不构成法律意见、监管解读或终局合规结论**。是否阻断交易、如何起草法律文件、是否满足特定义务，须由**具有执业资格的专业人士**结合具体事实管辖与业务场景独立判断。  
> 制裁与出口管制规则更新频繁，任何筛查报告的**时效性有限**；请以各司法辖区**官方最新公布文本与执法实践**为准。

**仓库地址：** [github.com/TracyWang95/DataInftra-CrossBoardTrustedDataPace-SanctionScreening](https://github.com/TracyWang95/DataInftra-CrossBoardTrustedDataPace-SanctionScreening)

---

## 律师场景：本工具能做什么

| 场景 | 说明 |
|------|------|
| **客户/交易对手准入** | 对法人或自然人名称进行多源检索与官网核验，形成可归档的检索记录与截图证据链。 |
| **进出口与供应链** | 与美国 BIS、OFAC、DoD 1260H、欧盟/联合国等多类清单相关的**初筛与线索定位**（深度法律分析仍须专业意见）。 |
| **诉讼与调查支持** | 固定时间点、固定检索式下的网页与名单状态，作为**过程性材料**（是否满足证据规则由承办律师评估）。 |
| **律所知识管理** | 将 `SKILL.md` 与 `references/` 中的清单说明、红旗清单、法律影响模板嵌入内部知识库或 Agent 工作流。 |

本项目的 **`SKILL.md`** 是为 AI 助手（如 Claude/Cursor）编写的**操作规范**：何时必须向客户确认搜索变体、何时严格按用户给定字符串检索、如何串联脚本与交付物路径。人类律师可直接阅读该文件理解全流程逻辑。

---

## 方法论：三层筛查 + 误中审查

1. **第一层 — 聚合初筛（OpenSanctions）**  
   对接 [OpenSanctions](https://www.opensanctions.org/) 等聚合数据，覆盖全球 **100+** 制裁与涉敏名单数据集，用于**快速定位候选命中**。聚合数据可能存在延迟或匹配误差，**不能单独作为终局依据**。

2. **第二层 — 官方网站核验（Playwright）**  
   通过浏览器自动化访问多国/多机构**官方公开查询入口**（如 OFAC、BIS CSL、UN、EU、UK、澳大利亚 DFAT、加拿大 SEMA 等路径，以脚本内配置为准），进行搜索并**截图留痕**，便于工作底稿归档。

3. **第三层 — 受控情报摘要（Tavily）**  
   对限定域/受信新闻与公开网页进行检索，用于**补充上下文**（如公开报道、监管动态），不替代官方法律文本。

4. **误中审查（False Positive）**  
   对「泛化清单」与易混淆命中（如国家代码碰撞、部分字符串匹配）进行**自动标注与降级提示**，减少将无关实体误判为制裁对象的风险。具体规则见 `references/false_positive_check.md` 与 `scripts/browser_verify.py` 内配置。

最终可输出 **HTML 报告**（便于浏览与内部传阅）及 **PDF**（便于对外提交或归档），详见 `SKILL.md` 阶段 4。

---

## 快速开始

### 环境要求

- Python 3.10+（推荐 3.11）
- Windows / macOS / Linux 均可；浏览器自动化依赖 Chromium（由 Playwright 安装）

### 安装

```bash
cd sanctions-screening   # 或克隆后的项目根目录
pip install -r requirements.txt
python -m playwright install chromium
```

### 配置密钥（切勿提交 `.env`）

```bash
copy .env.example .env   # Windows；Unix 使用 cp
```

编辑 `.env`，填入：

- `OPENSANCTIONS_API_KEY` — [OpenSanctions API](https://www.opensanctions.org/api/)
- `TAVILY_API_KEYS` 或 `TAVILY_API_KEY` — [Tavily](https://tavily.com/)

本仓库 **`.gitignore` 已排除 `.env`**；若您曾将密钥写入其他文件并误提交，请立即**轮换密钥**并自 Git 历史中清除敏感提交（可使用 `git filter-repo` 等工具，或新建空仓库仅保留净提交）。

### 命令行示例（从项目根目录执行）

初筛与情报汇总（阶段 1 思路，具体参数见 `SKILL.md`）：

```bash
python scripts/screen_entity.py "Example Corp" --type LegalEntity -o Example_api_report.md
```

官网核验与 HTML/PDF 报告（阶段 2+，需已安装 Playwright）：

```bash
python scripts/browser_verify.py "Example" --type Entity --extra-variants "example corp" -o screenshots/ --report Example_sanctions_report.html --api-report Example_api_report.md
```

批量场景见 `scripts/batch_screen.py`。

---

## 目录结构（核心文件）

| 路径 | 用途 |
|------|------|
| `SKILL.md` | AI/自动化执行规范与完整阶段说明（**必读**） |
| `references/legal_implications.md` | 各清单法律影响叙述模板（撰写报告时引用） |
| `references/false_positive_check.md` | 误中判断指引 |
| `references/us_lists_coverage.md` | 美国主要清单覆盖说明 |
| `references/red_flags_checklist.md` | BIS「了解你的客户」类红旗检查参考 |
| `scripts/screen_entity.py` | 初筛 + 情报 + 校验计划整合 |
| `scripts/browser_verify.py` | 官网自动化检索与截图、报告生成 |
| `scripts/opensanctions_search.py` / `tavily_search.py` | API 封装 |
| `requirements.txt` | Python 依赖一览 |

**仓库范围：** 仅同步 `SKILL.md`、`references/`、`scripts/` 及上述配置文件。运行产生的 `screenshots/`、`*_sanctions_report.*`、`*_api_report.md` 以及微信推广类文稿等已列入 `.gitignore`，留在本地即可，不会进入 Git。

---

## 风险评级与报告解读

工具使用多维度评分输出风险等级（如 CRITICAL / HIGH / MEDIUM 等），区间与建议动作见 `SKILL.md`「报告解读」一节。律师使用时建议：

- 将**评级**视为**排程与复核优先级**的参考，而非替代《出口管理条例》《国际紧急经济权力法》等规则下的实体分析；
- 对**疑似误中**条目必须人工复核全名、地址、别名与主体类型；
- 在对外交付中明确**筛查时间、检索式、数据源版本与限制条件**。

---

## 隐私与职业伦理提示

- 仅在**合法、正当目的**下处理个人数据与商业秘密；遵守适用数据保护法与律所内部政策。
- 自动化访问政府网站时请遵守各站点 **Terms of Use** 与 robots/合理使用惯例；高频批量请求可能触发封禁。
- 若将本工具与生成式 AI 联用，应对输出进行**专业复核**，避免将未验证的陈述写入法律意见。

---

## 开源协议

---

## 致谢与数据来源说明

筛查能力依赖 **OpenSanctions** 项目及各国政府**公开**名单与查询接口；具体数据集与官方 URL 以运行时代码与 `references/` 文档为准。感谢全球开放数据社群维护高质量结构化制裁信息。

---

**再次提醒：** 精品开源的目标是**透明方法论与可审计工具链**，而非替代持证律师的专业判断。欢迎在 Issues 中反馈清单更新、站点改版导致的脚本失效等问题，便于社区共同维护。

DataInftra-CrossBoardTrustedDataPace-SanctionScreening

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README