sa-direct-marketing-cli

Инструментарий для прямого маркетинга, соответствующий POPIA s69 + CPA Amendment Regulations 2026, для южноафриканских рассылок. Поставляется с CLI и MCP-сервером (stdio), которые выполняют одну и ту же задачу: ежемесячная очистка реестра отказов NCC.

Зачем это существует

Реестр отказов National Consumer Commission (NCC) (https://eservice.thencc.org.za/) заработал 15 апреля 2026 года. Поправки к нормативным актам 2026 года обязывают прямых маркетологов:

• зарегистрироваться как прямой маркетолог в NCC (ежегодное продление, плата ~ZAR 2,574),

• ежемесячно очищать свою маркетинговую базу данных по реестру, и

• никогда не предлагать услуги потребителю, который зарегистрировал предварительный запрет.

У реестра нет публичного API — это веб-портал. Поэтому этот инструмент сверяет ваш активный список с CSV-файлом блокировок, который вы экспортируете с портала.

Related MCP server: contact-dedupe

Установка

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 или любому MCP-клиенту, поддерживающему stdio-серверы. Зарегистрирован в Hermes как sa-direct-marketing (обнаружен и включён).

Примечания о соответствии (не юридическая консультация)

• Это автоматизирует механическую очистку. Человеческий шаг — экспорт блок-листа реестра с портала NCC и регистрация в качестве маркетолога — остаётся за вами.

• Согласие POPIA по-прежнему требуется перед любой электронной рассылкой не-клиентам; очистка реестра является дополнительным обязательством, а не заменой.

• Согласно поправкам 2026 года, предварительный запрет имеет приоритет над ранее данным согласием.

Лицензия

MIT