---
name: email-validator
description: Validate email addresses with format checks, DNS MX verification, and typo detection. Returns validation results with suggestions for common typos.
homepage: https://github.com/alex-vbcoding/email-validator-skill
metadata: {"openclaw": {"emoji": "📧", "requires": {"bins": ["node"]}}}
---

# Email Validator Skill

Validate email addresses with comprehensive checks: format validation, DNS record verification, and common typo detection.

## Features

- ✅ RFC-compliant email format validation
- ✅ DNS MX record verification (checks if domain can receive email)
- ✅ Common typo detection (e.g., "gmial.com" → "gmail.com")
- ✅ Disposable email detection
- ✅ Batch validation support

## Installation

```bash
npm install email-validator-skill
```

## Usage

### Basic validation

```javascript
const { validateEmail } = require('email-validator-skill');

const result = await validateEmail('user@example.com');
console.log(result);
// {
//   valid: true,
//   email: 'user@example.com',
//   checks: {
//     format: true,
//     dns: true,
//     disposable: false
//   }
// }
```

### Check for typos

```javascript
const result = await validateEmail('user@gmial.com');
// {
//   valid: false,
//   suggestion: 'user@gmail.com',
//   typo: 'gmial.com' → 'gmail.com'
// }
```

### Batch validation

```javascript
const emails = ['valid@example.com', 'invalid@', 'typo@gmial.com'];
const results = await validateBatch(emails);
```

## API Reference

### `validateEmail(email, options)`

**Parameters:**
- `email` (string): Email address to validate
- `options` (object):
  - `checkDNS` (boolean): Verify DNS MX records (default: true)
  - `checkTypos` (boolean): Suggest typo corrections (default: true)
  - `timeout` (number): DNS timeout in ms (default: 5000)

**Returns:** Promise<ValidationResult>

### `validateBatch(emails, options)`

Validate multiple emails efficiently.

**Parameters:**
- `emails` (array): Array of email addresses
- `options` (object): Same as validateEmail

**Returns:** Promise<ValidationResult[]>

## Common Typos Detected

- gmial.com → gmail.com
- yahooo.com → yahoo.com
- hotmial.com → hotmail.com
- outlok.com → outlook.com

## License

MIT

## Author

Alex Chen (alex@metaleap.so)