sa-direct-marketing-cli

符合 POPIA s69 和 CPA 修正条例 2026 的南非外联直接营销工具。提供 CLI 和 MCP 服务器（stdio），两者执行相同任务：每月 NCC 退出注册表清理。

为什么存在

National Consumer Commission (NCC) 的退出注册表（https://eservice.thencc.org.za/）于 2026 年 4 月 15 日 上线。2026 年修正条例规定直接营销人员必须：

• 向 NCC 注册为直接营销人员（每年续期，费用约 ZAR 2,574），

• 每月根据注册表清理其营销数据库，以及

• 绝不向已注册预防性屏蔽的消费者进行营销。

该注册表没有公共 API——它是一个 Web 门户。因此，此工具将您的活动列表与从门户导出的阻止列表 CSV 进行交叉引用。

Related MCP server: Sanctions Screening MCP Server

安装

npm install
npm run build
npm link            # exposes `sa-dm`

用法

# Dry run (reports matches, writes nothing)
sa-dm cleanse --log KZN_Outreach_Compliance_Log.xlsx --blocklist ncc-export.csv

# Apply DNC changes (flips matched rows, appends to DNC Register)
sa-dm cleanse --log KZN_Outreach_Compliance_Log.xlsx --blocklist ncc-export.csv --write

# Also supports the MASTER LEADS list (KZN_Plumbers_Master.xlsx style):
sa-dm cleanse --log KZN_Plumbers_Master.xlsx --type leads --blocklist ncc-export.csv --write
#   -> adds a "DNC (Y/N)" column if absent, flips matches, appends a DNC Register tab

--type 开关选择工作簿架构：

• log（默认）— 包含 Consent & DNC Log 和 DNC Register 选项卡的合规日志

• leads — 主水管工列表（All KZN Plumbers 选项卡）；写入时创建 DNC 列

MCP 服务器

node dist/mcp.js

暴露一个工具：cleanse_marketing_list(logPath, blocklistPath, type?, write?)。将其接入 Hermes 或任何支持 stdio 服务器的 MCP 客户端。在 Hermes 中注册为 sa-direct-marketing（已发现并启用）。

合规说明（非法律建议）

• 这自动化了机械性清理。人工步骤——从 NCC 门户导出注册表阻止列表并注册为营销人员——仍由您完成。

• 在向非客户进行任何电子营销之前，仍需要 POPIA 的明确同意；注册表清理是额外义务，而非替代品。

• 根据 2026 年条例，预防性屏蔽优先于先前的同意。

许可证

MIT