MailFlat SDKs

Официальные клиентские библиотеки для MailFlat: почтовые ящики, которыми владеет ваш код, с однострочным получением OTP. Создано для тестовых наборов (Selenium, pytest, Playwright) и ИИ-агентов.

Адреса постоянные, поэтому набору не нужен новый адрес для каждого запуска. Истекают только сообщения, в соответствии с выбранным вами окном хранения.

В этом репозитории находятся только SDK с открытым исходным кодом. Сам сервис MailFlat является закрытым.

Пакеты

Каждый клиент — это тонкая типизированная обёртка над одним и тем же Agent API /api/v1, поэтому они ведут себя одинаково. Авторизуйтесь с помощью ключа аккаунта (mf_live_…) из панели управления (Агенты → Ключи API).

Related MCP server: useblip/email

Java / Selenium (JitPack)

JitPack выводит groupId из владельца GitHub. Этот репозиторий переехал в официальный аккаунт MailFlat в августе 2026 года, поэтому релизы начиная с v0.4.4 публикуются как com.github.MailFlat:mailflat-sdks. Более ранние версии по-прежнему доступны по старому координату com.github.onderyentar21:mailflat-sdks; старый репозиторий остаётся для них. Клиент вскоре переедет на Maven Central (net.mailflat), что устранит зависимость от владельца.

<repositories>
  <repository><id>jitpack.io</id><url>https://jitpack.io</url></repository>
</repositories>

<dependency>
  <groupId>com.github.MailFlat</groupId>
  <artifactId>mailflat-sdks</artifactId>
  <version>v0.4.5</version>
</dependency>

MailFlat mf = new MailFlat("mf_live_…");
Inbox inbox = mf.create("signup");
driver.findElement(By.id("email")).sendKeys(inbox.address());
String otp = inbox.waitForOtp(30);          // polls until the code arrives
driver.findElement(By.id("code")).sendKeys(otp);

Быстрые примеры

Python

from mailflat import MailFlat
mf = MailFlat(api_key="mf_live_…")
inbox = mf.create(label="signup")
otp = inbox.wait_for_otp(timeout=30)

JavaScript / TypeScript

import { MailFlat } from "@mailflat/sdk";
const mf = new MailFlat({ apiKey: process.env.MAILFLAT_API_KEY });
const inbox = await mf.create({ label: "signup" });
const otp = await inbox.waitForOtp({ timeout: 30000 });

Лицензия

MIT. Полный текст находится в LICENSE в корне репозитория; каждый каталог пакета содержит идентичную копию.