MAHMOUD ABDELNABY
Automation · CLI SCRIPT · 2

RFC 8058 One-Click Unsubscribe & Deliverability Sentinel

Verify Google and Yahoo RFC 8058 compliance, test SPF/DKIM/DMARC alignment, and protect your domain sender reputation.

Problem it addresses

Build an open-source email deliverability and header audit CLI (deliverability_sentinel.py): 1) Parses raw .eml or RFC 822 email files, 2) Validates presence and syntax of List-Unsubscribe and List-Unsubscribe-Post: List-Unsubscribe=One-Click, 3) Checks DNS domain alignment for SPF, DKIM, and DMARC policies, 4) Outputs an executive compliance scorecard with pass/fail terminal status.

Who it is for

PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

What is inside

Key files listed in the README repository architecture:

  • checklists/gmail-yahoo-2024-standards.md
  • examples/sample_compliant_and_broken.eml
  • LICENSE
  • playbooks/spam-folder-recovery-sop.md
  • README.md
  • reports/audit_report.json
  • src/deliverability_checker.py
  • src/deliverability_sentinel.py
  • templates/dns-records-template.md
  • tests/test_deliverability.py
  • tests/test_sentinel.py

How to evaluate and use it

  1. Read the README first and confirm that the documented problem matches your use case.
  2. Inspect the listed files to find the data, tools, templates, and tests relevant to your task.
  3. Follow the repository’s Quick Start and check prerequisites before running commands.
  4. Compare outputs with documented examples and review limitations before using them in a decision or client workflow.

Quick Start from the README: python -m unittest discover -s tests · python src/deliverability_checker.py --help

Scope and limitations

  • Header-Based One-Click Unsubscribe: Enforces presence of valid 'List-Unsubscribe: <https:...>' and 'List-Unsubscribe-Post: List-Unsubscribe=One-Click' headers.
  • HTTPS POST Processing: Unsubscribe URLs must execute unsubscription upon receipt of an HTTP POST request without redirecting to a confirmation landing page.
  • Bulk Sender Compliance: Aligns with mandatory 2024 Gmail and Yahoo sender guidelines for domains sending >5,000 emails daily.

This page summarizes the available documentation; it does not establish performance or business results. Verify data and prerequisites before use.

Related repositories