メインコンテンツへスキップ
見出し画像

定型作業を自動化!Puppeteerで作るタスク自動化システム

    はじめに

    毎週決まった作業を手動で行うのは面倒ですよね。そんな私も毎週金曜日に翌週の日ごとの当番をランダムに決める作業を今まで手動で行っていました。
    簡単な作業ではありますが手動で行うのは面倒くさいと思ったので、Puppeteerを使って自動化する処理を実装してみました!この記事では、実際のコードとともに、定型作業自動化のポイントを解説していきます。

    自動化する作業の整理

    1. ブラウザでサイト(https://jp.piliapp.com/random/list/)にアクセス

    2. チームメンバーをテキストエリアに入力

    3. シャッフルボタンをクリック

    4. 結果を確認して曜日に割り当て

    5. デスクトップ通知で結果を表示し、クリップボードに自動コピー

    この一連の流れを自動化していきます!

    技術構成

    今回使用する主要な技術スタックは以下となります。

    • Node.js: JavaScript実行環境

    • Puppeteer: ブラウザ自動化ライブラリ

    • node-notifier: デスクトップ通知

    • PowerShell: Windowsでのクリップボード操作

    ファイル構成

    プロジェクトのディレクトリ構造は以下となります。

    
    C:\work\Techblog
    ├── index.js              # メインの処理ファイル
    ├── package.json          # プロジェクト設定とライブラリ情報
    ├── package-lock.json     # ライブラリバージョン固定
    ├── logs\                 # ログファイル格納フォルダ
    └── node_modules\         # インストールされたライブラリ

    メインロジックはindex.jsに集約されています。ログは自動的にlogsフォルダに日付別で保存されるため、後から処理の履歴を確認することも可能となっています。

    実装手順

    それでは実際に処理を作成していきましょう!

    (1) 実行環境の準備

    まずは開発環境を準備します。 このプロジェクトを実行するには、Node.jsのインストールが必要です。Node.js公式サイトからダウンロードしてインストールしてください。 インストール後、コマンドプロンプトで以下のコマンドを実行して、正しくインストールされていることを確認してみましょう!

    node --version

    正しくインストールされている場合、バージョン情報が表示されます。

    (2) index.jsとpackage.jsonの作成

    ファイル構成を参考に、設定ファイル(package.json)とメインファイル(index.js)を作成していきます。

    先ずは、プロジェクトの設定ファイル(package.json)を作成します

    {
      // プロジェクト基本情報
      "name": "weekly-shuffle-automation",
      "version": "1.0.0", 
      "description": "毎週金曜日に自動でメンバーをシャッフルして曜日に割り当てるツール",
      "main": "index.js",
      
      // 実行可能なスクリプトコマンド
      "scripts": {
        "start": "node index.js",                    // 通常実行: npm start
        "test": "node test.js",                     // テスト実行: npm test  
        "install-service": "node install-service.js" // サービス登録: npm run install-service
      },
      
      // npmで検索する際のキーワード
      "keywords": [
        "puppeteer",    // ブラウザ自動化
        "automation",   // 自動化ツール
        "windows",      // Windows環境対応
        "scheduling",   // スケジューリング
        "notification"  // デスクトップ通知
      ],
      
      "author": "Your Name",  // 作成者名(任意で変更してください)
      "license": "MIT",       // MITライセンス(オープンソース)
      
      // 本番環境で必要なライブラリ(実行時に必要)
      "dependencies": {
        "puppeteer": "^24.10.2",     // ヘッドレスブラウザ操作ライブラリ
        "node-notifier": "^10.0.1"   // デスクトップ通知ライブラリ
      },
      
      // 開発環境でのみ必要なライブラリ(実行ファイル化用)
      "devDependencies": {
        "pkg": "^5.8.1"  // Node.jsアプリを実行ファイル(.exe)に変換するツール
      },
      
      // Node.jsの最低必要バージョン
      "engines": {
        "node": ">=14.0.0"  // Node.js 14.0.0以上が必要
      },
      
      // pkg設定(実行ファイル化の設定)
      "pkg": {
        "scripts": [
          "index.js"  // 実行ファイルに含めるスクリプト
        ],
        "assets": [
          // Puppeteerが使用するChromiumブラウザを実行ファイルに含める
          "node_modules/puppeteer/.local-chromium/**/*"
        ],
        "targets": [
          "node18-win-x64"  // Windows 64bit版のNode.js 18で実行ファイルを作成
        ],
        "outputPath": "dist"  // 実行ファイルの出力先ディレクトリ
      }
    }

    ※ JSONファイルは本来コメントをサポートしていないため、実際のファイルではコメント部分(//以降)は削除してください。上記は説明用の表記です。

    次にメインファイル(index.js)の作成を行います。

    //モジュールのインポート
    const puppeteer = require("puppeteer");
    const notifier = require("node-notifier");
    const fs = require("fs").promises;
    const path = require("path");
    
    /**
     * 設定
     * 情報を外部化することでメンテナンス性を向上しています
     */
    const CONFIG = {
      members: ["山田さん", "田中さん", "佐藤さん", "鈴木さん", "中田さん"],
      shuffleUrl: "https://jp.piliapp.com/random/list/",
      logDir: "./logs",
    };
    
    const WEEKDAYS = ["月曜日", "火曜日", "水曜日", "木曜日", "金曜日"];
    
    /**
     * ログディレクトリを作成する関数
     * 存在しない場合のみ作成する仕様となっています
     */
    async function ensureLogDir() {
      try {
        await fs.mkdir(CONFIG.logDir, { recursive: true });
      } catch (error) {
        console.error("ログディレクトリ作成エラー:", error);
      }
    }
    
    /**
     * ログメッセージを指定されたログファイルに追記する関数
     */
    async function writeLog(message) {
      const timestamp = new Date().toISOString().replace(/:/g, "-");
      // ログファイルパスを生成
      const logFile = path.join(
        CONFIG.logDir,
        `shuffle_${timestamp.split("T")[0]}.log`
      );
    
      try {
        // ログエントリを生成: [YYYY/MM/DD HH:mm:ss] メッセージの形式
        const logEntry = `[${new Date().toLocaleString("ja-JP")}] ${message}\n`;
        // 指定されたファイルにログエントリを非同期で追記
        await fs.appendFile(logFile, logEntry, "utf8");
        console.log(message);
      } catch (error) {
        console.error("ログ書き込みエラー:", error);
      }
    }
    
    /**
     * Puppeteerでシャッフルサイトを操作する関数
     */
    async function shuffleMembers() {
      let browser;
    
      try {
        await writeLog("ブラウザを起動中...");
        // Puppeteerを起動。`headless: true`でUIなしのバックグラウンド実行を設定
        browser = await puppeteer.launch({
          headless: true,
          args: ["--no-sandbox", "--disable-setuid-sandbox"],
        });
    
        // 新しいブラウザページを開く
        const page = await browser.newPage();
    
        // User-Agentを設定
        await page.setExtraHTTPHeaders({
          "User-Agent":
            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
        });
    
        await writeLog("サイトにアクセス中...");
        // 指定されたURLにアクセスし、ネットワークがアイドル状態になるまで待機
        await page.goto(CONFIG.shuffleUrl, { waitUntil: "networkidle2" });
    
        // テキストエリアに メンバーを入力
        const textareaSelector = "textarea";
        // テキストエリア要素が表示されるまで待機
        await page.waitForSelector(textareaSelector);
    
        const memberText = CONFIG.members.join("\n");
        // テキストエリアの`value`にメンバーリストを設定
        await page.evaluate(
          (selector, text) => {
            document.querySelector(selector).value = text;
          },
          textareaSelector,
          memberText
        );
    
        await writeLog("メンバーリストを入力完了");
    
        // 複数の可能性があるボタンセレクタを試行
        const possibleSelectors = ['span[role="button"]', ".btn", "#shuffle"];
    
        let shuffled = false;
        for (const selector of possibleSelectors) {
          try {
            // セレクタに一致するすべてのボタン要素を取得
            const buttons = await page.$$(selector);
            for (const button of buttons) {
              // ボタンのテキスト内容を取得
              const buttonText = await page.evaluate(
                (el) => el.value || el.textContent || el.innerHTML,
                button
              );
              if (buttonText && buttonText.includes("ランダマイズ")) {
                await button.click();
                shuffled = true;
                break;
              }
            }
            if (shuffled) break;
          } catch (error) {
            continue;
          }
        }
        // ボタンが見つからないままループが終了した場合、エラーをスロー
        if (!shuffled) {
          throw new Error("シャッフルボタンが見つかりませんでした");
        }
    
        await writeLog("シャッフル実行中...");
    
        // 要素が変わる時間を考慮(必要に応じて調整)
        await new Promise((resolve) => setTimeout(resolve, 3000));
        // 結果を取得
        const result = await page.evaluate((selector) => {
          const textarea = document.querySelector(selector);
          return textarea ? textarea.value : "";
        }, textareaSelector);
    
        if (!result) {
          throw new Error("シャッフル結果の取得に失敗しました");
        }
    
        const shuffledMembers = result
          .split("\n")
          .filter((member) => member.trim());
        await writeLog(`シャッフル結果: ${shuffledMembers.join(", ")}`);
    
        // シャッフルされたメンバーの配列を返す
        return shuffledMembers;
      } catch (error) {
        await writeLog(`エラー発生: ${error.message}`);
        throw error;
      } finally {
        if (browser) {
          await browser.close();
          await writeLog("ブラウザを終了しました");
        }
      }
    }
    
    /**
     * シャッフルされたメンバーを来週の平日に割り当てるオブジェクトを作成する関数
     */
    function createWeeklyAssignment(shuffledMembers) {
      const assignment = {};
      // 来週の月曜日から金曜日までの日付を取得
      const nextWeek = getNextWeekDates();
    
      // WEEKDAYS配列(例:['月', '火', '水', '木', '金'])を反復処理
      WEEKDAYS.forEach((day, index) => {
        // 各曜日にメンバーと日付を割り当てる
        assignment[day] = {
          member: shuffledMembers[index] || "未割り当て",
          date: nextWeek[index],
        };
      });
    
      return assignment;
    }
    
    /**
     * 来週の日付を取得する関数
     */
    function getNextWeekDates() {
      const today = new Date();
      const currentDay = today.getDay(); // 現在の曜日を取得(0: 日曜日, 1: 月曜日, ...)
    
      // 来週の月曜日までの日数を計算
      const daysUntilNextMonday = currentDay === 0 ? 1 : 8 - currentDay;
      const nextMonday = new Date(today);
      nextMonday.setDate(today.getDate() + daysUntilNextMonday);
    
      const weekDates = [];
      for (let i = 0; i < 5; i++) {
        const date = new Date(nextMonday);
        // 月曜日からi日後の日付を計算
        date.setDate(nextMonday.getDate() + i);
        // 日付を`MM/DD`形式の文字列にフォーマットし、配列に追加
        weekDates.push(
          date.toLocaleDateString("ja-JP", {
            month: "numeric",
            day: "numeric",
          })
        );
      }
    
      return weekDates;
    }
    
    /**
     * Windows PowerShellを使ってクリップボードにコピー
     * 外部ライブラリを使わずOS標準機能を活用
     */
    async function copyToClipboard(text) {
      const { spawn } = require("child_process");
    
      return new Promise((resolve, reject) => {
        // PowerShellコマンドを実行するための子プロセスを生成
        const child = spawn(
          "powershell",
          ["-command", `Set-Clipboard -Value "${text.replace(/"/g, '`"')}"`],
          {
            windowsHide: true,
          }
        );
    
        child.on("close", (code) => {
          if (code === 0) {
            resolve();
          } else {
            reject(new Error(`PowerShell exited with code ${code}`));
          }
        });
    
        child.on("error", reject);
      });
    }
    function formatResult(assignment) {
      let result = "来週の担当\n";
    
      WEEKDAYS.forEach((day) => {
        const info = assignment[day];
        result += `${day} (${info.date}): ${info.member}\n`;
      });
    
      return result;
    }
    
    /**
     * 来週の担当割り当ての通知を表示し、結果をクリップボードにコピーする関数
     */
    async function showNotification(assignment) {
      // 通知のメッセージを作成(例: "月: メンバーA\n火: メンバーB...")
      const message = WEEKDAYS.map(
        (day) => `${day}: ${assignment[day].member}`
      ).join("\n");
    
      // 通知を表示
      notifier.notify({
        title: "来週の担当割り当てが決まりました!",
        message: message,
        icon: path.join(__dirname, "icon.png"), // アイコンファイルがある場合
        sound: true,
        wait: true,
        timeout: 30,
      });
    
      // 詳細結果をクリップボードにコピー(Windows標準機能使用)
      const formattedResult = formatResult(assignment);
      try {
        await copyToClipboard(formattedResult);
        await writeLog("結果をクリップボードにコピーしました");
    
        // クリップボードコピー完了の通知
        setTimeout(() => {
          notifier.notify({
            title: "クリップボードにコピー完了",
            message:
              "結果がクリップボードにコピーされました。Ctrl+Vで貼り付けできます。",
            timeout: 5,
          });
        }, 2000);
      } catch (error) {
        await writeLog(`クリップボードコピーエラー: ${error.message}`);
      }
    }
    
    /**
     * メイン処理
     */
    async function main() {
      try {
        // 事前準備
        await ensureLogDir();
        await writeLog("=== 週次シャッフル処理開始 ===");
    
        // シャッフル実行
        const shuffledMembers = await shuffleMembers();
    
        // 曜日割り当て作成
        const assignment = createWeeklyAssignment(shuffledMembers);
    
        // 結果をログに記録
        await writeLog("週次割り当て結果:");
        for (const day of WEEKDAYS) {
          const info = assignment[day];
          await writeLog(`  ${day} (${info.date}): ${info.member}`);
        }
    
        // デスクトップ通知とクリップボードコピー
        await showNotification(assignment);
    
        await writeLog("=== 処理正常完了 ===");
      } catch (error) {
        await writeLog(`=== 処理エラー: ${error.message} ===`);
    
        // エラー通知
        notifier.notify({
          title: "シャッフル処理でエラーが発生しました",
          message: `エラー: ${error.message}`,
          sound: true,
          timeout: 10,
        });
    
        process.exit(1);
      }
    }
    
    // 作動
    main();
    

    (3) 依存関係のインストール

    package.jsonファイルが作成できたら、必要なライブラリをインストールします。コマンドプロンプトでプロジェクトディレクトリに移動し、以下のコマンドを実行してください。

    cd C:\work\Techblog
    npm install

    このコマンドにより、package.jsonに記載された依存関係が自動的にインストールされ、node_modulesフォルダが作成されます。
    ここまで行えば処理の実行が可能となります。以下のコマンドを実行して実際に動かしてみましょう!

    node index.js

    正しく終了すれば以下の様に出力されます。

    画像
    ターミナル


    画像
    通知画面

    割り当ての結果に関してはクリップボードにコピーされるので、後は貼り付けてあげればOKです。

    (4) バッチファイルの作成とタスクスケジューラーの設定

    バッチファイルの作成

    スケジュール実行用のバッチファイル(run_shuffle.bat)を作成します。

    @echo off
    cd /d "C:\work\Techblog"
    node index.js
    exit

    Windowsタスクスケジューラの設定

    毎週金曜日の17時に自動実行する設定手順は以下となります。

    1. タスクスケジューラの起動

      • Win + R → taskschd.msc → Enter

    2. 基本タスクの作成

      • 右側の「基本タスクの作成」をクリック

      • 名前: 週次当番シャッフル

      • 説明: 毎週金曜日に来週の当番を自動決定

    3. トリガーの設定

      • 「週単位」を選択

      • 開始日時: 任意の金曜日 17:00

      • 間隔: 1週間

      • 実行する曜日: 金曜日にチェック

    4. 操作の設定

      • 「プログラムの開始」を選択

      • プログラム/スクリプト: C:\work\Techblog\run_shuffle.bat

      • 開始ディレクトリ: C:\work\Techblog

    5. 完了

      • 設定内容を確認して「完了」をクリック

    バッチファイルやタスクスケジューラーに関して詳しく知りたい方は以下を見てみて下さい!

    まとめ

    今回の実装により、単純ながら面倒な定型作業を自動化できました!Node.jsとPuppeteerの組み合わせは、ブラウザ操作を伴う自動化において非常に役立ちます。定型作業に時間を取られている方は、ぜひ自動化を検討してみてください!


    我々、株式会社エアリーは、
    千葉で働きたい・頑張りたい人材を募集しております!

    新卒採用・キャリア採用どちらも募集しております!
    以下HPより、皆様のご応募お待ちしております。

    【株式会社エアリー:お問合せフォーム】


     
     
    千葉で30年以上の実績を持つIT企業、株式会社エアリーの技術ブログです。 RPA(PowerAutomate)等の弊社利用技術や、役立つアプリの作成方法、トレンドIT技術の体験記事などの情報を紹介します! 弊社HPはこちらから!:https://www.airily.co.jp

    あなたへのおすすめ