sa-direct-marketing-cli

POPIA s69 + CPA Amendment Regulations 2026 konformes Direct-Marketing-Tooling für südafrikanische Kundenansprache. Liefert eine CLI und einen MCP-Server (stdio), die dieselbe Aufgabe erfüllen: die monatliche Bereinigung der NCC-Opt-out-Registry.

Warum es das gibt

Die Opt-out-Registry der National Consumer Commission (NCC) (https://eservice.thencc.org.za/) ging am 15. April 2026 live. Die Änderungsverordnung 2026 macht es für Direktvermarkter verpflichtend:

• sich als Direktvermarkter bei der NCC registrieren (jährliche Verlängerung, Gebühr ~ZAR 2.574),

• ihre Marketingdatenbank monatlich gegen die Registry bereinigen und

• niemals einen Verbraucher ansprechen, der eine vorbeugende Sperre registriert hat.

Die Registry hat keine öffentliche API – sie ist ein Webportal. Daher gleicht dieses Tool Ihre aktive Liste mit einer Blocklist-CSV ab, die Sie aus dem Portal exportieren.

Related MCP server: Sanctions Screening MCP Server

Installation

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

Verwendung

# 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

Der Schalter --type wählt das Arbeitsmappen-Schema aus:

• log (Standard) – das Compliance-Protokoll mit den Registerkarten Consent & DNC Log + DNC Register

• leads – eine Master-Klempnerliste (Registerkarte All KZN Plumbers); die DNC-Spalte wird beim Schreiben erstellt

MCP-Server

node dist/mcp.js

Stellt ein Tool bereit: cleanse_marketing_list(logPath, blocklistPath, type?, write?). Binden Sie es in Hermes oder einen beliebigen MCP-Client ein, der stdio-Server unterstützt. In Hermes als sa-direct-marketing registriert (entdeckt + aktiviert).

Compliance-Hinweise (keine Rechtsberatung)

• Dies automatisiert die mechanische Bereinigung. Der menschliche Schritt – das Exportieren der Registry-Blocklist aus dem NCC-Portal und die Registrierung als Vermarkter – bleibt Ihnen überlassen.

• Die POPIA-Opt-in-Einwilligung ist weiterhin erforderlich, bevor elektronisches Marketing an Nicht-Kunden erfolgt; die Registry-Bereinigung ist eine zusätzliche Verpflichtung, kein Ersatz.

• Gemäß der Verordnung von 2026 hat eine vorbeugende Sperre Vorrang vor einer früheren Einwilligung.

Lizenz

MIT