MailFlat

MailFlat SDKs

MailFlat の公式クライアントライブラリです。コードが所有するメール受信箱を利用でき、ワンラインで OTP を取得できます。テストスイート（Selenium、pytest、Playwright）と AI エージェント向けに構築されています。

アドレスは永続的なため、テストスイートでは実行ごとに新しいアドレスを用意する必要はありません。選択した保持期間が過ぎると、メッセージのみが期限切れになります。

このリポジトリにはオープンソースの SDK のみが含まれています。MailFlat サービス自体はクローズドソースです。

パッケージ

パッケージ	対象	インストール
mailflat	Python	pip install mailflat
@mailflat/sdk	JavaScript / TypeScript	npm i @mailflat/sdk
mailflat-mcp	AI アシスタント（Claude、Cursor）— MCP	uvx mailflat-mcp
@mailflat/ai-sdk	Vercel AI SDK エージェント	npm i @mailflat/ai-sdk
mailflat.langchain	LangChain エージェント	pip install "mailflat[langchain]"
mailflat-sdk（Java）	Java / Selenium	JitPack 経由 — 以下を参照

各クライアントは、同じ /api/v1 Agent API を使う薄い型付きラッパーであるため、同じ動作をします。ダッシュボード（Agents → API keys）から取得したアカウントキー（mf_live_…）で認証してください。

Java / Selenium（JitPack）

JitPack は GitHub のオーナーから groupId を導出します。このリポジトリは 2026 年 8 月に公式の MailFlat アカウントに移行したため、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.8.1</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 に記載されています。各パッケージディレクトリにも同一のコピーが含まれています。