sa-direct-marketing-cli

남아프리카 공화국 아웃리치를 위한 POPIA s69 및 CPA 개정 규정 2026을 준수하는 다이렉트 마케팅 도구입니다. 동일한 작업을 수행하는 CLI와 MCP 서버(stdio)를 제공합니다: 월간 NCC 옵트아웃 레지스트리 정리.

왜 존재하는가

국가소비자위원회(NCC) 옵트아웃 레지스트리(https://eservice.thencc.org.za/)가 2026년 4월 15일에 시작되었습니다. 2026년 개정 규정에 따라 다이렉트 마케터는 다음을 의무적으로 수행해야 합니다:

• NCC에 다이렉트 마케터로 등록(연간 갱신, 수수료 약 ZAR 2,574)

• 매월 레지스트리와 대조하여 마케팅 데이터베이스를 정리하고,

• 사전 차단을 등록한 소비자에게 마케팅을 절대 하지 않아야 합니다.

레지스트리에는 공개 API가 없습니다 — 웹 포털입니다. 따라서 이 도구는 포털에서 내보낸 차단 목록 CSV와 활성 목록을 대조합니다.

Related MCP server: Sanctions Screening MCP Server

Install

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

Usage

# 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 server

node dist/mcp.js

하나의 도구를 노출합니다: cleanse_marketing_list(logPath, blocklistPath, type?, write?). Hermes 또는 stdio 서버를 지원하는 모든 MCP 클라이언트에 연결하세요. Hermes에서 sa-direct-marketing으로 등록됩니다(발견 및 활성화됨).

규정 준수 참고 사항(법적 조언 아님)

• 이 도구는 기계적 정리를 자동화합니다. NCC 포털에서 레지스트리 차단 목록을 내보내고 마케터로 등록하는 인간의 단계는 여전히 여러분의 몫입니다.

• 비고객에게 전자 마케팅을 하기 전에는 여전히 POPIA 옵트인 동의가 필요합니다. 레지스트리 정리는 추가 의무이지 대체가 아닙니다.

• 2026년 규정에 따라 사전 차단은 이전 동의보다 우선합니다.

License

MIT