n8n-nodes-opentrivia 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SnakeTech
+
+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.de.md

@@ -0,0 +1,71 @@
+# n8n-nodes-opentrivia
+
+Dies ist ein n8n-Community-Node. Er ermöglicht es, Trivia-Fragen, Kategorien und Sitzungstoken von der [Open Trivia Database](https://opentdb.com) (opentdb.com) in deinen n8n-Workflows abzurufen.
+
+Open Trivia DB ist eine kostenlose, community-basierte Quizfragendatenbank. Es wird kein API-Schlüssel und keine Anmeldedaten benötigt.
+
+[n8n](https://n8n.io/) ist eine Workflow-Automatisierungsplattform mit [Fair-Code-Lizenz](https://docs.n8n.io/reference/license/).
+
+[Installation](#installation)
+[Ressourcen und Operationen](#ressourcen-und-operationen)
+[Anmeldedaten](#anmeldedaten)
+[Hinweise](#hinweise)
+[Kompatibilität](#kompatibilität)
+[Externe Ressourcen](#externe-ressourcen)
+
+## Installation
+
+Folge der [Installationsanleitung](https://docs.n8n.io/integrations/community-nodes/installation/) für n8n-Community-Nodes.
+
+Bei einer selbst gehosteten Instanz kannst du dieses Paket auch in deinen `N8N_CUSTOM_EXTENSIONS`-Ordner legen und n8n neu starten:
+
+```bash
+npm install
+npm run build
+```
+
+## Ressourcen und Operationen
+
+### Question
+
+- **Get Many** — Ruft eine oder mehrere Trivia-Fragen ab.
+  - `Amount` — Anzahl der abzurufenden Fragen (1 bis 50).
+  - `Category` — Trivia-Kategorie (wird dynamisch von der API geladen), oder „Any Category“.
+  - `Difficulty` — Any / Easy / Medium / Hard.
+  - `Type` — Any / Multiple Choice / True-False.
+  - `Session Token` — optionales Token, um wiederholte Fragen zu vermeiden.
+
+### Category
+
+- **Get Many** — Listet alle verfügbaren Trivia-Kategorien auf.
+- **Get Question Count** — Ruft die Anzahl der verfügbaren Fragen für eine bestimmte Kategorie ab (aufgeschlüsselt nach Schwierigkeitsgrad).
+- **Get Global Question Count** — Ruft die Gesamtzahl der verfügbaren Fragen über alle Kategorien hinweg ab.
+
+### Session Token
+
+- **Request** — Fordert ein neues Sitzungstoken an, damit die API nachverfolgen kann, welche Fragen dir bereits geliefert wurden.
+- **Reset** — Setzt ein vorhandenes Sitzungstoken zurück, damit dessen Fragen erneut geliefert werden können.
+
+## Anmeldedaten
+
+Keine. Die Open-Trivia-Database-API ist kostenlos und erfordert keine Authentifizierung.
+
+## Hinweise
+
+- Fragen werden immer base64-kodiert von der API angefordert und vom Node automatisch dekodiert — du erhältst also saubere Texte in der Ausgabe, ohne HTML-Entities (`"`, `'` usw.), die bereinigt werden müssten.
+- Open Trivia DB begrenzt Anfragen auf eine pro 5 Sekunden pro IP-Adresse (Antwortcode 5). Wenn dieses Limit erreicht wird, füge eine Verzögerung zwischen den Anfragen ein.
+- Die maximale Anzahl an Fragen pro Anfrage beträgt 50.
+
+## Kompatibilität
+
+- Erfordert n8n mit `n8nNodesApiVersion` 1.
+- Erfordert Node.js >= 22.
+
+## Externe Ressourcen
+
+- [Dokumentation der Open-Trivia-Database-API](https://opentdb.com/api_config.php)
+- [Dokumentation zu n8n-Community-Nodes](https://docs.n8n.io/integrations/community-nodes/)
+
+## Lizenz
+
+[MIT](LICENSE)

package/README.es.md

@@ -0,0 +1,71 @@
+# n8n-nodes-opentrivia
+
+Este es un nodo comunitario de n8n. Permite obtener preguntas de trivia, categorías y tokens de sesión desde la [Open Trivia Database](https://opentdb.com) (opentdb.com) en tus flujos de trabajo de n8n.
+
+Open Trivia DB es una base de datos de preguntas de trivia gratuita y comunitaria. No se necesita clave de API ni credenciales para usarla.
+
+[n8n](https://n8n.io/) es una plataforma de automatización de flujos de trabajo con licencia [fair-code](https://docs.n8n.io/reference/license/).
+
+[Instalación](#instalación)
+[Recursos y operaciones](#recursos-y-operaciones)
+[Credenciales](#credenciales)
+[Notas](#notas)
+[Compatibilidad](#compatibilidad)
+[Recursos externos](#recursos-externos)
+
+## Instalación
+
+Sigue la [guía de instalación](https://docs.n8n.io/integrations/community-nodes/installation/) de los nodos comunitarios de n8n.
+
+Para una instancia autoalojada, también puedes colocar este paquete en tu carpeta `N8N_CUSTOM_EXTENSIONS` y reiniciar n8n:
+
+```bash
+npm install
+npm run build
+```
+
+## Recursos y operaciones
+
+### Question
+
+- **Get Many** — Obtiene una o varias preguntas de trivia.
+  - `Amount` — número de preguntas a obtener (1 a 50).
+  - `Category` — categoría de trivia (cargada dinámicamente desde la API), o «Any Category».
+  - `Difficulty` — Any / Easy / Medium / Hard.
+  - `Type` — Any / Multiple Choice / True-False.
+  - `Session Token` — token opcional para evitar recibir preguntas repetidas.
+
+### Category
+
+- **Get Many** — Lista todas las categorías de trivia disponibles.
+- **Get Question Count** — Obtiene el número de preguntas disponibles para una categoría dada (desglosado por dificultad).
+- **Get Global Question Count** — Obtiene el número total de preguntas disponibles en todas las categorías.
+
+### Session Token
+
+- **Request** — Solicita un nuevo token de sesión para que la API pueda rastrear qué preguntas ya te ha servido.
+- **Reset** — Reinicia un token de sesión existente para que sus preguntas puedan servirse de nuevo.
+
+## Credenciales
+
+Ninguna. La API de Open Trivia Database es gratuita y no requiere autenticación.
+
+## Notas
+
+- Las preguntas siempre se solicitan a la API con codificación base64 y el nodo las decodifica automáticamente, por lo que obtienes texto limpio en la salida, sin entidades HTML (`"`, `'`, etc.) que limpiar.
+- Open Trivia DB limita las solicitudes a una cada 5 segundos por dirección IP (código de respuesta 5). Si alcanzas este límite, añade una pausa entre solicitudes.
+- El número máximo de preguntas por solicitud es 50.
+
+## Compatibilidad
+
+- Requiere n8n con `n8nNodesApiVersion` 1.
+- Requiere Node.js >= 22.
+
+## Recursos externos
+
+- [Documentación de la API de Open Trivia Database](https://opentdb.com/api_config.php)
+- [Documentación de nodos comunitarios de n8n](https://docs.n8n.io/integrations/community-nodes/)
+
+## Licencia
+
+[MIT](LICENSE)

package/README.fr.md

@@ -0,0 +1,71 @@
+# n8n-nodes-opentrivia
+
+Ce package est un node communautaire n8n. Il permet de récupérer des questions de culture générale, des catégories et des jetons de session depuis l'[Open Trivia Database](https://opentdb.com) (opentdb.com) dans vos workflows n8n.
+
+Open Trivia DB est une base de questions de quiz gratuite et communautaire. Aucune clé d'API ni identifiant n'est nécessaire pour l'utiliser.
+
+[n8n](https://n8n.io/) est une plateforme d'automatisation de workflows sous licence [fair-code](https://docs.n8n.io/reference/license/).
+
+[Installation](#installation)
+[Ressources et opérations](#ressources-et-opérations)
+[Identifiants](#identifiants)
+[Remarques](#remarques)
+[Compatibilité](#compatibilité)
+[Ressources externes](#ressources-externes)
+
+## Installation
+
+Suivez le [guide d'installation](https://docs.n8n.io/integrations/community-nodes/installation/) des nodes communautaires n8n.
+
+Pour une instance auto-hébergée, vous pouvez aussi placer ce package dans votre dossier `N8N_CUSTOM_EXTENSIONS` et redémarrer n8n :
+
+```bash
+npm install
+npm run build
+```
+
+## Ressources et opérations
+
+### Question
+
+- **Get Many** — Récupère une ou plusieurs questions de quiz.
+  - `Amount` — nombre de questions à récupérer (1 à 50).
+  - `Category` — catégorie de quiz (chargée dynamiquement depuis l'API), ou « Any Category ».
+  - `Difficulty` — Any / Easy / Medium / Hard.
+  - `Type` — Any / Multiple Choice / True-False.
+  - `Session Token` — jeton optionnel pour éviter de recevoir des questions déjà servies.
+
+### Category
+
+- **Get Many** — Liste toutes les catégories de quiz disponibles.
+- **Get Question Count** — Récupère le nombre de questions disponibles pour une catégorie donnée (détaillé par difficulté).
+- **Get Global Question Count** — Récupère le nombre total de questions disponibles sur toutes les catégories.
+
+### Session Token
+
+- **Request** — Demande un nouveau jeton de session pour que l'API puisse suivre les questions déjà servies.
+- **Reset** — Réinitialise un jeton de session existant pour que ses questions puissent être servies à nouveau.
+
+## Identifiants
+
+Aucun. L'API Open Trivia Database est gratuite et ne nécessite pas d'authentification.
+
+## Remarques
+
+- Les questions sont toujours demandées à l'API avec un encodage base64, puis décodées automatiquement par le node : vous obtenez donc un texte propre en sortie, sans entités HTML (`"`, `'`, etc.) à nettoyer.
+- Open Trivia DB limite les requêtes à une par 5 secondes par adresse IP (code de réponse 5). Si vous atteignez cette limite, ajoutez un délai entre vos requêtes.
+- Le nombre maximum de questions par requête est de 50.
+
+## Compatibilité
+
+- Nécessite n8n avec `n8nNodesApiVersion` 1.
+- Nécessite Node.js >= 22.
+
+## Ressources externes
+
+- [Documentation de l'API Open Trivia Database](https://opentdb.com/api_config.php)
+- [Documentation des nodes communautaires n8n](https://docs.n8n.io/integrations/community-nodes/)
+
+## Licence
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,71 @@
+# n8n-nodes-opentrivia
+
+This is an n8n community node. It lets you fetch trivia questions, categories, and session tokens from the [Open Trivia Database](https://opentdb.com) (opentdb.com) in your n8n workflows.
+
+Open Trivia DB is a free, community-driven trivia question database. No API key or credentials are required to use it.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+[Installation](#installation)
+[Resources & Operations](#resources--operations)
+[Credentials](#credentials)
+[Notes](#notes)
+[Compatibility](#compatibility)
+[Resources](#resources)
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) for n8n community nodes.
+
+For a self-hosted instance, you can also drop this package into your `N8N_CUSTOM_EXTENSIONS` folder and restart n8n:
+
+```bash
+npm install
+npm run build
+```
+
+## Resources & Operations
+
+### Question
+
+- **Get Many** — Fetch one or more trivia questions.
+  - `Amount` — number of questions to fetch (1–50).
+  - `Category` — trivia category (loaded dynamically from the API), or "Any Category".
+  - `Difficulty` — Any / Easy / Medium / Hard.
+  - `Type` — Any / Multiple Choice / True-False.
+  - `Session Token` — optional token to avoid getting repeated questions.
+
+### Category
+
+- **Get Many** — List all available trivia categories.
+- **Get Question Count** — Get the number of questions available for a given category (broken down by difficulty).
+- **Get Global Question Count** — Get the total number of questions available across all categories.
+
+### Session Token
+
+- **Request** — Request a new session token so the API can track which questions it has already served you.
+- **Reset** — Reset an existing session token so its questions can be served again.
+
+## Credentials
+
+None. The Open Trivia Database API is free and does not require authentication.
+
+## Notes
+
+- Questions are always requested from the API with base64 encoding and decoded automatically by the node, so you get clean text in your output — no HTML entities (`"`, `'`, etc.) to clean up.
+- Open Trivia DB rate-limits requests to one per 5 seconds per IP address (response code 5). If you hit this, add a delay between requests.
+- The maximum number of questions per request is 50.
+
+## Compatibility
+
+- Requires n8n with `n8nNodesApiVersion` 1.
+- Requires Node.js >= 22.
+
+## Resources
+
+- [Open Trivia Database API documentation](https://opentdb.com/api_config.php)
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+
+## License
+
+[MIT](LICENSE)