面向律师、合规官、贸易合规与 KYC/AML 团队的开源筛查工具链：在客户尽调、交易对手审查、出口前筛查、争议与调查支持等场景中，协助快速拉通「第三方名单聚合 → 政府官网核验 → 公开情报摘要 → 结构化交付物」的工作流。
重要声明（请律师同仁首先阅读）
本仓库提供的是技术辅助工具与流程模板，输出内容为基于公开数据源与自动化抓取的事实整理与风险线索汇总，不构成法律意见、监管解读或终局合规结论。是否阻断交易、如何起草法律文件、是否满足特定义务，须由具有执业资格的专业人士结合具体事实管辖与业务场景独立判断。
制裁与出口管制规则更新频繁，任何筛查报告的时效性有限；请以各司法辖区官方最新公布文本与执法实践为准。
仓库地址： github.com/TracyWang95/DataInftra-CrossBoardTrustedDataPace-SanctionScreening
| 场景 | 说明 |
|---|---|
| 客户/交易对手准入 | 对法人或自然人名称进行多源检索与官网核验，形成可归档的检索记录与截图证据链。 |
| 进出口与供应链 | 与美国 BIS、OFAC、DoD 1260H、欧盟/联合国等多类清单相关的初筛与线索定位（深度法律分析仍须专业意见）。 |
| 诉讼与调查支持 | 固定时间点、固定检索式下的网页与名单状态，作为过程性材料（是否满足证据规则由承办律师评估）。 |
| 律所知识管理 | 将 SKILL.md 与 references/ 中的清单说明、红旗清单、法律影响模板嵌入内部知识库或 Agent 工作流。 |
本项目的 SKILL.md 是为 AI 助手（如 Claude/Cursor）编写的操作规范：何时必须向客户确认搜索变体、何时严格按用户给定字符串检索、如何串联脚本与交付物路径。人类律师可直接阅读该文件理解全流程逻辑。
-
第一层 — 聚合初筛（OpenSanctions）
对接 OpenSanctions 等聚合数据，覆盖全球 100+ 制裁与涉敏名单数据集，用于快速定位候选命中。聚合数据可能存在延迟或匹配误差，不能单独作为终局依据。 -
第二层 — 官方网站核验（Playwright）
通过浏览器自动化访问多国/多机构官方公开查询入口（如 OFAC、BIS CSL、UN、EU、UK、澳大利亚 DFAT、加拿大 SEMA 等路径，以脚本内配置为准），进行搜索并截图留痕，便于工作底稿归档。 -
第三层 — 受控情报摘要（Tavily）
对限定域/受信新闻与公开网页进行检索，用于补充上下文（如公开报道、监管动态），不替代官方法律文本。 -
误中审查（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 安装）
cd sanctions-screening # 或克隆后的项目根目录
pip install -r requirements.txt
python -m playwright install chromiumcopy .env.example .env # Windows；Unix 使用 cp编辑 .env，填入：
OPENSANCTIONS_API_KEY— OpenSanctions APITAVILY_API_KEYS或TAVILY_API_KEY— Tavily
本仓库 .gitignore 已排除 .env；若您曾将密钥写入其他文件并误提交，请立即轮换密钥并自 Git 历史中清除敏感提交（可使用 git filter-repo 等工具，或新建空仓库仅保留净提交）。
初筛与情报汇总（阶段 1 思路，具体参数见 SKILL.md）：
python scripts/screen_entity.py "Example Corp" --type LegalEntity -o Example_api_report.md官网核验与 HTML/PDF 报告（阶段 2+，需已安装 Playwright）：
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 联用，应对输出进行专业复核，避免将未验证的陈述写入法律意见。
本项目以 MIT License 发布（见 LICENSE）。使用、修改与再分发时请保留版权声明。
筛查能力依赖 OpenSanctions 项目及各国政府公开名单与查询接口；具体数据集与官方 URL 以运行时代码与 references/ 文档为准。感谢全球开放数据社群维护高质量结构化制裁信息。
再次提醒： 精品开源的目标是透明方法论与可审计工具链，而非替代持证律师的专业判断。欢迎在 Issues 中反馈清单更新、站点改版导致的脚本失效等问题，便于社区共同维护。