メール送信(Python を使用)

1. エグゼクティブサマリー

Python で,SMTP サーバーを使用してメールを送信する方法を説明する。

Python の標準ライブラリ(smtplibemail.mime.textemail.utils)を使用し,SMTP サーバー経由でメールを送信する。単一宛先への送信,複数宛先への一括送信,CC・BCC を指定した送信を扱う。

2. 前準備(必要ソフトウェアの入手)

ここでは、最低限の事前準備について説明する。機械学習や深層学習を行う場合は、NVIDIA CUDA、Visual Studio、Cursorなどを追加でインストールすると便利である。これらについては別ページ https://www.kkaneko.jp/cc/dev/aiassist.htmlで詳しく解説しているので、必要に応じて参照してください。

Python 3.12 のインストール(Windows 上) [クリックして展開]

以下のいずれかの方法で Python 3.12 をインストールする。Python がインストール済みの場合、この手順は不要である。

方法1:winget によるインストール

管理者権限コマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。

winget install --scope machine --id Python.Python.3.12 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_pip=1 Include_test=0 Include_launcher=1 InstallLauncherAllUsers=1"

--scope machine を指定することで、システム全体(全ユーザー向け)にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。

方法2:インストーラーによるインストール

  1. Python 公式サイト(https://www.python.org/downloads/)にアクセスし、「Download Python 3.x.x」ボタンから Windows 用インストーラーをダウンロードする。
  2. ダウンロードしたインストーラーを実行する。
  3. 初期画面の下部に表示される「Add python.exe to PATH」に必ずチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
  4. 「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号(例:Python 3.12.x)が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

AIエディタ Windsurf のインストール(Windows 上) [クリックして展開]

Pythonプログラムの編集・実行には、AIエディタの利用を推奨する。ここでは、Windsurfのインストールを説明する。Windsurf がインストール済みの場合、この手順は不要である。

管理者権限コマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。

winget install --scope machine --id Codeium.Windsurf -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --custom "/SP- /SUPPRESSMSGBOXES /NORESTART /CLOSEAPPLICATIONS /DIR=""C:\Program Files\Windsurf"" /MERGETASKS=!runcode,addtopath,associatewithfiles,!desktopicon"
powershell -Command "$env:Path=[System.Environment]::GetEnvironmentVariable('Path','Machine')+';'+[System.Environment]::GetEnvironmentVariable('Path','User'); windsurf --install-extension MS-CEINTL.vscode-language-pack-ja --force; windsurf --install-extension ms-python.python --force; windsurf --install-extension Codeium.windsurfPyright --force"

--scope machine を指定することで、システム全体(全ユーザー向け)にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。

関連する外部ページ

Windsurf の公式ページ: https://windsurf.com/

本プログラムが使用する smtplibemail.mime.textemail.utils はすべて Python 標準ライブラリであるため,追加のライブラリインストールは不要である。

3. 実行のための準備とその確認手順(Windows 前提)

3.1 プログラムファイルの準備

第5章のソースコードをテキストエディタ(メモ帳,Windsurf 等)に貼り付け,hoge.py として保存する(文字コード:UTF-8)。

3.2 実行コマンド

コマンドプロンプトでファイルの保存先ディレクトリに移動し,以下を実行する。

python hoge.py

3.3 動作確認チェックリスト

確認項目期待される結果
SMTP サーバーへの接続指定した SMTP サーバー(ポート587)に接続し,STARTTLS で暗号化通信が確立される
認証指定したユーザー名・パスワードで SMTP サーバーへのログインが成功する
メール送信(単一宛先)指定した宛先にメールが送信され,件名・本文・送信日時が正しく設定されている
メール送信(複数宛先・CC・BCC)複数宛先への一括送信,CC・BCC を指定した送信がそれぞれ正しく動作する

4. 概要・使い方・実行上の注意

本プログラムは,smtplib を使用して SMTP サーバー経由でメールを送信する。STARTTLS による暗号化通信を行い,ユーザー名とパスワードで認証したうえで送信する。

使用前に,以下の変数を利用環境に合わせて書き換える。

変数名設定内容
UNAMESMTP 認証用のユーザー名(メールアドレス)
PASSWORDSMTP 認証用のパスワード
SMTP_SERVERSMTP サーバーのホスト名
FROM_ADDR送信元メールアドレス
TO_ADDR / TO_ADDRS宛先メールアドレス(単一は文字列,複数はリスト)
CC_ADDRSCC 宛先メールアドレスのリスト
BCC_ADDRSBCC 宛先メールアドレスのリスト
SUBJECTメールの件名
BODYメールの本文

3種類の送信方法を提供する。

単一宛先への送信:mysendmail 関数を使用する。MIMEText でメッセージを構築し,Subject,From,To,Date の各ヘッダを設定して送信する。

複数宛先への一括送信:mysendmail_multiple 関数を使用する。宛先をリストで指定することで,同一内容のメールを複数の宛先へ一括送信できる。sendmail メソッドの第2引数にリストを渡すと,リスト内の全アドレスに送信される。

CC・BCC を指定した送信:mysendmail_cc_bcc 関数を使用する。CC(Carbon Copy)はヘッダに宛先として表示される。BCC(Blind Carbon Copy)はヘッダに記載されないため,他の受信者からは見えない。sendmail メソッドには,To・CC・BCC を含む全受信者のリストを渡す。

ソースコードは第5章に掲載する。

5. ソースコード

5.1 単一宛先への送信

import smtplib
from email.mime.text import MIMEText
from email.utils import formatdate

def mysendmail(uname, password, smtp_server, from_addr, to_addr, subject, body):
    msg = MIMEText(body)
    msg['Subject'] = subject
    msg['From'] = from_addr
    msg['To'] = to_addr
    msg['Date'] = formatdate()
    with smtplib.SMTP(smtp_server, 587) as sv:
        sv.starttls()
        sv.login(uname, password)
        sv.sendmail(from_addr, to_addr, msg.as_string())

UNAME = "user@hoge.com"
PASSWORD = "pass"
SMTP_SERVER = "mailsv.hoge.com"
FROM_ADDR = "user@hoge.com"
TO_ADDR = "other@hoge.com"
SUBJECT = "タイトル"
BODY = "メッセージ本文"

if __name__ == '__main__':
    mysendmail(UNAME, PASSWORD, SMTP_SERVER, FROM_ADDR, TO_ADDR, SUBJECT, BODY)

5.2 複数の宛先への一括送信

import smtplib
from email.mime.text import MIMEText
from email.utils import formatdate

def mysendmail_multiple(uname, password, smtp_server, from_addr, to_addrs, subject, body):
    msg = MIMEText(body)
    msg['Subject'] = subject
    msg['From'] = from_addr
    msg['To'] = ", ".join(to_addrs)
    msg['Date'] = formatdate()
    with smtplib.SMTP(smtp_server, 587) as sv:
        sv.starttls()
        sv.login(uname, password)
        sv.sendmail(from_addr, to_addrs, msg.as_string())

UNAME = "user@hoge.com"
PASSWORD = "pass"
SMTP_SERVER = "mailsv.hoge.com"
FROM_ADDR = "user@hoge.com"
TO_ADDRS = ["other1@hoge.com", "other2@hoge.com", "other3@hoge.com"]
SUBJECT = "タイトル"
BODY = "メッセージ本文"

if __name__ == '__main__':
    mysendmail_multiple(UNAME, PASSWORD, SMTP_SERVER, FROM_ADDR, TO_ADDRS, SUBJECT, BODY)

5.3 CC・BCC を指定した送信

import smtplib
from email.mime.text import MIMEText
from email.utils import formatdate

def mysendmail_cc_bcc(uname, password, smtp_server, from_addr, to_addr, cc_addrs, bcc_addrs, subject, body):
    msg = MIMEText(body)
    msg['Subject'] = subject
    msg['From'] = from_addr
    msg['To'] = to_addr
    msg['Cc'] = ", ".join(cc_addrs)
    msg['Date'] = formatdate()
    all_recipients = [to_addr] + cc_addrs + bcc_addrs
    with smtplib.SMTP(smtp_server, 587) as sv:
        sv.starttls()
        sv.login(uname, password)
        sv.sendmail(from_addr, all_recipients, msg.as_string())

UNAME = "user@hoge.com"
PASSWORD = "pass"
SMTP_SERVER = "mailsv.hoge.com"
FROM_ADDR = "user@hoge.com"
TO_ADDR = "other@hoge.com"
CC_ADDRS = ["cc1@hoge.com", "cc2@hoge.com"]
BCC_ADDRS = ["bcc1@hoge.com"]
SUBJECT = "タイトル"
BODY = "メッセージ本文"

if __name__ == '__main__':
    mysendmail_cc_bcc(UNAME, PASSWORD, SMTP_SERVER, FROM_ADDR, TO_ADDR, CC_ADDRS, BCC_ADDRS, SUBJECT, BODY)

6. まとめ

smtplib による SMTP 通信
標準ライブラリ smtplib を使用し,SMTP サーバー(ポート587)に接続する。STARTTLS で暗号化通信を行い,with 文で接続の終了処理を自動化する。

MIMEText によるメッセージ構築
MIMEText でメールメッセージを構築し,Subject,From,To,Date の各ヘッダを設定する。as_string() で文字列に変換して送信する。

複数宛先への一括送信
宛先をリストで指定し,sendmail メソッドの第2引数にリストを渡すことで,同一内容のメールを複数の宛先へ一括送信する。

CC・BCC の指定
CC はヘッダに宛先として表示される。BCC はヘッダに記載されないため,他の受信者からは見えない。sendmail メソッドには To・CC・BCC を含む全受信者のリストを渡す。

SMTP 認証
SMTP サーバーへの接続後,ユーザー名とパスワードで login メソッドにより認証を行い,メールを送信する。