================================================================ Amazon 注文履歴 Excel出力ツール　使い方ガイド ～ インストールから使い方まで ～ ================================================================ ================================================================ 第1章　はじめにインストールするもの ================================================================ このツールを使うには、以下の3つのソフトをインストールする 必要があります。 ① Python（パイソン） ② Node.js（ノードジェイエス） ③ Google Chrome（グーグルクローム） それぞれ順番にインストールしてください。 ---------------------------------------------------------------- 【① Python のインストール】 ---------------------------------------------------------------- Python は画面のフォームを表示するために必要です。 1. ブラウザで以下のページを開く https://www.python.org/downloads/ 2. 「Download Python」と書かれた黄色いボタンをクリック 3. ダウンロードされたファイル（python-3.x.x-amd64.exe）を ダブルクリックして起動 4. インストール画面が開いたら、必ず以下を確認すること！ ------------------------------------------------------- ！「Add Python to PATH」または 「Add python.exe to PATH」に チェックを入れる（重要！） ------------------------------------------------------- 5. 「Install Now」をクリックしてインストール開始 6. 「Setup was successful」と表示されたら完了 7. 続けて Python の追加ライブラリをインストールする （次の手順へ） ▼ Python 追加ライブラリのインストール 1. キーボードの「Windowsキー」を押しながら「R」を押す 2. 「ファイル名を指定して実行」という小さい画面が開くので 「cmd」と入力して「OK」をクリック 3. 黒い画面（コマンドプロンプト）が開いたら 以下をそのまま入力してEnterキーを押す pip install tkcalendar 4. 「Successfully installed」と表示されたら完了 ---------------------------------------------------------------- 【② Node.js のインストール】 ---------------------------------------------------------------- Node.js は Amazon のページから注文データを取得するために 必要です。 1. ブラウザで以下のページを開く https://nodejs.org/ 2. 「LTS」と書かれたボタンをクリックしてダウンロード ※ LTS とは安定版という意味です 3. ダウンロードされたファイル（node-v**.msi）を ダブルクリックして起動 4. 「Next」を繰り返しクリックしてインストール （設定はすべてデフォルトのままでOK） 5. 「Finish」をクリックして完了 6. インストールできたか確認する コマンドプロンプトを開いて（上記参照）以下を入力： node -v 「v20.xx.x」のようなバージョン番号が表示されればOK ---------------------------------------------------------------- 【③ Google Chrome のインストール】 ---------------------------------------------------------------- Amazon へのログインと注文データの取得に使います。 すでにインストール済みの方はスキップしてください。 1. ブラウザで「Google Chrome ダウンロード」と検索 2. Google の公式サイトから「Chrome をダウンロード」をクリック 3. ダウンロードされたファイルを実行してインストール ================================================================ 第2章　ツールのファイルを準備する ================================================================ ---------------------------------------------------------------- 【ファイルの構成】 ---------------------------------------------------------------- ツールは以下の3つのファイルで動作します。 これらを必ず同じフォルダにまとめて置いてください。 ・amazon_form.pyw → 起動用フォーム ・amazon_scrape.js → 自動取得スクリプト ・node_modules フォルダ → 必要なライブラリ（削除しない） どのフォルダに置いても動作しますが、わかりやすい場所に まとめておくことをおすすめします。 例）Cドライブ直下に置く場合： C:\ ├── amazon_form.pyw ├── amazon_scrape.js └── node_modules\ 例）ダウンロードフォルダに置く場合： ダウンロードフォルダ\ ├── amazon_form.pyw ├── amazon_scrape.js └── node_modules\ ！注意：出力されるExcelファイルの保存先は ダウンロードフォルダになります。 ================================================================ 第3章　ツールの使い方 ================================================================ ---------------------------------------------------------------- 【起動方法】 ---------------------------------------------------------------- 「amazon_form.pyw」をダブルクリックする。 フォームが開きます。 ※ 黒いコンソール画面は表示されません。 もし「このファイルを開くアプリを選んでください」という 画面が出た場合： → 「Python」を選択してください ---------------------------------------------------------------- 【日付の指定方法】 ---------------------------------------------------------------- フォームに「開始日」と「終了日」の入力欄があります。 ① 入力欄をクリックするとカレンダーが開きます。 ② カレンダーから取得したい期間の開始日・終了日を選びます。 ③ 直接入力する場合は「2026/01/01」のように入力できます。 初期値： 開始日 → 今年の 1月1日 終了日 → 今日の日付 ！注意：開始日が終了日より後の日付になるとエラーになります。 ---------------------------------------------------------------- 【実行方法】 ---------------------------------------------------------------- 日付を設定したら「Excel出力を実行」ボタンを押す。 → 自動でChromeブラウザが開きます。 ---------------------------------------------------------------- 【ログインについて】 ---------------------------------------------------------------- ■ 初回（初めて使うとき） Amazonのログイン画面が表示されます。 メールアドレスとパスワードを入力してログインしてください。 ログイン後、追加認証（SMS・ワンタイムパスワードなど）が 求められた場合はそちらも完了させてください。 ログインが完了すると自動で注文履歴の取得が始まります。 ！注意：3分以内にログインを完了してください。 ■ 2回目以降 ログイン情報が保存されているため、 通常はログイン画面は表示されず自動で取得が始まります。 ※ 数週間〜数ヶ月経過するとセッションが切れ、 再度ログインが必要になる場合があります。 ■ ログイン中の注意 ・Chromeを手動で閉じないでください。 ・ブラウザの操作（クリックなど）は不要です。 ログイン後は自動で処理が進みます。 ---------------------------------------------------------------- 【取得中の動作】 ---------------------------------------------------------------- フォームのログ欄に進捗が表示されます。 表示例： Amazonにアクセス中... ログインページが表示されています。 ログイン完了！注文履歴を読み込んでいます... ページ 1 を処理中... 25 件取得（累計 25 件） ページ 2 を処理中... 25 件取得（累計 50 件） 最終ページに到達しました。 月計数: 4、総合計: 123456 合計 50 件 → ダウンロードフォルダ内の amazon_orders_all.xlsx 完了するとフォームに「完了！Excelを保存しました。」と 表示されます。 ---------------------------------------------------------------- 【出力ファイル】 ---------------------------------------------------------------- 保存場所：ダウンロードフォルダ内の amazon_orders_all.xlsx ！注意：実行するたびに同じファイルが上書きされます。 別の期間のデータを残したい場合は、 実行前にファイル名を変更しておいてください。 （例：amazon_orders_2026_01-04.xlsx） ================================================================ 第4章　Excelファイルの内容 ================================================================ シート名：注文履歴 列の構成： A列：注文日 B列：金額（カンマあり　例：2,610） C列：注文番号 D列：商品名 行の構成： ・各注文のデータ行 ・○月計（月ごとの小計）　← 薄い黄色・太字 ・総合計（全月計の合算）　← 薄いオレンジ・太字 表示例： 注文日 金額 注文番号 商品名 2026年1月29日 3,200 503-xxxxxxx-xxxxxxx 商品A 1月計 3,200 2026年2月5日 1,500 503-xxxxxxx-xxxxxxx 商品B 2026年2月18日 800 503-xxxxxxx-xxxxxxx 商品C 2月計 2,300 総合計 5,500 ================================================================ 第5章　うまくいかない場合 ================================================================ ■ 「取得件数が0件です」と表示される → ダウンロードフォルダ内の amazon_debug.png を開いて Chromeの状態を確認してください。 → ログインが完了していない可能性があります。 ■ ログイン画面に何度も戻される → Chromeをすべて閉じてから再実行してください。 ■ Chromeが開かない・すぐ閉じる → Chromeが既に開いている場合は閉じてから再実行してください。 ■ 注文件数が少ない・途中で終わっている → 指定した日付範囲外の注文は取得されません。 開始日・終了日を確認してください。 ■ フォームが開かない → Python がインストールされているか確認してください。 コマンドプロンプトで「python -v」と入力して バージョン番号が表示されればインストール済みです。 ■ 「pip install tkcalendar」でエラーになる → Python インストール時に「Add Python to PATH」に チェックを入れていない可能性があります。 Python を一度アンインストールして再インストールし、 チェックを忘れずに入れてください。 ■ 初回実行後、GmailなどのGoogleサービスで再ログインを求められる → このツールはChromeを自動操作するため、初回起動時に Chromeの動作が一時的に不安定になる場合があります。 GmailなどのGoogleサービスで再ログインが求められた場合は、 通常通りログインし直してください。 2回目以降は発生しにくくなります。 ================================================================