server.js を3点変更しました：

locale: 'ja-JP' → locale: ''（ローカルPCで成功していた設定）
Content-Length ヘッダーを除去（test_tts.js では送っていなかった、これが差異の一つ）
デバッグログを追加（Amazonへのリクエスト内容とレスポンスをログ出力）
認証問題について

test_tts.js（ローカルで成功）と server.js（サーバーで失敗）を比較した結果、実は使っているCookieは全く同じもの（.env から読み込んでいる）なので、認証情報自体の差は本来ないはずです。

ただし、気になる点が1つあります：

test_tts.js は locale: 'ja-JP' でローカルから成功しているのに、server.js は locale: 'ja-JP' でサーバーから失敗している

これは実は「どこから接続しているか（IPアドレス） で Amazon 側の挙動が変わっている」可能性を示唆します。ただし、先ほど確認したように keinafarm.net は大阪のIPなので、この説明も矛盾します。

デプロイ手順：

bash
# ローカルから scp でサーバーへ転送
scp alexa-api/server.js keinafarm-claude:/home/claude/alexa-api/server.js
# サーバーへSSHしてビルド＆再起動
ssh keinafarm-claude 'cd /home/claude/alexa-api && sudo docker compose build && sudo docker compose up -d && sudo docker restart traefik'
デプロイ後、sudo docker logs alexa_api -f でログを確認して、[DEBUG] 行の内容を教えてください。どんな JSON が Amazon に送られているか、Amazon が何を返しているかが見えてきます。

alexa-api/server.js

@@ -37,6 +37,7 @@ function httpsRequest(path, options, extraCookies) {
   extraCookies = extraCookies || '';
   return new Promise(function(resolve, reject) {
     var allCookies = ALEXA_COOKIE + (extraCookies ? '; ' + extraCookies : '');
+    // bodyBuf はバイト列変換（マルチバイト文字に対応）
     var bodyBuf = options.body ? Buffer.from(options.body, 'utf8') : null;
     var reqOpts = {
       hostname: ALEXA_HOST,
@@ -47,7 +48,8 @@ function httpsRequest(path, options, extraCookies) {
         'Accept': 'application/json, text/plain, */*',
         'Accept-Language': 'ja-JP,ja;q=0.9',
         'Cookie': allCookies,
-      }, bodyBuf ? { 'Content-Length': bodyBuf.length } : {}, options.headers || {}),
+        // Content-Length は送らない（test_tts.js で動作実績あり、Amazonが自動判定）
+      }, options.headers || {}),
     };
     var req = https.request(reqOpts, function(res) {
       var body = '';
@@ -128,8 +130,8 @@ app.post('/speak', async function(req, res) {
 
     console.log('    -> ' + target.accountName + ' (type=' + target.deviceType + ', serial=' + target.serialNumber + ')');
 
-var ssml = '<speak>' + text + '</speak>';
+// locale: '' はローカルPCでは日本語発話成功（サーバーからは要検証）
-
+// Alexa.SpeakSsml 系は全滅のため Alexa.Speak に戻す
 var sequenceObj = {
   '@type': 'com.amazon.alexa.behaviors.model.Sequence',
   startNode: {
@@ -139,7 +141,7 @@ var sequenceObj = {
       deviceType: target.deviceType,
       deviceSerialNumber: target.serialNumber,
       customerId: customerId,
-      locale: 'ja-JP',
+      locale: '',
       textToSpeak: text
     },
   },
@@ -151,6 +153,9 @@ var sequenceObj = {
       status: 'ENABLED',
     });
 
+    // リクエストボディをログ出力（認証・パラメータ確認用）
+    console.log('[DEBUG] sequenceJson:', JSON.stringify(sequenceObj, null, 2));
+
     var ttsRes = await httpsRequest('/api/behaviors/preview', {
       method: 'POST',
       headers: {
@@ -162,6 +167,9 @@ var sequenceObj = {
       body: bodyStr,
     }, 'csrf=' + csrfToken);
 
+    // Amazonからのレスポンスをログ出力
+    console.log('[DEBUG] Alexa API response: ' + ttsRes.status + ' body=' + ttsRes.body.substring(0, 200));
+
     if (ttsRes.status === 200 || ttsRes.status === 202) {
       console.log('    [OK] TTS sent to ' + target.accountName);
       res.json({ ok: true, device: target.accountName, text: text });

docs/10_Alexa TTS API 実装記録 (2026-03-02).md

@@ -0,0 +1,148 @@
+Alexa TTS API マスタードキュメント
+
+最終更新: 2026-03-03　状態: サーバーからの日本語TTS未解決（調査中）
+------------
+2026/03/03 10:24 akira記録
+akiraが下記の変更をしましたので、内容を読んでください。
+
+1) 構成とサーバーへのファイル受け渡し方法を変更しました
+/home/claude/windmill_workflow
+に、https://gitea.keinafarm.net/akira/windmill_workflow.gitをcloneしました
+これにより、
+C:\Users\akira\Develop\windmill_workflow
+とのやり取りはgiteaを使って出来るようになります。
+
+2) docker compose up -dで、「 Docker 内部の IP アドレスが変わり、Traefik のルーティングが古い IP を参照したまま 502/504 エラーになる」のは、原因があるはずです。（他のコンテナで、問題になっていないので）
+調査して、Traefik 再起動が不必要になるようにしたいです
+
+
+
+------------
+
+概要
+Windmill から家中の Echo デバイスに任意のテキストを読み上げさせる API サーバー。Node.js + Express で実装し、Docker コンテナとして Windmill サーバー上で稼働する。
+
+⚠ 現在の問題: ローカル PC からは日本語TTS動作確認済み。しかしサーバー（keinafarm.net）のコンテナからリクエストすると日本語文字が Amazon 側で除去されて発話されない。原因は Amazon の IP ベースフィルタリング（海外IPからは日本語 textToSpeak を無視する模様）。調査継続中。
+
+ファイル構成
+ファイル	場所	役割	備考
+server.js	alexa-api/（リポジトリ）	Express API サーバー本体	本番コード。変更したらビルド・再デプロイが必要
+Dockerfile	alexa-api/（リポジトリ）	Docker イメージ定義	node:20-alpine ベース。server.js と package*.json をコピー
+docker-compose.yml	alexa-api/（リポジトリ）	コンテナ起動設定	windmill_windmill-internal ネットワーク接続。外部ポート非公開
+package.json / package-lock.json	alexa-api/（リポジトリ）	npm 依存関係	本番: express のみ。devDeps に alexa-remote2（不使用）
+.env.example	alexa-api/（リポジトリ）	環境変数テンプレート	ALEXA_COOKIE=xxx の形式
+.env	alexa-api/（リポジトリ、.gitignore 対象）	実際の Cookie 保管	Git にコミットしない。ローカル作業後に scp でサーバーへ転送
+auth4.js	alexa-api/（リポジトリ）	Amazon 認証・Cookie 取得スクリプト	ローカルのみで実行（Windows PC）
+auth.js / auth2.js / auth3.js	alexa-api/（リポジトリ）	auth4.js の旧バージョン	参考用。実際は auth4.js を使う
+test_tts.js	alexa-api/（リポジトリ）	ローカルテスト用スクリプト	直接 alexa.amazon.co.jp を叩いて動作確認
+サーバー上のファイル場所: /home/claude/alexa-api/（git リポジトリとは別にコピーして管理）
+
+サーバーへのデプロイ手順
+server.js や Dockerfile、package.json を変更した場合は以下の手順でサーバーに反映する。
+
+Step 1: ローカルでファイルを編集
+リポジトリ（c:\Users\akira\Develop\windmill_workflow\alexa-api\）でファイルを編集する。
+
+Step 2: scp でサーバーに転送
+変更したファイルをサーバーに scp で転送する：
+
+# server.js を変更した場合 scp alexa-api/server.js keinafarm-claude:/home/claude/alexa-api/server.js # Dockerfile や package.json を変更した場合 scp alexa-api/Dockerfile keinafarm-claude:/home/claude/alexa-api/Dockerfile scp alexa-api/package.json keinafarm-claude:/home/claude/alexa-api/package.json scp alexa-api/package-lock.json keinafarm-claude:/home/claude/alexa-api/package-lock.json # .env を更新した場合（Cookie 更新時など） scp alexa-api/.env keinafarm-claude:/home/claude/alexa-api/.env
+
+Step 3: サーバーでビルドして再起動
+⚠ 重要: docker compose restart はイメージをリビルドしない。server.js 等を変更した場合は必ず build + up -d を実行すること。
+
+# SSH でサーバーに接続してビルド＋起動 ssh keinafarm-claude cd /home/claude/alexa-api # イメージをビルド（server.js 等の変更を反映） sudo docker compose build # コンテナを再作成して起動 sudo docker compose up -d # Traefik を再起動（コンテナ再作成後は必須） sudo docker restart traefik
+
+Step 4: 動作確認
+# ヘルスチェック（Windmill ワーカーコンテナ内から） curl http://alexa_api:3500/health # ログ確認 sudo docker logs alexa_api -f # デバイス一覧確認 curl http://alexa_api:3500/devices
+
+Cookie だけ更新する場合（server.js 変更なし）
+# .env をサーバーに転送 scp alexa-api/.env keinafarm-claude:/home/claude/alexa-api/.env # コンテナを再起動（restart で OK → イメージのリビルド不要） ssh keinafarm-claude 'sudo docker compose -f /home/claude/alexa-api/docker-compose.yml restart' # ※ Traefik の再起動は不要（コンテナ再作成しないため）
+
+Traefik 再起動が必要な理由
+docker compose up -d はコンテナを「再作成」する（docker compose restart は既存コンテナを再起動するだけ）。コンテナが再作成されると Docker 内部の IP アドレスが変わり、Traefik のルーティングが古い IP を参照したまま 502/504 エラーになる。
+
+対処: sudo docker restart traefik で Traefik に新しい IP を再検出させる。
+
+この問題は Traefik の設定で watch: true にすれば自動解消できるが、現状はコンテナ再作成のたびに手動で Traefik を再起動する運用としている。
+
+docker-compose.yml の内容
+services:  alexa-api:    build: .    container_name: alexa_api    restart: unless-stopped    env_file:      - .env    environment:      - PORT=3500    networks:      - windmill_windmill-internal    # 外部には公開しない（Windmill ワーカーから内部ネットワーク経由でのみアクセス）    # デバッグ時は以下のコメントを外す:    # ports:    #   - "127.0.0.1:3500:3500" networks:  windmill_windmill-internal:    external: true
+
+認証方法（auth4.js）
+Amazon Japan OpenID フローを自前で実装。ローカル PC（Windows）でのみ実行する：
+
+# ローカルPC の alexa-api ディレクトリで実行 cd alexa-api AMAZON_EMAIL="メールアドレス" AMAZON_PASSWORD="パスワード" node auth4.js
+
+成功すると alexa-api/.env が生成または更新される。
+
+ログインフローの概要：
+
+GET https://www.amazon.co.jp/ap/signin?openid.assoc_handle=amzn_dp_project_dee_jp
+hidden フィールド（anti-csrftoken-a2z, appActionToken, workflowState 等）を抽出
+POST でメール/パスワードを送信
+alexa.amazon.co.jp/api/apps/v1/token へのリダイレクトをたどる
+取得した Cookie（at-acbjp, sess-at-acbjp, sst-acbjp, session-token 等）を .env に保存
+TTS の仕組み（server.js）
+alexa-remote2 は使わない直接 API 実装。Endpoints:
+
+POST /speak — { device: "デバイス名 or serial", text: "しゃべる内容" }
+GET /devices — デバイス一覧
+GET /health — ヘルスチェック
+内部の API 呼び出し順序：
+
+GET /api/language → Set-Cookie: csrf=XXXXX を取得（毎リクエストごと）
+GET /api/bootstrap → customerId を取得（キャッシュ: 永続）（A1AE8HXD8IJ61L）
+GET /api/devices-v2/device → デバイス一覧（5分キャッシュ）
+POST /api/behaviors/preview にシーケンス JSON を送信
+POST /api/behaviors/preview のボディ構造：
+
+{  behaviorId: "PREVIEW",  sequenceJson: JSON.stringify({    "@type": "com.amazon.alexa.behaviors.model.Sequence",    startNode: {      "@type": "com.amazon.alexa.behaviors.model.OpaquePayloadOperationNode",      type: "Alexa.Speak",      operationPayload: {        deviceType: "...",        deviceSerialNumber: "...",        customerId: "A1AE8HXD8IJ61L",        locale: "ja-JP",    // ← 重要（下記参照）        textToSpeak: "発話内容"      }    }  }),  status: "ENABLED" }
+
+ヘッダーに csrf: XXXXX と Cookie に csrf=XXXXX の両方が必要。Content-Length は Buffer.byteLength で計算（マルチバイト文字対応）。
+
+⚠ locale パラメータについて（重要・未解決）
+locale 値	ローカル PC から	サーバー（keinafarm.net）から
+""（空文字）	✅ 日本語・英語・漢字全て発話	❌ 英語TTSになり日本語部分が発話されない
+"ja-JP"	❌ 一瞬音が出るだけ（失敗）	❌ 日本語文字が Amazon 側で除去され英字のみ発話
+現在 server.js では locale: "ja-JP" に設定している。
+
+仮説: Amazon が海外IP（keinafarm.net = 非日本IP）からのリクエストを IP ベースでフィルタリングし、textToSpeak の日本語文字を除去している。Alexa.TextCommand は同じ問題がない（異なる API パス）。
+
+確認済み事実: alexa_api の server.js ログには日本語テキストが正しく届いている。除去は Amazon サーバー側で発生。
+
+次の調査候補:
+
+SSML の <lang xml:lang="ja-JP"> タグで強制的に日本語 TTS を指定できるか
+Alexa.TextCommand で「次を読み上げて：{text}」形式が使えるか
+ローカルブリッジ方式（ユーザーのローカル PC で小さなプロキシサーバーを動かし、クラウドサーバーからローカル経由で alexa.amazon.co.jp を叩く）
+デバイス一覧（Echo デバイスのみ）
+名前	deviceType	serialNumber
+プレハブ	A4ZXE0RM7LQ7A	G0922H085165007R
+リビングエコー1	ASQZWP4GPYUT7	G8M2DB08522600RL
+リビングエコー2	ASQZWP4GPYUT7	G8M2DB08522503WF
+オフィスの右エコー	A4ZXE0RM7LQ7A	G0922H08525302K5
+オフィスの左エコー	A4ZXE0RM7LQ7A	G0922H08525302J9
+寝室のエコー	ASQZWP4GPYUT7	G8M2HN08534302XH
+Windmill スクリプト（u/admin/alexa_speak）
+export async function main(device: string, text: string) {  const res = await fetch("http://alexa_api:3500/speak", {    method: "POST",    headers: { "Content-Type": "application/json" },    body: JSON.stringify({ device, text }),  });  if (!res.ok) throw new Error("alexa-api error " + res.status);  return res.json(); }
+
+device はデバイス名（日本語）またはシリアル番号で指定可能。Windmill ワーカーから http://alexa_api:3500 でアクセス（windmill_windmill-internal ネットワーク経由）。
+
+Cookie の更新手順
+Cookie は数日〜数週間で期限切れ。切れたら：
+
+# 1. ローカル PC で Cookie を取得 cd alexa-api AMAZON_EMAIL="メールアドレス" AMAZON_PASSWORD="パスワード" node auth4.js # → alexa-api/.env が更新される # 2. サーバーに .env を転送 scp alexa-api/.env keinafarm-claude:/home/claude/alexa-api/.env # 3. コンテナを再起動（restart で OK、リビルド不要） ssh keinafarm-claude 'sudo docker compose -f /home/claude/alexa-api/docker-compose.yml restart' # ※ Traefik 再起動は不要（コンテナ再作成なし）
+
+既知の問題・落とし穴
+docker compose restart ≠ リビルド: server.js を変更しても restart ではコンテナ内のコードは古いまま。build + up -d が必要。
+コンテナ再作成後は Traefik 再起動必須: up -d でコンテナ再作成すると Docker 内部 IP が変わり Traefik が 502/504 を返す。sudo docker restart traefik で解消。
+alexa-remote2 は使えない: 取得した Cookie 文字列を受け付けない（内部で再認証しようとして失敗）。直接 API 実装が必要。
+CSRF トークンは Cookie と ヘッダーの両方に必要: csrf ヘッダーだけ、または Cookie だけでは認証失敗。
+operationPayload に customerId 必須: ないと 400 エラー。
+レート制限: 短時間に連続リクエストすると HTTP 429 または 200 で音が出ない。通常の通知用途では問題なし。
+git push がブロックされる: Gitea の pre-receive フック（remote: Gitea: User permission denied for writing）で push が失敗する。根本原因は未調査。ファイル転送は scp で行っている。
+firstRunCompleted: false はデバイス設定の未完了フラグ: TTS には直接影響しない（root cause ではなかった）。
+サーバー上の運用コマンド一覧
+# コンテナ状態確認 sudo docker ps | grep alexa # リアルタイムログ確認 sudo docker logs alexa_api -f # コンテナ停止 sudo docker compose -f /home/claude/alexa-api/docker-compose.yml stop # ビルド＋起動（コード変更後） cd /home/claude/alexa-api sudo docker compose build sudo docker compose up -d sudo docker restart traefik # Cookie 更新時（再起動のみ） sudo docker compose -f /home/claude/alexa-api/docker-compose.yml restart
+