mailcheck-email-verification

# MailCheck Email Verification

Verify email addresses with the MailCheck API - comprehensive email validation with syntax, disposable, DNS, and SMTP checks.

## Features

- **Single Email Verification** - Verify one email at a time
- **Bulk Verification** - Verify up to 100 emails in one request
- **Authenticity Analysis** - Detect phishing, spoofing, and email fraud
- **Risk Scoring** - 0-100 score with risk level (low/medium/high)

## Commands

### `email-verify` - Verify single email

Verifies a single email address.

**Parameters:**
- `email` (required): Email address to verify
- `api_key` (optional): MailCheck API key (falls back to `MAILCHECK_API_KEY` env var)

**Example:**
```bash
email-verify email="user@example.com" api_key="sk_live_..."
```

### `email-bulk-verify` - Bulk verification

Verifies up to 100 email addresses in one request.

**Parameters:**
- `emails` (required): Array of email addresses
- `api_key` (optional): MailCheck API key

**Example:**
```bash
email-bulk-verify emails="[user1@example.com, user2@gmail.com]" api_key="sk_live_..."
```

### `email-auth-verify` - Email authenticity analysis

Analyzes email headers for spoofing, phishing, and CEO fraud.

**Parameters:**
- `headers` (required): Email headers to analyze
- `trusted_domains` (optional): Domains for lookalike detection
- `api_key` (optional): MailCheck API key

**Example:**
```bash
email-auth-verify headers="From: sender@example.com\nReceived: ..." trusted_domains="[company.com]"
```

## Environment Variables

Set `MAILCHECK_API_KEY` with your MailCheck API key to avoid passing it on every command.

## Installation

This skill is available on [ClawHub](https://clawhub.com).

```bash
clawhub install mailcheck-email-verification
```

## API Reference

See full API documentation: https://api.mailcheck.dev/docs

## Repository

Source code: https://github.com/bnuyts/mailcheck-skill

## License

MIT

# MailCheck Email Verification API

## Quick Start

The MailCheck API provides email verification, bulk processing, and email authenticity analysis capabilities.

## Authentication

All API requests require a Bearer token:
```
Authorization: Bearer sk_live_your_api_key
```

## Core Endpoints

1. **POST /v1/verify** - Single email verification
2. **POST /v1/verify/bulk** - Bulk verification (up to 100 emails)
3. **POST /v1/verify/auth** - Email authenticity analysis
4. **GET /v1/account** - Account details and usage
5. **POST /v1/signup** - Create new account

## Score System

- **Syntax (15 pts)**: Valid email format
- **Disposable (20 pts)**: Not from disposable provider
- **MX Records (30 pts)**: Valid mail server exists
- **SMTP (35 pts)**: Mailbox actually exists

**Scores ≥ 80** = Valid, **50-79** = Medium risk, **< 50** = Invalid

## Usage Examples

### Node.js
```javascript
const result = await fetch('https://api.mailcheck.dev/v1/verify', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.MAILCHECK_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ email: 'user@example.com' }),
});
const data = await result.json();
console.log(data.valid, data.score, data.reason);
```

### Python
```python
import requests

resp = requests.post(
    'https://api.mailcheck.dev/v1/verify',
    headers={'Authorization': f'Bearer {API_KEY}'},
    json={'email': 'user@example.com'}
)
data = resp.json()
print(data['valid'], data['score'])
```

## Best Practices

- Cache results (cached verifications don't count against quota)
- Use bulk endpoint for lists > 10 emails
- Check risk_level for quick triage
- Handle rate limits with exponential backoff
- Rotate API keys periodically

## Rate Limits

| Plan | Requests/min | Monthly | Features |
|------|-------------|---------|----------|
| Free | 10 | 100 | Basic verification |
| Starter | 60 | 5,000 | All features |
| Pro | 120 | 25,000 | Bulk + webhooks |
| Enterprise | Unlimited |...