MailFixture

MailFixtureとは？

MailFixtureは、CI環境向けに特化して構築された受信専用のメールテストサービスです。単一のAPI呼び出しで実際のテスト受信トレイを提供し、アプリケーションが実際のメール（OTP、マジックリンク、確認コード）を送信できるようにします。テストスイートは、解析済みで型付けされ、アサーションの準備が整った状態でメールを受信します。偽のメールサーバーやブロックリストに載ってしまう使い捨ての受信トレイに悩む代わりに、MailFixtureは実際のものと同じように動作する本物の受信トレイをテストに提供し、配信は通常1秒未満で完了します。

対象者

• CI/CDエンジニア：タイミングの問題や共有テストドメインが原因で、ローカルでは成功するのにパイプラインでは失敗する、不安定なメールテストにうんざりしている方。
• QA自動化チーム：Playwright、Cypress、pytest、Seleniumを使用しており、壊れやすい正規表現パーサーを書かずに決定的なOTPとリンク抽出を必要としている方。
• AIエージェント開発者：LLMを活用したツールが自律的に受信トレイを作成し、サインアップフローをトリガーし、MCPを介して確認コードを読み取れるようにしたい方。

主な機能

ロングポーリング内蔵

waitForMessage()は、メールが届くまで接続を開いたままにします（アプリが送信してから通常1秒未満）。sleep(5000)も、500msごとのポーリングループも、「CIでは不安定、ローカルでは問題なし」という言い訳も不要です。APIがあなたを待つのではなく、その逆です。

ファーストクラスの抽出

すべてのメッセージは事前解析済みで届きます。ワンタイムコード、マジックリンク、確認リンクは分類され、extractedフィールドに格納されます。SPF/DKIM/DMARCの判定結果やSpamAssassinのスパムスコアも併せて確認できます。アサーションは1行で済み、マーケティングがメールテンプレートを再設計しても壊れません。

カスタムドメイン

1つのMXレコードをMailFixtureに向けるだけで、すべてのフィクスチャがtests.yourdomain.com上に配置されます。ドメインが自分のものなので、共有テストメールドメインを悩ませる「使い捨てメールが検出されました」という自社のサインアップフォームによるフラグが付けられることはありません。

ダッシュボードとMCPサポート

ダッシュボードでは、受信トレイがリアルタイムで埋まっていくのを確認でき、レンダリングされたHTML、プレーンテキスト、ヘッダー、生のソースが表示され、抽出されたOTPはワンクリックでクリップボードにコピーできます。MailFixtureはリモートMCPサーバーとしても機能するため、AIエージェントが自律的に受信トレイを作成し、OTPを読み取ることができます。

際立っている点

「配信 → 解析 → アサーション。」

これが6語で表したすべての約束です。ほとんどのメールテストツールは配信で止まります。生のメッセージを渡して、解析とアサーションのロジックを自分で構築することを期待します。MailFixtureは、OTPと確認リンクを正規表現の宿題ではなくファーストクラスのフィールドとして扱うことで、さらに一歩進んでいます。リトライループを排除するロングポーリングと、ブロックリスト問題を回避するカスタムドメインを組み合わせることで、メールテストの不安定さの3大原因を一気に取り除きます。

検討する価値があるのは…

メール配信に依存するエンドツーエンドテストを構築していて、waitForTimeout(5000)では不十分な理由のデバッグにうんざりしている場合。チームがローカルではOTPテストが成功したのにCIで失敗したために、壊れたサインアップフローをリリースした経験があるなら、MailFixtureのアプローチは検討に値します。無料枠には月100メッセージが含まれ、クレジットカードは不要です。有料プランは月額15ドルからで、シートごとの料金はありません。メッセージ数に対して支払い、人数に対しては支払いません。また、独自のサインアップフローをエンドツーエンドで検証する必要があるAIエージェントを試している場合にも最適です。