Python×Excelでメール一括送信ツールを自作する【第1回】pandasでExcel名簿（氏名・アドレス・会社名）を読み込む

NINJIN Mail制作記 第1回

Python×Excelでメール一括送信ツールを自作する｜第1回：pandasでExcel名簿を読み込む

こんにちは、ニンジンです🥕

この記事は、Excelの名簿（氏名・アドレス・会社名）を読み込んで、Outlookから1件ずつ差し込んだメールを一括送信するツール「NINJIN Mail」を、全3回で自作していくシリーズの第1回です。今回は、ツールの設計方針を整理したうえで、pandas の read_excel() と df.iterrows() を使って、Excel名簿を1行ずつ読み込む基本処理を実装します。

プログラミングの経験が浅くても追えるよう、必要なライブラリの pip install 手順から、実行して分かった課題（次回以降で解決します）まで、順を追って解説します。

開発のきっかけ

「Pythonで便利なソフトを作ったら、どのくらい使ってもらえるだろうか」と考えていたとき、営業部から相談を受けました。

展示会のあとに、お礼メールを一人ずつ送るのがかなりの手間になっている

この作業はパターン化しやすく、Pythonでの自動化に向いています。これが、メール一括送信ソフト「NINJIN Mail」を作り始めたきっかけです。

開発の方向性を整理する｜誰のための、どんなツールか

最初に、「誰に向けて」「何を実現するか」を整理しました。複雑な機能を詰め込むより、誰でも直感的に操作できることを優先しています。

機能要件

• 想定ユーザー：展示会のお礼メールや、セミナーの招待メールを送る営業担当者
• 名簿の読み込み：Excelファイルから氏名・アドレス・会社名を取得する
• 一括送信：読み込んだ情報を本文に差し込みながら送信する
• 送信記録：誰に送信したかをログとして残す
• 想定シーン：展示会のお礼メール、セミナーの招待メールなど

実装方針

要件を実現するための方針として、以下の5点を決めました。

1. 名簿は任意のフォルダに置かれたExcelファイルから読み込む（第2回）
2. 件名と本文はGUIアプリケーション上で入力する（第3回）
3. 送信処理にはOutlookのAPIを利用する（第3回）
4. 送信結果は名簿のExcelファイルに追記して記録する
5. 使い勝手を高めるため、直前に使用したExcelファイルの場所を記憶する（第2回）

必要なライブラリ｜pandas・openpyxl・pywin32ほか

設計を実現するために必要なライブラリを整理すると、以下のようになります。

補足：pywin32 は64bit版のWindows・Pythonでも問題なく動作します。ライブラリ側で自動調整されるため、利用する側で特別な対応は不要です。

ライブラリのインストール方法

インストールしていない場合は、コマンドプロンプトまたはWindows PowerShellで以下を実行してください。
まとめて入れる場合は pip install pandas openpyxl pywin32 の1行でも可能です。

▲ pip install pandas の実行例

pip install pandas

インストール中にNumPyのWARNINGが出ることがありますが、最後に「Successfully installed」と表示されていれば問題ありません。

▲ pip install openpyxl の実行例

pip install openpyxl

pandas が .xlsx を読み書きするときに内部で使うライブラリです。

▲ pip install pywin32 の実行例

pip install pywin32

第3回でOutlookを操作するときに使います。第1回の名簿読み込みだけなら pandas と openpyxl があれば動きます。

pandasでExcelの顧客データを読み込む【サンプルコード】

ここでは、pandas.read_excel() でExcelを読み込み、df.iterrows() で1行ずつデータを取り出す基本処理を実装します。

▲ 名簿Excel「client_list.xlsx」（氏名・アドレス・会社名の3列）

• 名簿用のExcelファイル名を client_list.xlsx とします。
• この段階では、client_list.xlsx をPythonコード（mail-soft-test01.py）と同じフォルダに置いてください。

サンプルコード：mail-soft-test01.py（※ VS Codeなどのエディターで実行してください）

import pandas as pd

def load_client_list(file_path):
    try:
        # Excelファイルを読み込む
        df = pd.read_excel(file_path)
        
        # 1行ずつ処理して読み込みを確認
        for index, row in df.iterrows():
            name = row['氏名']
            email = row['アドレス']
            company = row['会社名']
            
            print(f"読み込み中: {company} {name} 様 ({email})")
            
    except Exception as e:
        print(f"エラーが発生しました: {e}")

# 実行（同じフォルダにExcelがある前提）
load_client_list('client_list.xlsx')

実行結果と分かった課題

▲ ターミナルに名簿のデータが1行ずつ出力されれば成功

ターミナルにExcelのデータが「読み込み中: 〇〇株式会社 山田 太郎 様 (…)」のように出力されれば成功です。

読み込みには成功しましたが、実用的なツールにするには、この段階で以下の課題が残っています。いずれも第2回以降で解決していきます。

まとめ｜次回はファイル選択画面を実装する

第1回では、ツールの設計方針を整理し、pandas の read_excel() と df.iterrows() でExcel名簿を1行ずつ読み込む基本処理を実装しました。ただし現状はまだ「プログラム」の段階で、ツールとしての使いやすさには課題が残っています。

次回（第2回）は、Windowsで見慣れた「ファイルを開く」画面を tkinter の filedialog で実装し、さらに「直前に選んだフォルダを記憶する」仕組みを config.json で追加して、操作性を改善します。

PR

▲ 完成版 NINJIN Mail（customtkinterでUIを刷新）

今回紹介したコードを含む開発の詳細は、noteでフルコード付きで販売しています。環境構築なしですぐ使えるパッケージ版もあります。コードに関心がある方も、コードは難しそうと感じる方も、内容だけでも覗いてみてください。

👉 noteでチェックする

次に読む記事

よくある質問（pandas・read_excel・Excel名簿の読み込み）