email-infra について
ColdIQ が提供する Instantly エンドポイントを使い、容量計画から運用監視までを案内するコールドメール基盤向けエージェントスキルです。配信前のメールボックス準備や健全性確認に利用できます。
主な機能
- 01メールボックスとドメインの必要数を算出
- 02事前ウォームアップ済み受信箱の注文または自前の接続
- 03ウォームアップの開始と分析の確認
- 04開始前のメールボックス健全性テスト
- 05日次の送信データの監視
活用シーン
- 01コールドメールの目標量に応じた基盤の計画
- 02送信前のメールボックス設定とウォームアップ
- 03開始前の健全性確認と配信状況の監視
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ cold-iq/ coldiq-marketplace-skills --skill email-infraインストール後、Claude Code で/email-infraを入力して読み込まれたか確認します。
詳細
メールインフラストラクチャ
コールドメールのインフラをゼロから稼働状態にするために、規模を算定し、メールボックスを用意してウォームアップし、健全性を確認します。ColdIQ が再販する Instantly のアカウント/ウォームアップ用エンドポイントを使用します(BYOK、無料、ColdIQ クレジット不要)。インフラが健全な状態になったら、キャンペーンについては instantly-api に引き継ぎます。
ColdIQ Marketplace エンドポイント
| タスク | メソッド | パス | クレジット | エンドポイント ID | 備考 |
|---|---|---|---|---|---|
| 事前ウォームアップ済みの受信箱を注文する | POST | /v1/instantly/dfy-email-account-orders | free | instantly.dfy_orders.create | 最短で稼働状態にする方法 |
| ドメインの利用可能状況を確認する | POST | /v1/instantly/dfy-email-account-orders/domains/check | free | instantly.dfy_orders.domains_check | 購入前に確認 |
| 事前ウォームアップ済みドメインを一覧表示する | POST | /v1/instantly/dfy-email-account-orders/domains/pre-warmed-up-list | free | instantly.dfy_orders.domains_prewarmed | 2~3 週間のウォームアップを省略 |
| メールボックスを接続する | POST | /v1/instantly/accounts | free | instantly.accounts.create | 自分で用意したメールボックスを使用 |
| メールボックスを一覧表示する | GET | /v1/instantly/accounts | free | instantly.accounts.list | 一覧 |
| メールボックスの健全性を取得する | GET | /v1/instantly/accounts/{email} | free | instantly.accounts.get | アカウントごとのステータス |
| ウォームアップを有効にする | POST | /v1/instantly/accounts/warmup/enable | free | instantly.accounts.warmup_enable | 送信開始の 2~3 週間前に開始 |
| ウォームアップを無効にする | POST | /v1/instantly/accounts/warmup/disable | free | instantly.accounts.warmup_disable | キャンペーン開始後は避けてください |
| ウォームアップ分析 | POST | /v1/instantly/accounts/warmup-analytics | free | instantly.accounts.warmup_analytics | 健全性スコア |
| アカウントのバイタルをテストする | POST | /v1/instantly/accounts/test/vitals | free | instantly.accounts.test_vitals | リリース前の確認 |
| アカウントの日次分析 | GET | /v1/instantly/accounts/analytics/daily | free | instantly.accounts.analytics_daily | 稼働中の送信を監視 |
重要なルール(必ず守ってください)
- コールドアウトリーチにプライマリドメインを使用しないでください。
- 1 ドメインあたりのメールボックスは最大 2 個です。
- 1 ドメインにつき 1 ワークスペースを使用してください(混在させないでください)。
- 複数のレジストラを使用してください(単一障害点を作らないでください)。
- 送信前に最低 2~3 週間ウォームアップしてください。
- キャンペーンの実行中はウォームアップを無効にしないでください。
- 控えめに開始し、段階的に拡大してください。
インフラ規模の算定式
- 月間目標 ÷ 営業日 20 日 = 1 日あたりの送信数
- 1 日あたりの送信数 ÷ メールボックスあたり 20~25 通 = 必要なメールボックス数
- メールボックス数 × 1.5(バッファ)÷ 2 = 必要なドメイン数
- プロバイダーの割合:Google Workspace 60%、Microsoft 365 40%
例:月 3,000 通 → 1 日 150 通 → メールボックス 10~12 個 → ドメイン 5~6 個。
DNS — 4 つのレコードすべてが必須
| レコード | 用途 |
|---|---|
| MX | 受信メールをルーティングします |
| SPF | 送信サーバーを宣言します |
| DKIM | デジタル署名による認証 |
| DMARC | SPF/DKIM の失敗時に適用するポリシー |
(DNS はレジストラ/プロバイダー側で設定します。ColdIQ は DNS を設定しません。手動設定を省略するには、DFY 注文を使用してください。)
セットアップの流れ
- インフラの規模を決めます(上記の計算式を参照)。
- 最速の方法 — 事前にウォームアップ済みの受信箱を手配します(ドメインや DNS の手動設定、ウォームアップを省略できます)。
→ POST
/v1/instantly/dfy-email-account-orders· 無料 ·instantly.dfy_orders.create- まず、利用可能なものを確認します。
→ POST
/v1/instantly/dfy-email-account-orders/domains/pre-warmed-up-list· 無料 ·instantly.dfy_orders.domains_prewarmed→ POST/v1/instantly/dfy-email-account-orders/domains/check· 無料 ·instantly.dfy_orders.domains_check
- まず、利用可能なものを確認します。
→ POST
- BYO の方法 — 独自のメールボックスを接続し、送信開始の 2~3 週間前にウォームアップを有効にします。
→ POST
/v1/instantly/accounts· 無料 ·instantly.accounts.create→ POST/v1/instantly/accounts/warmup/enable· 無料 ·instantly.accounts.warmup_enable - 開始前に、健全性を確認します。
→ POST
/v1/instantly/accounts/warmup-analytics· 無料 ·instantly.accounts.warmup_analytics→ POST/v1/instantly/accounts/test/vitals· 無料 ·instantly.accounts.test_vitals - 送信を開始し(ランプアップ)、毎日モニタリングします。
→ GET
/v1/instantly/accounts/analytics/daily· 無料 ·instantly.accounts.analytics_daily
ウォームアップとランプアップ
ウォームアップ:第 1 週は基礎固め(キャンペーンなし) · 第 2 週は準備(キャンペーンなし) · 第 3 週は準備完了(健全性 70% 以上、理想は 90% 以上)。送信開始時のランプアップ/メールボックス:第 1 週 G 10~15 / MS 5~10 → 第 2~3 週 G 15~20 / MS 10~12 → 第 4 週以降 G 20~25 / MS 12~15。
健全な指標
開封率 50% 以上 · 返信率 2% 以上 · バウンス率 3% 未満(目標は 2% 未満) · スパム率 0.1% 未満 · 到達率 95% 超。 バウンス率が上昇したり、バイタル指標が低下したりした場合は、そのメールボックスを一時停止し、再開前にウォームアップ分析を再確認してください。