Skip to main content
Glama
sa-direct-marketing

sa-direct-marketing

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: contact-dedupe

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables cleaning tabular data by detecting duplicates, placeholder nulls, type issues, spelling variants, encryption damage, outliers, and personal data, then applying safe fixes automatically while requiring human approval for risky changes.
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables MCP clients to analyze contact exports, identify duplicate people with evidence-based matching, merge them into a cleaned CSV, and report every conflicting value.
    4
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables converting PDFs and CSV/spreadsheet files into spreadsheets, extracting bank statement or receipt data into clean CSV, cleaning messy CSV, and generating client-ready reports through an open MCP endpoint.
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables cleaning clinical-research tables by mapping fields, classifying and normalizing cells, routing confidence-gated decisions to a review queue, and exporting reports and audit logs through an MCP stdio interface.
    MIT