IMAP/SMTP メールツール

IMAP プロトコル経由でメールを読み取り、検索、管理します。SMTP 経由でメールを送信します。Gmail、Outlook、163.com、vip.163.com、126.com、vip.126.com、188.com、vip.188.com、および標準 IMAP/SMTP サーバーに対応しています。

重要: 設定は事前構成済みです

.env 設定ファイルは LobsterAI Settings (邮箱设置) によって自動管理されます。ユーザーに .env の作成または編集を依頼しないでください — コマンドを直接実行してください。 認証情報が間違っている場合、スクリプトは明確なエラーメッセージを返します。その場合のみユーザーに邮箱设置を確認するよう通知してください。

.env ファイルはこのスキルのディレクトリ (SKILL.md ファイルと同じフォルダ) にあります。スクリプトはキャッシュされたパスを通じて自動的に読み込みます。

設定リファレンス

スキルフォルダに .env を作成または環境変数を設定します:

# IMAP 設定 (メール受信)
IMAP_HOST=imap.gmail.com          # サーバーホスト名
IMAP_PORT=993                     # サーバーポート
IMAP_USER=your@email.com
IMAP_PASS=your_password
IMAP_TLS=true                     # TLS/SSL 接続を使用
IMAP_REJECT_UNAUTHORIZED=true     # 自己署名証明書の場合は false に設定
IMAP_MAILBOX=INBOX                # デフォルトメールボックス

# SMTP 設定 (メール送信)
SMTP_HOST=smtp.gmail.com          # SMTP サーバーホスト名
SMTP_PORT=587                     # SMTP ポート (STARTTLS の場合は 587、SSL の場合は 465)
SMTP_SECURE=false                 # SSL (465) の場合は true、STARTTLS (587) の場合は false
SMTP_USER=your@gmail.com          # メールアドレス
SMTP_PASS=your_password           # パスワードまたはアプリパスワード
SMTP_FROM=your@gmail.com          # デフォルト送信者メール (オプション)
SMTP_REJECT_UNAUTHORIZED=true     # 自己署名証明書の場合は false に設定

一般的なメールサーバー

プロバイダー	IMAP ホスト	IMAP ポート	SMTP ホスト	SMTP ポート
163.com	imap.163.com	993	smtp.163.com	465
vip.163.com	imap.vip.163.com	993	smtp.vip.163.com	465
126.com	imap.126.com	993	smtp.126.com	465
vip.126.com	imap.vip.126.com	993	smtp.vip.126.com	465
188.com	imap.188.com	993	smtp.188.com	465
vip.188.com	imap.vip.188.com	993	smtp.vip.188.com	465
yeah.net	imap.yeah.net	993	smtp.yeah.net	465
Gmail	imap.gmail.com	993	smtp.gmail.com	587
Outlook	outlook.office365.com	993	smtp.office365.com	587
QQ Mail	imap.qq.com	993	smtp.qq.com	587

163.com の重要な注意:

• アカウントパスワードではなく 授权码 (認可コード) を使用してください
• まず Web 設定で IMAP/SMTP を有効にしてください

IMAP コマンド (メール受信)

check

新着メール / 未読メールをチェックします。

node scripts/imap.js check [--limit 10] [--mailbox INBOX] [--recent 2h]

オプション:

• --limit <n>: 最大結果数 (デフォルト: 10)
• --mailbox <name>: チェック対象のメールボックス (デフォルト: INBOX)
• --recent <time>: 直近 X 時間のメールのみを表示 (例: 30m、2h、7d)

fetch

UID でメールの完全なコンテンツを取得します。

node scripts/imap.js fetch <uid> [--mailbox INBOX]

download

メールからすべての添付ファイルをダウンロードするか、特定の添付ファイルをダウンロードします。

node scripts/imap.js download <uid> [--mailbox INBOX] [--dir <path>] [--file <filename>]

オプション:

• --mailbox <name>: メールボックス (デフォルト: INBOX)
• --dir <path>: 出力ディレクトリ (デフォルト: 現在のディレクトリ)
• --file <filename>: 指定された添付ファイルのみをダウンロード (デフォルト: すべてをダウンロード)

search

フィルター付きでメールを検索します。

node scripts/imap.js search [options]

オプション:
  --unseen           未読メッセージのみ
  --seen             読込済みメッセージのみ
  --from <email>     差出人アドレスを含む
  --subject <text>   件名を含む
  --recent <time>    直近 X 時間 (例: 30m、2h、7d)
  --since <date>     日付以降 (YYYY-MM-DD)
  --before <date>    日付以前 (YYYY-MM-DD)
  --limit <n>        最大結果数 (デフォルト: 20)
  --mailbox <name>   検索対象のメールボックス (デフォルト: INBOX)

mark-read / mark-unread

メッセージを既読または未読としてマークします。

node scripts/imap.js mark-read <uid> [uid2 uid3...]
node scripts/imap.js mark-unread <uid> [uid2 uid3...]

list-mailboxes

利用可能なすべてのメールボックス/フォルダをリストアップします。

node scripts/imap.js list-mailboxes

SMTP コマンド (メール送信)

send

SMTP 経由でメールを送信します。

node scripts/smtp.js send --to <email> --subject <text> [options]

必須:

• --to <email>: 受信者 (複数の場合はカンマ区切り)
• --subject <text>: メール件名、または --subject-file <file>

オプション:

• --body <text>: プレーンテキスト本文
• --html: 本文を HTML として送信
• --body-file <file>: ファイルから本文を読み込む
• --html-file <file>: ファイルから HTML を読み込む
• --cc <email>: CC 受信者
• --bcc <email>: BCC 受信者
• --attach <file>: 添付ファイル (カンマ区切り)
• --from <email>: デフォルト送信者を上書き

例:

# シンプルなテキストメール
node scripts/smtp.js send --to recipient@example.com --subject "Hello" --body "World"

# HTML メール
node scripts/smtp.js send --to recipient@example.com --subject "Newsletter" --html --body "<h1>Welcome</h1>"

# 添付ファイル付きメール
node scripts/smtp.js send --to recipient@example.com --subject "Report" --body "Please find attached" --attach report.pdf

# 複数の受信者
node scripts/smtp.js send --to "a@example.com,b@example.com" --cc "c@example.com" --subject "Update" --body "Team update"

test

テストメールを自分自身に送信することで SMTP 接続をテストします。

node scripts/smtp.js test

依存関係

npm install

セキュリティに関する注意事項

• .env に認証情報を保存してください (.gitignore に追加)
• Gmail の場合: 2FA が有効な場合はアプリパスワードを使用してください
• 163.com の場合: アカウントパスワードではなく授权码 (認可コード) を使用してください

トラブルシューティング

接続タイムアウト:

• サーバーが実行中でアクセス可能であることを確認してください
• ホスト/ポートの設定を確認してください

認証失敗:

• ユーザー名を確認してください (通常はメールアドレス全体)
• パスワードが正しいことを確認してください
• 163.com の場合: アカウントパスワードではなく授权码を使用してください
• Gmail の場合: 2FA が有効な場合はアプリパスワードを使用してください

TLS/SSL エラー:

• IMAP_TLS/SMTP_SECURE 設定がサーバーの要件と一致していることを確認してください
• 自己署名証明書の場合: IMAP_REJECT_UNAUTHORIZED=false または SMTP_REJECT_UNAUTHORIZED=false に設定してください