================================================================
  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 を一度アンインストールして再インストールし、
      チェックを忘れずに入れてください。

================================================================
