@ac-codeprod/n8n-nodes-alexa-remote 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alain Cajuste
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.fr.md

@@ -0,0 +1,300 @@
+# @ac-codeprod/n8n-nodes-alexa-remote
+
+[![n8n community node](https://img.shields.io/badge/n8n-community%20node-orange?logo=n8n)](https://docs.n8n.io/integrations/community-nodes/installation/)
+[![npm version](https://img.shields.io/npm/v/@ac-codeprod/n8n-nodes-alexa-remote)](https://www.npmjs.com/package/@ac-codeprod/n8n-nodes-alexa-remote)
+[![npm downloads](https://img.shields.io/npm/dm/@ac-codeprod/n8n-nodes-alexa-remote)](https://www.npmjs.com/package/@ac-codeprod/n8n-nodes-alexa-remote)
+[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+Ce package de nœuds communautaires n8n vous permet d'interagir avec l'API Amazon Alexa dans vos workflows n8n. Il fournit deux nœuds :
+
+- **Alexa Remote** — nœud d'action pour contrôler des appareils, exécuter des routines, gérer des listes, des notifications, et bien plus.
+- **Alexa Remote Trigger** — nœud déclencheur qui démarre un workflow lorsqu'un événement push WebSocket Alexa se produit.
+
+Alexa Remote offre un accès programmatique pour contrôler les appareils Echo, exécuter des routines, gérer les appareils domotiques, et bien plus encore — sans avoir à dire « Alexa » !
+
+[n8n](https://n8n.io/) est une plateforme d'automatisation de workflows sous [licence fair-code](https://docs.n8n.io/sustainable-use-license/).
+
+## Table des matières
+
+- [Installation](#installation)
+- [Nœuds](#nœuds)
+- [Opérations](#opérations)
+- [Événements déclencheurs](#événements-déclencheurs)
+- [Identifiants](#identifiants)
+- [Compatibilité](#compatibilité)
+- [Utilisation](#utilisation)
+- [Dépannage](#dépannage)
+- [Ressources](#ressources)
+
+## Installation
+
+Suivez le [guide d'installation](https://docs.n8n.io/integrations/community-nodes/installation/) dans la documentation des nœuds communautaires n8n.
+
+### Installation rapide
+
+```bash
+npm install @ac-codeprod/n8n-nodes-alexa-remote
+```
+
+## Nœuds
+
+### Alexa Remote
+
+Un nœud d'action pour interagir avec l'API Alexa. Prend en charge 10 ressources et peut également être utilisé comme outil IA.
+
+### Alexa Remote Trigger
+
+Un nœud déclencheur qui écoute les événements push WebSocket Alexa en temps réel et démarre votre workflow lorsqu'ils se produisent.
+
+## Opérations
+
+### Account (Compte)
+- **Get Accounts** — Obtenir les informations du compte
+- **Get Contacts** — Récupérer vos contacts Alexa
+- **Get Music Providers** — Lister les services de streaming musical disponibles
+- **Get Routines** — Obtenir toutes les routines d'automatisation
+
+### Auth (Authentification)
+- **Authenticate** — Démarrer le proxy et attendre la connexion Amazon. Ouvrez votre navigateur sur `http://[IP Proxy]:[Port Proxy]` lorsque le workflow est en cours d'exécution. Le paramètre **Login Timeout (Minutes)** contrôle le délai d'attente (défaut : 5 min).
+
+### Bluetooth ⚠️ Non testé
+
+> **Avertissement** : Les opérations Bluetooth n'ont pas encore été testées. Elles sont disponibles dans le code mais leur fonctionnement n'est pas garanti.
+
+- **Get State** — Obtenir les appareils Bluetooth appairés et l'état de connexion
+- **Connect** — Se connecter à un appareil Bluetooth appairé (requiert l'adresse MAC)
+- **Disconnect** — Déconnecter l'appareil Bluetooth actuel
+- **Unpair** — Désappairer un appareil Bluetooth (requiert l'adresse MAC)
+
+### Conversation
+- **Get Conversations** — Obtenir les conversations Alexa (filtre optionnel : non lues seulement)
+- **Send Message** — Envoyer un message texte dans une conversation
+
+### Device (Appareil Echo)
+- **Get Devices** — Lister tous vos appareils Echo
+- **Get Device Info** — Obtenir les informations détaillées d'un appareil spécifique
+- **Get Player Info** — Obtenir les informations du lecteur en cours (piste, état, volume…)
+- **Get Player Queue** — Obtenir la file de lecture en cours
+- **Send Command** — Envoyer une commande média à un appareil : `play`, `pause`, `next`, `previous`, `forward`, `rewind`, `repeat`, `shuffle`
+- **Set Do Not Disturb** — Activer ou désactiver le mode Ne pas déranger
+
+### Interaction
+- **Speak** — Faire parler Alexa (texte normal, SSML ou annonce)
+- **Speak All (Multi-Device)** — Faire parler plusieurs appareils Echo en parallèle
+- **Speak At Volume** — Faire parler Alexa à un volume spécifique
+- **Text Command** — Envoyer une commande textuelle à Alexa (comme lui poser une question)
+- **Stop** — Arrêter la lecture sur un appareil
+- **Set Volume** — Modifier le volume d'un appareil (0–100)
+- **Play Music** — Lire de la musique depuis un fournisseur (Amazon Music, Spotify, TuneIn, Cloud Player)
+- **Builtin** — Lancer une action intégrée Alexa : Météo, Trafic, Flash Info, Bonjour, Fun Fact, Blague, Clean Up, Chanter une chanson, Raconter une histoire, Calendrier (Aujourd'hui / Demain / Prochain)
+- **Sound** — Jouer un effet sonore par identifiant (ex. : `amzn1.ask.1p.sound/nature/crickets_01`)
+- **Wait** — Attendre un nombre de secondes donné (utile dans les workflows séquentiels)
+
+### List (Liste)
+- **Get Lists** — Obtenir toutes les listes Alexa (courses, tâches, personnalisées)
+- **Add Item** — Ajouter un élément à une liste
+- **Remove Item** — Supprimer un élément d'une liste
+- **Create List** — Créer une nouvelle liste personnalisée
+- **Delete List** — Supprimer une liste
+
+### Notification
+- **Get Notifications** — Lister toutes les notifications (alarmes, rappels, minuteries)
+- **Create Notification** — Créer une alarme, un rappel ou une minuterie
+- **Delete Notification** — Supprimer une notification par ID
+
+### Routine
+- **Execute Routine** — Exécuter une routine Alexa existante (sélectionnée dans une liste déroulante)
+
+### Smarthome (Domotique)
+- **Get Devices** — Lister tous les appareils domotiques connectés
+- **Control Device** — Contrôler un appareil domotique : Allumer, Éteindre, Définir la luminosité, Définir la couleur, Définir la température
+
+## Événements déclencheurs
+
+Le nœud **Alexa Remote Trigger** écoute les événements push WebSocket suivants :
+
+| Événement | Description |
+|---|---|
+| **All Messages** | Se déclenche sur chaque événement WebSocket reçu d'Alexa |
+| **All Unknown Messages** | Se déclenche sur chaque message WebSocket non reconnu |
+| **Audio Player State Change** | Se déclenche quand l'état de lecture change sur un appareil Echo |
+| **Bluetooth State Change** | Se déclenche quand l'état d'une connexion Bluetooth change |
+| **Device Activity** | Se déclenche quand un appareil Echo enregistre une activité (commande vocale, etc.) |
+| **Device Connection Change** | Se déclenche quand un appareil Echo passe en ligne ou hors ligne |
+| **Media Change** | Se déclenche quand le média en cours de lecture change |
+| **Notification Change** | Se déclenche quand une notification Alexa (alarme, rappel) change |
+| **Todo / List Change** | Se déclenche quand une liste de courses ou de tâches Alexa change |
+| **Volume Change** | Se déclenche quand le volume d'un appareil Echo change |
+
+Chaque déclencheur émet un payload JSON avec les champs `event`, `payload` et `timestamp`.
+
+## Identifiants
+
+Pour utiliser ce nœud, vous devez configurer des identifiants **Alexa Remote API**.
+
+### Prérequis
+
+1. Un compte Amazon avec des appareils Alexa enregistrés
+2. Accès à l'adresse IP de votre serveur n8n (pour l'authentification par proxy)
+
+### Configuration
+
+1. Dans n8n, créez de nouveaux identifiants « Alexa Remote API »
+2. Configurez les paramètres suivants :
+   - **Proxy IP** : L'adresse IP de votre serveur n8n (ex. : `192.168.1.100`)
+   - **Proxy Port** : Port pour l'authentification (par défaut : `3456`)
+   - **Cookie File Path** : Chemin pour sauvegarder le cookie (par défaut : `$N8N_USER_FOLDER/.alexa-cookie.json`)
+   - **Amazon Service Host** : Sélectionnez votre région (ex. : `pitangui.amazon.com` pour les USA)
+   - **Amazon Page** : Sélectionnez votre domaine Amazon (ex. : `amazon.fr`)
+   - **Language** : Sélectionnez votre langue (ex. : `en-US`)
+3. Sauvegardez les identifiants et ajoutez un nœud **Alexa Remote** avec **Resource** : `Auth`, **Operation** : `Authenticate`
+4. Lancez le workflow — le proxy démarre et affiche une URL de connexion dans les logs
+5. Ouvrez l'URL dans votre navigateur et connectez-vous avec votre compte Amazon
+6. Une fois connecté, le cookie est sauvegardé et les identifiants sont prêts
+
+Le cookie sera automatiquement renouvelé selon le paramètre **Refresh Interval**.
+
+### Tous les champs des identifiants
+
+| Champ | Description | Défaut |
+|---|---|---|
+| **Proxy IP** | IP de votre serveur n8n | `localhost` |
+| **Proxy Port** | Port du proxy | `3456` |
+| **Cookie File Path** | Chemin pour sauvegarder/lire le fichier cookie JSON | `$N8N_USER_FOLDER/.alexa-cookie.json` |
+| **Amazon Service Host** | Endpoint du service Alexa pour votre région | `pitangui.amazon.com` |
+| **Amazon Page** | Domaine Amazon pour votre région | `amazon.com` |
+| **Language** | Valeur du header Accept-Language | `en-US` |
+| **Refresh Interval (Days)** | Intervalle de renouvellement automatique du cookie | `3` |
+
+### Régions supportées
+
+| Région | Amazon Service Host | Amazon Page |
+|---|---|---|
+| USA | `pitangui.amazon.com` | `amazon.com` |
+| UK | `alexa.amazon.co.uk` | `amazon.co.uk` |
+| Allemagne | `layla.amazon.de` | `amazon.de` |
+| France | `layla.amazon.de` | `amazon.fr` |
+| Italie | `alexa.amazon.it` | `amazon.it` |
+| Espagne | `alexa.amazon.es` | `amazon.es` |
+| Australie | `alexa.amazon.com.au` | `amazon.com.au` |
+| Brésil | `alexa.amazon.com.br` | `amazon.com.br` |
+
+## Compatibilité
+
+- Version minimale de n8n : 1.0.0
+- Testé avec n8n : 2.13.1
+- Nécessite Node.js : ≥18.0.0
+
+## Utilisation
+
+### Exemple 1 : Première authentification
+
+1. Ajoutez un nœud **Alexa Remote**
+2. Sélectionnez **Resource** : `Auth`, **Operation** : `Authenticate`
+3. Définissez **Login Timeout** (minutes) — défaut : 5
+4. Lancez le workflow et ouvrez l'URL affichée dans les logs
+5. Connectez-vous avec votre compte Amazon
+6. Le cookie est sauvegardé — vous n'aurez pas besoin de recommencer sauf si la session expire
+
+### Exemple 2 : Faire parler Alexa
+
+1. Ajoutez un nœud **Alexa Remote**
+2. Sélectionnez **Resource** : `Interaction`, **Operation** : `Speak`
+3. Sélectionnez votre appareil dans la liste déroulante
+4. Entrez le texte : `Bonjour depuis n8n !`
+5. Exécutez le workflow
+
+### Exemple 3 : Faire parler plusieurs appareils simultanément
+
+1. Ajoutez un nœud **Alexa Remote**
+2. Sélectionnez **Resource** : `Interaction`, **Operation** : `Speak All (Multi-Device)`
+3. Sélectionnez plusieurs appareils dans la liste déroulante
+4. Entrez le texte et le type de parole
+5. Exécutez
+
+### Exemple 4 : Lire de la musique
+
+1. Ajoutez un nœud **Alexa Remote**
+2. Sélectionnez **Resource** : `Interaction`, **Operation** : `Play Music`
+3. Sélectionnez votre appareil
+4. Sélectionnez **Music Provider** : `Amazon Music`
+5. Entrez **Search Query** : `jazz relaxant`
+6. Exécutez
+
+### Exemple 5 : Contrôler un appareil domotique
+
+1. Ajoutez un nœud **Alexa Remote**
+2. Sélectionnez **Resource** : `Smarthome`, **Operation** : `Control Device`
+3. Sélectionnez l'entité dans la liste déroulante (ex. : `Lampe Salon`)
+4. Sélectionnez **Action** : `Set Brightness`
+5. Entrez **Value** : `75`
+6. Exécutez
+
+### Exemple 6 : Créer un rappel
+
+1. Ajoutez un nœud **Alexa Remote**
+2. Sélectionnez **Resource** : `Notification`, **Operation** : `Create Notification`
+3. Sélectionnez votre appareil
+4. Sélectionnez **Type** : `Reminder`
+5. Entrez **Label** : `Sortir les poubelles`
+6. Entrez **Time** : `2026-03-20T18:00:00.000` (format ISO 8601)
+7. Exécutez
+
+### Exemple 7 : Déclencher sur une activité vocale
+
+1. Ajoutez un nœud **Alexa Remote Trigger**
+2. Sélectionnez **Event** : `Device Activity`
+3. Activez le workflow
+4. Chaque fois qu'une commande vocale est enregistrée sur un appareil Echo, le workflow se lance
+
+### Exemple 8 : Exécuter une routine existante
+
+1. Ajoutez un nœud **Alexa Remote**
+2. Sélectionnez **Resource** : `Routine`, **Operation** : `Execute Routine`
+3. Sélectionnez votre routine dans la liste déroulante
+4. Exécutez
+
+## Dépannage
+
+### Problèmes d'authentification
+
+- **Fichier cookie introuvable** : Exécutez d'abord l'opération `Auth → Authenticate` pour compléter la connexion Amazon
+- **Le fichier cookie n'est pas un JSON valide** : Le fichier cookie est corrompu — relancez l'authentification
+- **Erreur "no csrf"** : La session a expiré, relancez `Auth → Authenticate`
+- **"401 Unauthorized"** : Cookie invalide ou expiré
+- **Le proxy ne démarre pas** : Vérifiez que le port configuré n'est pas déjà utilisé
+
+### Appareil introuvable
+
+- Les appareils sont chargés dynamiquement depuis votre compte — exécutez d'abord `Auth → Authenticate`
+- Utilisez le numéro de série directement via une expression n8n si la liste déroulante est vide
+- Obtenez les numéros de série via l'opération `Device → Get Devices`
+
+### Les commandes ne fonctionnent pas
+
+- Vérifiez que l'appareil est en ligne et connecté
+- Certaines commandes (ex. : `next`, `previous`) nécessitent que l'appareil soit en cours de lecture
+- Vérifiez que votre compte Amazon a accès à l'appareil
+
+### Le déclencheur ne se lance pas
+
+- Vérifiez que la connexion WebSocket est établie (consultez les logs n8n)
+- L'événement `All Messages` peut être utilisé pour déboguer — il se déclenche sur chaque événement entrant
+
+## Ressources
+
+- [Documentation des nœuds communautaires n8n](https://docs.n8n.io/integrations/#community-nodes)
+- [Bibliothèque Alexa Remote 2](https://www.npmjs.com/package/alexa-remote2)
+- [Implémentation Node-RED originale](https://github.com/bbindreiter/node-red-contrib-alexa-remote2-applestrudel)
+
+## Crédits
+
+Ce projet est inspiré de l'excellent projet [node-red-contrib-alexa-remote2-applestrudel](https://github.com/bbindreiter/node-red-contrib-alexa-remote2-applestrudel) de bbindreiter, qui utilise la bibliothèque [alexa-remote2](https://www.npmjs.com/package/alexa-remote2).
+
+## Licence
+
+[MIT](LICENSE)
+
+## Auteur
+
+**Développé avec ❤️ par [AC-CodeProd](https://github.com/AC-CodeProd)**

package/README.md

@@ -0,0 +1,300 @@
+# @ac-codeprod/n8n-nodes-alexa-remote
+
+[![n8n community node](https://img.shields.io/badge/n8n-community%20node-orange?logo=n8n)](https://docs.n8n.io/integrations/community-nodes/installation/)
+[![npm version](https://img.shields.io/npm/v/@ac-codeprod/n8n-nodes-alexa-remote)](https://www.npmjs.com/package/@ac-codeprod/n8n-nodes-alexa-remote)
+[![npm downloads](https://img.shields.io/npm/dm/@ac-codeprod/n8n-nodes-alexa-remote)](https://www.npmjs.com/package/@ac-codeprod/n8n-nodes-alexa-remote)
+[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+This is an n8n community node package that lets you interact with the Amazon Alexa API in your n8n workflows. It provides two nodes:
+
+- **Alexa Remote** — action node to control devices, execute routines, manage lists, notifications, and more.
+- **Alexa Remote Trigger** — trigger node that starts a workflow when an Alexa WebSocket push event occurs.
+
+Alexa Remote provides programmatic access to control Echo devices, execute routines, manage smart home devices, and more — all without saying "Alexa"!
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/sustainable-use-license/) workflow automation platform.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Nodes](#nodes)
+- [Operations](#operations)
+- [Trigger Events](#trigger-events)
+- [Credentials](#credentials)
+- [Compatibility](#compatibility)
+- [Usage](#usage)
+- [Troubleshooting](#troubleshooting)
+- [Resources](#resources)
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+### Quick Installation
+
+```bash
+npm install @ac-codeprod/n8n-nodes-alexa-remote
+```
+
+## Nodes
+
+### Alexa Remote
+
+An action node to interact with the Alexa API. Supports 10 resources and can also be used as an AI tool.
+
+### Alexa Remote Trigger
+
+A trigger node that listens for real-time Alexa WebSocket push events and starts your workflow when they occur.
+
+## Operations
+
+### Account
+- **Get Accounts** — Get account information
+- **Get Contacts** — Get your Alexa contacts
+- **Get Music Providers** — List available music streaming services
+- **Get Routines** — Get all automation routines
+
+### Auth
+- **Authenticate** — Start the proxy and wait for Amazon login. Open your browser at `http://[Proxy IP]:[Proxy Port]` when the workflow is running. A **Login Timeout (Minutes)** parameter controls how long to wait (default: 5 min).
+
+### Bluetooth ⚠️ Untested
+
+> **Warning**: Bluetooth operations have not been tested yet. They are available in the code but their behavior is not guaranteed.
+
+- **Get State** — Get paired Bluetooth devices and connection state
+- **Connect** — Connect to a paired Bluetooth device (requires MAC address)
+- **Disconnect** — Disconnect the current Bluetooth device
+- **Unpair** — Unpair a Bluetooth device (requires MAC address)
+
+### Conversation
+- **Get Conversations** — Get Alexa conversations (optionally filter unread only)
+- **Send Message** — Send a text message to a conversation
+
+### Device (Echo)
+- **Get Devices** — List all your Echo devices
+- **Get Device Info** — Get detailed information about a specific device
+- **Get Player Info** — Get current player info (track, state, volume…)
+- **Get Player Queue** — Get the current playback queue
+- **Send Command** — Send a media command to a device: `play`, `pause`, `next`, `previous`, `forward`, `rewind`, `repeat`, `shuffle`
+- **Set Do Not Disturb** — Enable or disable Do Not Disturb mode
+
+### Interaction
+- **Speak** — Make Alexa speak text (regular, SSML, or announcement)
+- **Speak All (Multi-Device)** — Make multiple Echo devices speak in parallel
+- **Speak At Volume** — Make Alexa speak at a specific volume level
+- **Text Command** — Send a text command to Alexa (like asking her something)
+- **Stop** — Stop playback on a device
+- **Set Volume** — Change device volume (0–100)
+- **Play Music** — Play music from a provider (Amazon Music, Spotify, TuneIn, Cloud Player)
+- **Builtin** — Play a built-in Alexa action: Weather, Traffic, Flash Briefing, Good Morning, Fun Fact, Joke, Clean Up, Sing a Song, Tell Story, Calendar (Today / Tomorrow / Next)
+- **Sound** — Play a sound effect by sound string ID (e.g., `amzn1.ask.1p.sound/nature/crickets_01`)
+- **Wait** — Wait a given number of seconds (useful in sequence workflows)
+
+### List
+- **Get Lists** — Get all Alexa lists (shopping, to-do, and custom)
+- **Add Item** — Add an item to a list
+- **Remove Item** — Remove an item from a list
+- **Create List** — Create a new custom list
+- **Delete List** — Delete a list
+
+### Notification
+- **Get Notifications** — List all notifications (alarms, reminders, timers)
+- **Create Notification** — Create an alarm, reminder, or timer
+- **Delete Notification** — Remove a notification by ID
+
+### Routine
+- **Execute Routine** — Run an existing Alexa automation routine (selected from a dropdown)
+
+### Smarthome
+- **Get Devices** — List all connected smart home devices
+- **Control Device** — Control a smart home device: Turn On, Turn Off, Set Brightness, Set Color, Set Temperature
+
+## Trigger Events
+
+The **Alexa Remote Trigger** node listens for the following WebSocket push events:
+
+| Event | Description |
+|---|---|
+| **All Messages** | Fires on every WebSocket event received from Alexa |
+| **All Unknown Messages** | Fires on every unrecognized WebSocket message |
+| **Audio Player State Change** | Fires when media playback state changes on an Echo device |
+| **Bluetooth State Change** | Fires when a Bluetooth connection state changes |
+| **Device Activity** | Fires when an Echo device registers an activity (voice command, etc.) |
+| **Device Connection Change** | Fires when an Echo device goes online or offline |
+| **Media Change** | Fires when the currently playing media changes |
+| **Notification Change** | Fires when an Alexa notification (alarm, reminder) changes |
+| **Todo / List Change** | Fires when an Alexa shopping or to-do list changes |
+| **Volume Change** | Fires when the volume of an Echo device changes |
+
+Each trigger emits a JSON payload with `event`, `payload`, and `timestamp` fields.
+
+## Credentials
+
+To use this node, you need to configure **Alexa Remote API** credentials.
+
+### Prerequisites
+
+1. An Amazon account with Alexa devices registered
+2. Access to your n8n server's IP address (for proxy authentication)
+
+### Setup
+
+1. In n8n, create new "Alexa Remote API" credentials
+2. Configure the following:
+   - **Proxy IP**: Your n8n server's IP address (e.g., `192.168.1.100`)
+   - **Proxy Port**: Port for authentication (default: `3456`)
+   - **Cookie File Path**: Path to save authentication cookie (defaults to `$N8N_USER_FOLDER/.alexa-cookie.json`)
+   - **Amazon Service Host**: Select your region (e.g., `pitangui.amazon.com` for USA)
+   - **Amazon Page**: Select your Amazon domain (e.g., `amazon.com`)
+   - **Language**: Select your language (e.g., `en-US`)
+3. Save credentials and add an **Alexa Remote** node with **Resource**: `Auth`, **Operation**: `Authenticate`
+4. Run the workflow — the proxy will start and display a login URL in the logs
+5. Open the URL in your browser and log in with your Amazon account
+6. Once login is complete, the cookie is saved and credentials are ready
+
+The cookie will be automatically refreshed according to the **Refresh Interval** setting.
+
+### All Credential Fields
+
+| Field | Description | Default |
+|---|---|---|
+| **Proxy IP** | IP of your n8n server | `localhost` |
+| **Proxy Port** | Proxy port | `3456` |
+| **Cookie File Path** | Path to save/read the cookie JSON file | `$N8N_USER_FOLDER/.alexa-cookie.json` |
+| **Amazon Service Host** | Alexa service endpoint for your region | `pitangui.amazon.com` |
+| **Amazon Page** | Amazon domain for your region | `amazon.com` |
+| **Language** | Accept-Language header value | `en-US` |
+| **Refresh Interval (Days)** | Auto-refresh cookie interval | `3` |
+
+### Supported Regions
+
+| Region | Amazon Service Host | Amazon Page |
+|---|---|---|
+| USA | `pitangui.amazon.com` | `amazon.com` |
+| UK | `alexa.amazon.co.uk` | `amazon.co.uk` |
+| Germany | `layla.amazon.de` | `amazon.de` |
+| France | `layla.amazon.de` | `amazon.fr` |
+| Italy | `alexa.amazon.it` | `amazon.it` |
+| Spain | `alexa.amazon.es` | `amazon.es` |
+| Australia | `alexa.amazon.com.au` | `amazon.com.au` |
+| Brazil | `alexa.amazon.com.br` | `amazon.com.br` |
+
+## Compatibility
+
+- Minimum n8n version: 1.0.0
+- Tested with n8n: 2.13.1
+- Requires Node.js: ≥18.0.0
+
+## Usage
+
+### Example 1: First-time Authentication
+
+1. Add an **Alexa Remote** node
+2. Select **Resource**: `Auth`, **Operation**: `Authenticate`
+3. Set **Login Timeout** (minutes) — default is 5
+4. Run the workflow and open the URL shown in the logs
+5. Log in with your Amazon account
+6. The cookie is saved — you won't need to redo this unless the session expires
+
+### Example 2: Make Alexa Speak
+
+1. Add an **Alexa Remote** node
+2. Select **Resource**: `Interaction`, **Operation**: `Speak`
+3. Select your device from the dropdown
+4. Enter text: `Hello from n8n!`
+5. Execute the workflow
+
+### Example 3: Speak on Multiple Devices Simultaneously
+
+1. Add an **Alexa Remote** node
+2. Select **Resource**: `Interaction`, **Operation**: `Speak All (Multi-Device)`
+3. Select multiple devices from the dropdown
+4. Enter text and speak type
+5. Execute
+
+### Example 4: Play Music
+
+1. Add an **Alexa Remote** node
+2. Select **Resource**: `Interaction`, **Operation**: `Play Music`
+3. Select your device
+4. Select **Music Provider**: `Amazon Music`
+5. Enter **Search Query**: `relaxing jazz`
+6. Execute
+
+### Example 5: Control a Smart Home Device
+
+1. Add an **Alexa Remote** node
+2. Select **Resource**: `Smarthome`, **Operation**: `Control Device`
+3. Select the entity from the dropdown (e.g., `Living Room Lights`)
+4. Select **Action**: `Set Brightness`
+5. Enter **Value**: `75`
+6. Execute
+
+### Example 6: Create a Reminder
+
+1. Add an **Alexa Remote** node
+2. Select **Resource**: `Notification`, **Operation**: `Create Notification`
+3. Select your device
+4. Select **Type**: `Reminder`
+5. Enter **Label**: `Take out trash`
+6. Enter **Time**: `2026-03-20T18:00:00.000` (ISO 8601 format)
+7. Execute
+
+### Example 7: Trigger on Device Activity
+
+1. Add an **Alexa Remote Trigger** node
+2. Select **Event**: `Device Activity`
+3. Activate the workflow
+4. Every time a voice command is registered on any Echo device, the workflow runs
+
+### Example 8: Execute an Existing Routine
+
+1. Add an **Alexa Remote** node
+2. Select **Resource**: `Routine`, **Operation**: `Execute Routine`
+3. Select your routine from the dropdown
+4. Execute
+
+## Troubleshooting
+
+### Authentication Issues
+
+- **Cookie file not found**: Run the `Auth → Authenticate` operation first to complete Amazon login
+- **Cookie file is not valid JSON**: The cookie file was corrupted — re-run authentication
+- **"no csrf" error**: Session expired, re-run `Auth → Authenticate`
+- **"401 Unauthorized"**: Invalid or expired cookie
+- **Proxy doesn't start**: Check that the configured port is not already in use
+
+### Device Not Found
+
+- Devices are loaded dynamically from your account — run `Auth → Authenticate` first
+- Use the serial number directly via an n8n expression if the dropdown is empty
+- Get serial numbers using the `Device → Get Devices` operation
+
+### Commands Don't Work
+
+- Ensure the device is online and connected
+- Some commands (e.g., `next`, `previous`) require the device to be actively playing media
+- Check that your Amazon account has access to the device
+
+### Trigger Not Firing
+
+- Verify the WebSocket connection is established (check n8n logs)
+- The `All Messages` event can be used to debug — it fires on every incoming event
+
+## Resources
+
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
+- [Alexa Remote 2 Library](https://www.npmjs.com/package/alexa-remote2)
+- [Original Node-RED Implementation](https://github.com/bbindreiter/node-red-contrib-alexa-remote2-applestrudel)
+
+## Credits
+
+This project is inspired by the excellent [node-red-contrib-alexa-remote2-applestrudel](https://github.com/bbindreiter/node-red-contrib-alexa-remote2-applestrudel) project by bbindreiter, which uses the [alexa-remote2](https://www.npmjs.com/package/alexa-remote2) library.
+
+## License
+
+[MIT](LICENSE)
+
+## Author
+
+**Developed with ❤️ by [AC-CodeProd](https://github.com/AC-CodeProd)**

package/dist/credentials/AlexaRemoteApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class AlexaRemoteApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    testedBy: string;
+    icon: "file:alexa.svg";
+    documentationUrl: string;
+    properties: INodeProperties[];
+}