autoreg-skills-max/skills/github-autoreg/references/mailtm-utils.md

mail.tm Utilities — disposable email backend for GitHub AutoReg

mail.tm API предоставляет временные почтовые ящики без регистрации. GitHub принимает письма на mail.tm-домены (web-library.net, и др.).

API Reference

Base URL: https://api.mail.tm

create_email()

from src.mailtm_utils import create_email

mail = create_email()
# {
#     "email": "ghx8s5czsqqfzu@web-library.net",
#     "password": "shuzMXH4bj1P6Awf9wrA...",
#     "token": "eyJ0eXAiOiJKV1QiLCJh..."
# }

Флоу:

1. GET /domains — получить доступный домен
2. POST /accounts — создать ящик ({address, password})
3. POST /token — получить JWT токен ({address, password})

wait_for_code(token, timeout=120)

code = wait_for_code(mail["token"], timeout=120)
# "848413" — 6-8 digit verification code

Флоу:

1. GET /messages — поллить входящие (Authorization: Bearer token)
2. Фильтровать по from.address содержит github.com
3. GET /messages/{id} — прочитать тело письма
4. Regex \b(\d{6,8})\b — извлечь код подтверждения

Проверено

• 2026-07-27: nova9417 создан через mail.tm (домен web-library.net)
• GitHub отправил verification code, код успешно извлечён и применён

Питфолы

• Домен может меняться — всегда вызывать GET /domains перед созданием, не хардкодить
• Письма могут задержаться — GitHub отправляет письмо не мгновенно, timeout=120 покрывает
• Токен истекает — mail.tm JWT живёт ограниченное время, создавать новый ящик для каждой регистрации
• Не использовать для входа — ящики одноразовые, после регистрации email может понадобиться для 2FA/восстановления