sa-direct-marketing-cli

POPIA s69 + CPA Amendment Regulations 2026準拠の、南アフリカ向けダイレクトマーケティングツールです。CLIとMCPサーバー（stdio）を同梱しており、どちらも同じ仕事をします：毎月のNCCオプトアウトレジストリのクレンジングです。

存在理由

全国消費者委員会（NCC）のオプトアウトレジストリ（https://eservice.thencc.org.za/）は、2026年4月15日に稼働しました。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?)という1つのツールを公開します。Hermesまたはstdioサーバーをサポートする任意のMCPクライアントに接続できます。Hermesではsa-direct-marketingとして登録されています（検出・有効化済み）。

コンプライアンスに関する注意（法的助言ではありません）

• これは機械的なクレンジングを自動化するものです。NCCポータルからレジストリのブロックリストをエクスポートし、マーケターとして登録するという人的ステップは、引き続きお客様の責任です。

• 非顧客への電子マーケティングを行う前には、POPIAのオプトイン同意が依然として必要です。レジストリのクレンジングは追加の義務であり、代替ではありません。

• 2026年規則に基づき、事前ブロックは以前の同意に優先します。

ライセンス

MIT