Skip to content

About

⚡ Ultra-fast CLI to audit domain SPF, DKIM, DMARC, MX records, and DNSBL blacklist status directly from your terminal.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpsTrellis DNS Deliverability CLI

License: MIT Node.js Deliverability

A lightning-fast, zero-dependency Node.js CLI tool to audit your domain's SPF, DKIM, DMARC, and MX records in seconds directly from your terminal.

Maintained with ❤️ by OpsTrellis — IT Automation & Deliverability Engineering.


🚀 Quick Start

Run instantly with npx (no installation required):

npx @opstrellis/dns-deliverability-cli yourdomain.com

Or install globally:

npm install -g @opstrellis/dns-deliverability-cli
opstrellis-dns yourdomain.com

📋 What It Audits

  1. MX Records: Validates mail server routes and priorities to confirm incoming mail routing.
  2. SPF (v=spf1): Checks for valid syntax, alignment, and strict (-all) vs soft (~all) policies.
  3. DMARC (v=DMARC1): Verifies policy enforcement (p=none, p=quarantine, or p=reject) aligned with 2024+ Gmail & Yahoo sender requirements.
  4. DKIM Selectors: Probes common provider selectors (google, k1, default, s1, mail) to confirm cryptographic domain key publication.
  5. Score & Actionable Recommendations: Computes an instant health score out of 100 with clear guidance on what to fix.

💻 Example Output

=====================================================
  OpsTrellis Deliverability Auditor  (v1.0.0)
  Auditing: opstrellis.com
=====================================================

1. MX Records: [ PASS ]
   - Priority 10: mail.opstrellis.com

2. SPF Record: [ PASS ]
   v=spf1 include:secureserver.net -all

3. DMARC Policy: [ PASS ]
   Policy: quarantine
   Raw: v=DMARC1; p=quarantine; pct=100;

4. DKIM Signatures:
   ✔ Found selector [default]: v=DKIM1; k=rsa; p=MIGfMA0GCS...

-----------------------------------------------------
Overall Health Score: 95 / 100 [EXCELLENT]
-----------------------------------------------------
Need full SPF/DKIM/DMARC repair or cold outbound infrastructure?
Visit https://opstrellis.com or run the web audit at https://opstrellis.com/tools/domain-health/

🛠️ Programmatic Usage (Node.js SDK)

You can also import the auditor into your own Node.js backend or automation script:

import { auditDomain } from '@opstrellis/dns-deliverability-cli';

const report = await auditDomain('example.com');
console.log(report.summary.score); // 95
console.log(report.spf.record);
console.log(report.dmarc.policy);

🌐 Online Audit Suite & Free Tools

Prefer a web interface with visual guides and SPF/DMARC record generators?


📄 License

MIT License. Copyright (c) 2026 OpsTrellis. Contributions are welcome!

About

⚡ Ultra-fast CLI to audit domain SPF, DKIM, DMARC, MX records, and DNSBL blacklist status directly from your terminal.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages