sa-direct-marketing-cli

Herramientas de marketing directo conformes con la POPIA s69 + Reglamento de Enmienda de la CPA 2026 para el alcance sudafricano. Incluye una CLI y un servidor MCP (stdio) que hacen el mismo trabajo: la depuración mensual del registro de exclusión de la NCC.

Por qué existe esto

El registro de exclusión de la Comisión Nacional del Consumidor (NCC) (https://eservice.thencc.org.za/) entró en funcionamiento el 15 de abril de 2026. El Reglamento de Enmienda de 2026 hace obligatorio para los comercializadores directos:

• registrarse como comercializador directo ante la NCC (renovación anual, tarifa ~ZAR 2,574),

• depurar su base de datos de marketing contra el registro mensualmente, y

• nunca comercializar a un consumidor que haya registrado un bloqueo preventivo.

El registro no tiene API pública — es un portal web. Por lo tanto, esta herramienta cruza su lista activa con un CSV de lista de bloqueo que usted exporta desde el portal.

Related MCP server: contact-dedupe

Instalación

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

Uso

# 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

El interruptor --type selecciona el esquema del libro de trabajo:

• log (predeterminado) — el registro de cumplimiento con las pestañas Consent & DNC Log + DNC Register

• leads — una lista maestra de plomeros (pestaña All KZN Plumbers); la columna DNC se crea al escribir

Servidor MCP

node dist/mcp.js

Expone una herramienta: cleanse_marketing_list(logPath, blocklistPath, type?, write?). Conéctelo a Hermes o a cualquier cliente MCP que admita servidores stdio. Registrado en Hermes como sa-direct-marketing (descubierto + habilitado).

Notas de cumplimiento (no es asesoramiento legal)

• Esto automatiza la depuración mecánica. El paso humano — exportar la lista de bloqueo del registro desde el portal de la NCC y registrarse como comercializador — sigue siendo suyo.

• El consentimiento de aceptación de la POPIA sigue siendo necesario antes de cualquier marketing electrónico a no clientes; la depuración del registro es una obligación adicional, no un sustituto.

• Según el Reglamento de 2026, un bloqueo preventivo prevalece sobre el consentimiento anterior.

Licencia

MIT