email について
emailはStableEmailを使ってメール送信と受信箱管理を行うスキルです。共有アドレス、有料受信箱、カスタムサブドメインに対応し、転送やAPI経由のメール取得もできます。
主な機能
- 01テキスト、HTML、添付ファイル付きメールの送信
- 02転送用受信箱の購入と管理
- 03メールの保持、一覧、読み取り、削除
- 04カスタムサブドメインからの送信
- 05サブドメイン受信箱と全件転送の設定
活用シーン
- 01アプリからのトランザクションメール送信
- 02プログラムで受信メールにアクセス
- 03チーム用のカスタムサブドメインメール設定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ merit-systems/ agentcash-skills --skill emailインストール後、Claude Code で/emailを入力して読み込まれたか確認します。
同梱ファイルrules/getting-started.md
詳細
StableEmail でメールを送信する
https://stableemail.dev で、x402 決済を利用してメールを送信し、受信トレイを管理し、カスタムサブドメインを運用できます。
セットアップ
インストールとウォレットのセットアップについては、rules/getting-started.md を参照してください。
クイックリファレンス
| タスク | エンドポイント | 価格 |
|---|---|---|
| メールを送信(共有) | https://stableemail.dev/api/send | $0.02 |
| サブドメインを購入 | https://stableemail.dev/api/subdomain/buy | $5.00 |
| サブドメインから送信 | https://stableemail.dev/api/subdomain/send | $0.005 |
| 受信トレイを購入 | https://stableemail.dev/api/inbox/buy | $1.00 |
| 受信トレイから送信 | https://stableemail.dev/api/inbox/send | $0.005 |
| 受信トレイをチャージ(30日) | https://stableemail.dev/api/inbox/topup | $1.00 |
| 受信トレイをチャージ(90日) | https://stableemail.dev/api/inbox/topup/quarter | $2.50 |
| 受信トレイをチャージ(365日) | https://stableemail.dev/api/inbox/topup/year | $8.00 |
| 受信トレイのメッセージ一覧を取得 | https://stableemail.dev/api/inbox/messages | $0.001 |
| 受信トレイのメッセージを読む | https://stableemail.dev/api/inbox/messages/read | $0.001 |
| サブドメインの受信トレイを作成 | https://stableemail.dev/api/subdomain/inbox/create | $0.25 |
| サブドメインのメッセージ一覧を取得 | https://stableemail.dev/api/subdomain/inbox/messages | $0.001 |
| サブドメインのメッセージを読む | https://stableemail.dev/api/subdomain/inbox/messages/read | $0.001 |
無料の管理エンドポイント
| タスク | エンドポイント |
|---|---|
| サブドメインのステータス | GET https://stableemail.dev/api/subdomain/status?subdomain=name |
| サブドメインを更新 | POST https://stableemail.dev/api/subdomain/update |
| 署名者を管理 | POST https://stableemail.dev/api/subdomain/signers |
| 受信トレイのステータス | GET https://stableemail.dev/api/inbox/status?username=name |
| 受信トレイ一覧を取得 | POST https://stableemail.dev/api/inbox/list |
| 受信トレイを更新 | POST https://stableemail.dev/api/inbox/update |
| 受信トレイを解約 | POST https://stableemail.dev/api/inbox/cancel |
| メッセージを削除 | POST https://stableemail.dev/api/inbox/messages/delete |
| サブドメインの受信トレイ一覧を取得 | POST https://stableemail.dev/api/subdomain/inbox/list |
| サブドメインの受信トレイを削除 | POST https://stableemail.dev/api/subdomain/inbox/delete |
| サブドメインの受信トレイを更新 | POST https://stableemail.dev/api/subdomain/inbox/update |
| サブドメインのメッセージを削除 | POST https://stableemail.dev/api/subdomain/inbox/messages/delete |
無料のエンドポイントでは SIWX ウォレット認証を使用します(npx agentcash@latest fetch が自動的に処理します)。
メールを送信する
共有アドレス [email protected] から送信します。
npx agentcash@latest fetch https://stableemail.dev/api/send -m POST -b '{
"to": ["[email protected]"],
"subject": "Hello from x402",
"html": "<h1>Hi!</h1><p>This email was sent via x402 payments.</p>",
"text": "Hi! This email was sent via x402 payments.",
"replyTo": "[email protected]"
}'
パラメーター:
to— 宛先メールアドレスの配列(必須)subject— メールの件名(必須)htmlおよび/またはtext— メール本文(少なくとも一方が必須)replyTo— 返信先アドレス(任意ですが、推奨)attachments—{content, contentType, filename}の配列(任意。最大 5 件、Base64 エンコード、各約 3.75MB まで)
添付ファイルの例:
{
"attachments": [{
"content": "base64-encoded-content...",
"contentType": "application/pdf",
"filename": "report.pdf"
}]
}
カレンダーの招待には、contentType: "text/calendar; method=REQUEST" を使用してください。
転送用受信トレイ
月額 $1 で [email protected] を購入できます。メールは実際のアドレスに転送され、プログラムからアクセスできるように保持することもできます。
受信トレイを購入する
npx agentcash@latest fetch https://stableemail.dev/api/inbox/buy -m POST -b '{
"username": "alice",
"forwardTo": "[email protected]"
}'
プログラムからのみ利用するメールボックスにする場合は、forwardTo を省略してください(retainMessages が自動的に有効になります)。
受信トレイから送信する
npx agentcash@latest fetch https://stableemail.dev/api/inbox/send -m POST -b '{
"username": "alice",
"to": ["[email protected]"],
"subject": "Hello",
"html": "<p>Hi Bob</p>",
"text": "Hi Bob"
}'
受信トレイをチャージする
npx agentcash@latest fetch https://stableemail.dev/api/inbox/topup -m POST -b '{"username": "alice"}'
誰でも任意の受信トレイをチャージできます。チャージ期間は加算されます。まとめ買い割引:90日/$2.50(17%割引)、365日/$8(34%割引)。
解約と返金
npx agentcash@latest fetch https://stableemail.dev/api/inbox/cancel -m POST -b '{"username": "alice"}'
按分された USDC の返金がオンチェーンで自動的に行われます。
受信トレイのメッセージを読む
メッセージの保持を有効にしてから、プログラムからメッセージを読み取ります。
メッセージの保持を有効にする
npx agentcash@latest fetch https://stableemail.dev/api/inbox/update -m POST -b '{"username": "alice", "retainMessages": true}'
メッセージ一覧を取得する
npx agentcash@latest fetch https://stableemail.dev/api/inbox/messages -m POST -b '{"username": "alice", "limit": 20}'
メッセージを読む
npx agentcash@latest fetch https://stableemail.dev/api/inbox/messages/read -m POST -b '{"messageId": "msg_abc123"}'
from、to、subject、date、text、html、添付ファイルのダウンロード URL を含む完全なメッセージを返します(URL の有効期限は 1 時間です)。メッセージの内容と添付ファイルは 90 日間保持されます。
カスタムサブドメイン
yourname.stableemail.dev を一度限りの $5 で購入できます。サブドメイン上の任意のアドレスから、メール 1 通あたり $0.005 で送信できます。
サブドメインを購入する
npx agentcash@latest fetch https://stableemail.dev/api/subdomain/buy -m POST -b '{"subdomain": "yourname"}'
ルール:3~30 文字、小文字の英数字とハイフンを使用できます。DNS の検証には約 5 分かかります。
サブドメインから送信する
npx agentcash@latest fetch https://stableemail.dev/api/subdomain/send -m POST -b '{
"from": "[email protected]",
"to": ["[email protected]"],
"subject": "Your order confirmation",
"html": "<p>Thank you for your order!</p>"
}'
サブドメインの受信トレイを作成する
サブドメイン上にアドレスごとの受信トレイを作成できます(1 つあたり $0.25、受信トレイは最大 100 個、各受信トレイにメッセージ 500 件)。
npx agentcash@latest fetch https://stableemail.dev/api/subdomain/inbox/create -m POST -b '{
"subdomain": "yourname",
"localPart": "support",
"forwardTo": "[email protected]"
}'
キャッチオール転送
サブドメイン上の一致しないアドレスをすべて転送します。
npx agentcash@latest fetch https://stableemail.dev/api/subdomain/update -m POST -b '{"subdomain": "yourname", "catchAllForwardTo": "[email protected]"}'
認証済み署名者を管理する
他のウォレットからサブドメインを使用して送信できるようにします。
npx agentcash@latest fetch https://stableemail.dev/api/subdomain/signers -m POST -b '{"action": "add", "subdomain": "yourname", "walletAddress": "0x..."}'
メール内の画像
StableUpload または AgentUpload に画像をホストし、HTML で参照します。
<img src="https://f.stableupload.dev/abc/photo.png" alt="Photo" />
ほとんどのメールクライアントはデータ URI を削除します。必ずホスト済み URL を使用してください。
ワークフロー
すばやく送信する
- (任意)残高を確認します:
npx agentcash@latest balance -
/api/send経由でメールを送信します - messageId で配信を確認します
プロフェッショナルなメールを設定する
- サブドメインを購入します($5)
- DNS の検証を待ちます(約 5 分)
- チームメンバー用の受信トレイを作成します(1 つあたり $0.25)
- キャッチオール転送を設定します
- カスタムアドレスから送信します(1 通あたり $0.005)
プログラムによるメールボックス
- forwardTo を指定せずに受信トレイを購入します($1)
- メッセージは自動的に保持されます(90 日間)
- API 経由でメッセージを一覧表示し、読み取ります(1 件あたり $0.001)
- 処理後にメッセージを削除します(無料)
費用の見積もり
| タスク | 費用 |
|---|---|
| メールを 1 通送信(共有) | $0.02 |
| メールを 1 通送信(サブドメイン/受信トレイ) | $0.005 |
| 受信トレイを購入(30 日間) | $1.00 |
| 受信トレイを購入(1 年間) | $1.00 + $8.00 = $9.00 |
| サブドメイン + 受信トレイ 5 個を購入 | $5.00 + $1.25 = $6.25 |
| メッセージを 100 件読む | $0.10 |