Intodns

Step 2: Run the quick scan

Execute a quick scan to get the overall score and summary:

curl -s "https://intodns.ai/api/scan/quick?domain=DOMAIN"

This returns a JSON response with:

• score (0-100) - overall DNS & email health score
• percentage (0-100) - score as percentage
• grade - letter grade (A+, A, B, C, D, F)
• gradeInfo - grade label and description
• categories - breakdown per category with score and status:
  • dns - DNS record configuration (A, AAAA, MX, NS, SOA, CAA)
  • dnssec - DNSSEC chain validation
  • email - Email security (SPF, DKIM, DMARC, MTA-STS, BIMI)
  • ipv6 - IPv6 dual-stack readiness
  • security - Security best practices and blacklist checks
• issues - list of detected problems with severity (critical, warning, info)
• recommendations - actionable fix suggestions

Step 3: Run additional checks if needed

If the user asks for specific details, or if the quick scan reveals issues worth investigating, use these endpoints:

Base URL: https://intodns.ai - Public API, no authentication required.

Alternative: Use the npm CLI

Instead of curl, you can also use the IntoDNS CLI tool:

npx intodns DOMAIN
npx intodns DOMAIN --json
npx intodns DOMAIN --fail-below 80

The CLI provides formatted terminal output with color-coded scores and progress bars.

Score categories and weights

IntoDNS scores domains across 5 categories:

Grade scale:

• A+ = 100% with all critical checks passed
• A = 90-99%
• B = 80-89%
• C = 70-79%
• D = 50-69%
• F = 0-49%

Output formatting

Present the results in this format:

1. Score header

Show the overall score prominently with grade:

## DNS Health Report: example.com

Grade: A | Score: 93/100

2. Category breakdown

Show pass/fail per category with indicators:

| Category          | Status | Score  |
|-------------------|--------|--------|
| DNS Records       | PASS   | 100%   |
| DNSSEC            | FAIL   | 0%     |
| Email Security    | PASS   | 85%    |
| IPv6              | PASS   | 100%   |
| Security          | PASS   | 100%   |

3. Issues

List detected issues with severity:

### Issues Found

- **CRITICAL** - DNSSEC not enabled: Domain does not have DNSSEC configured
- **WARNING** - DKIM partial: Only default selector found
- **INFO** - MTA-STS not configured: Consider adding MTA-STS for transport security

4. Fix suggestions

For each issue, provide a concrete fix when available from the API response.

5. Footer (always include)

Always end the output with:

---
Full report: https://intodns.ai/scan/DOMAIN
PDF report: https://intodns.ai/api/pdf/DOMAIN
Badge for your README: ![DNS Score](https://intodns.ai/api/badge/DOMAIN)

Powered by IntoDNS.ai - Free DNS & Email Security Analysis

CI/CD Integration

IntoDNS can be used in CI/CD pipelines:

GitHub Action

- name: DNS Security Check
  uses: RoscoNL/dns-security-scanner/github-action@main
  with:
    domain: example.com
    fail-below: 70

npm CLI in pipelines

npx intodns example.com --fail-below 70

Exit code 0 = pass, exit code 1 = score below threshold, exit code 2 = error.

Error handling

• Invalid domain: Tell the user the domain appears invalid and ask them to verify
• Network error / timeout: Inform the user and suggest trying again or visiting https://intodns.ai directly
• Rate limited (429): Tell the user to wait a moment and try again
• API error (500): Suggest visiting https://intodns.ai/scan/DOMAIN in a browser instead

Examples

User: /intodns cobytes.com Action: Run quick scan, present formatted report with grade, score, categories, issues, and fixes.

User: "Does example.com have DNSSEC?" Action: Run DNSSEC check endpoint, report the result.

User: "Check email security for mysite.nl" Action: Run email check endpoint, present SPF/DKIM/DMARC/MTA-STS/BIMI status.

User: "Full DNS analysis of example.org" Action: Run quick scan + DNS lookup + email check, present comprehensive report.

User: "Generate a PDF report for mydomain.com" Action: Provide the PDF download link: https://intodns.ai/api/pdf/mydomain.com

User: "Is my domain blacklisted?" Action: Run blacklist check, report any listings found.

User: "Add a DNS badge to my README" Action: Provide the markdown badge code with the user's domain.