Automatisation hebdomadaire (avancé)

Popotam ne génère pas tes repas dans le cloud : c'est zéro coût et anonyme, parce que c'est ton IA gratuite qui fait le travail, et toi qui colles le résultat. Cette page explique comment automatiser ce collage chaque semaine, pour ne plus rien avoir à faire.

Le principe : tu branches ton propre planificateur (une tâche Claude Code, une GitHub Action, n8n, un simple cron + curl…). Popotam ne stocke aucune clé d'IA et n'en paie aucune : la clé éventuelle reste chez toi, sur ton outil.

Toujours 100 % gratuit

Quelle que soit la méthode, c'est ta clé d'IA (souvent gratuite) qui travaille. Popotam ne voit jamais ta clé et ne facture rien.

Comment ça marche, en 3 étapes

Active l'automatisation

Dans l'app, onglet « Données » › « Automatisation hebdo (avancé) ». Popotam te donne un jeton secret et deux URLs.

Mets en place un déclencheur

Chez toi (le lundi, par exemple, pour avoir toute la semaine de marge) : il récupère le prompt, le donne à ton IA, puis renvoie la réponse à Popotam.

C'est servi

Le planning de la semaine prochaine apparaît tout seul dans ton espace. Tu n'as plus rien à coller.

Les deux endpoints

Tout passe par deux adresses, personnalisées avec ton jeton. La première te donne le prompt à faire tourner ; la seconde reçoit le résultat.

1. Récupérer le prompt

GET https://popotam.fr/api/auto/<TON_JETON>/prompt

Réponse JSON :

réponse.jsonjson

{
  "prompt": "...",
  "semaine_du": "AAAA-MM-JJ"
}

Le prompt contient déjà tes préférences (restrictions, budget, portions) et ton historique récent, pour éviter les répétitions. Ton IA n'a aucune règle à connaître : elle exécute le prompt tel quel.

2. Renvoyer la semaine

POST https://popotam.fr/api/auto/<TON_JETON>/week

Corps de la requête = la réponse brute de ton IA (texte ou JSON, peu importe). Popotam extrait le JSON tout seul, exactement comme lors du collage manuel.

réponse.jsonjson

{
  "ok": true,
  "semaine_du": "AAAA-MM-JJ",
  "repas": 14
}

Bon à savoir

Le serveur fusionne uniquement la semaine prochaine (le planning suivant) : tes préférences et ton historique ne sont jamais touchés.

Sécurité (important)

Le jeton est une capacité limitée : il permet seulement de récupérer le prompt et de soumettre une semaine. Il ne permet pas de lire tes données, ni de supprimer ton espace, ni de changer tes préférences.

Garde-le secret quand même. Tu peux le régénérer ou le désactiver à tout moment : un nouveau jeton invalide immédiatement l'ancien.
Ne mets jamais ce jeton dans un dépôt public en clair.
Range-le dans les secrets de ton outil : secrets GitHub Actions, variables d'environnement, coffre de n8n, etc.

Ne committe jamais un secret

Jeton Popotam et clé d'IA vivent dans des variables d'environnement ou des secrets, jamais en dur dans un fichier versionné.

Recettes prêtes à l'emploi

Trois manières de faire, de la plus générique à la plus « zéro budget ». Pour chacune, rappelle-toi : c'est 100 % côté utilisateur, Popotam ne voit jamais ta clé d'IA.

Recette A · cron + curl (générique)

Un script bash lancé une fois par semaine par ton cron. Ton jeton Popotam et la clé de ton IA vivent dans des variables d'environnement, jamais en dur dans le fichier.

popotam-hebdo.shbash

#!/usr/bin/env bash
set -euo pipefail

# Variables d'environnement (à définir dans ton cron ou ton shell) :
#   POPOTAM_TOKEN : ton jeton Popotam (<TON_JETON>)
#   AI_API_KEY    : la clé de TON IA (la tienne, jamais celle de Popotam)

BASE="https://popotam.fr/api/auto/${POPOTAM_TOKEN}"

# 1. Récupérer le prompt déjà prêt (préférences + historique inclus)
PROMPT=$(curl -fsS "${BASE}/prompt" | jq -r '.prompt')

# 2. Donner ce prompt à TON IA.
#    Exemple avec l'API Anthropic Messages (la clé AI_API_KEY est la TIENNE) :
REPONSE=$(curl -fsS https://api.anthropic.com/v1/messages \
  -H "x-api-key: ${AI_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "$(jq -n --arg p "$PROMPT" '{
        model: "claude-sonnet-4-5",
        max_tokens: 4096,
        messages: [ { role: "user", content: $p } ]
      }')" \
  | jq -r '.content[0].text')

# 3. Renvoyer la réponse brute à Popotam (il extrait le JSON tout seul)
curl -fsS -X POST "${BASE}/week" \
  -H "content-type: text/plain" \
  --data-raw "$REPONSE"

Recette B · tâche Claude Code programmée

Si tu utilises Claude Code, tu peux lui confier une tâche planifiée hebdomadaire (le lundi). Pas besoin de gérer une clé d'API toi-même : c'est Claude Code qui exécute le prompt. L'instruction tient en une phrase.

tâche-hebdo.txtprompt

Chaque lundi à 9h :
récupère le prompt depuis GET https://popotam.fr/api/auto/<TON_JETON>/prompt,
génère le planning de la semaine en respectant exactement ce prompt,
puis POST le résultat JSON sur https://popotam.fr/api/auto/<TON_JETON>/week.

Zéro clé à gérer

Là encore, Popotam ne voit aucune clé : c'est ta session Claude Code, chez toi, qui fait tout le travail.

Recette C · GitHub Action gratuit + clé Gemini gratuite

Le combo le plus économique : une GitHub Action (gratuite) qui appelle l'API Gemini avec une clé gratuite obtenue sur Google AI Studio. Range POPOTAM_TOKEN et GEMINI_API_KEY dans les secrets GitHub de ton dépôt.

.github/workflows/popotam.ymlyaml

name: Popotam · planning hebdo

on:
  schedule:
    # Tous les lundis à 07:00 UTC (cron est en UTC) ; ajuste à ton goût
    - cron: "0 7 * * 1"
  workflow_dispatch: {}   # permet aussi un lancement manuel

jobs:
  generer:
    runs-on: ubuntu-latest
    steps:
      - name: Récupérer le prompt, appeler Gemini, renvoyer la semaine
        env:
          POPOTAM_TOKEN: ${{ secrets.POPOTAM_TOKEN }}
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
        run: |
          set -euo pipefail
          BASE="https://popotam.fr/api/auto/${POPOTAM_TOKEN}"

          # 1. Prompt déjà prêt côté Popotam
          PROMPT=$(curl -fsS "${BASE}/prompt" | jq -r '.prompt')

          # 2. Appel à Gemini avec TA clé gratuite
          REPONSE=$(curl -fsS \
            "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=${GEMINI_API_KEY}" \
            -H "content-type: application/json" \
            -d "$(jq -n --arg p "$PROMPT" '{ contents: [ { parts: [ { text: $p } ] } ] }')" \
            | jq -r '.candidates[0].content.parts[0].text')

          # 3. Renvoi à Popotam (extraction du JSON automatique)
          curl -fsS -X POST "${BASE}/week" \
            -H "content-type: text/plain" \
            --data-raw "$REPONSE"

La clé reste chez toi

La clé Gemini vit dans les secrets GitHub de ton dépôt. Popotam ne la reçoit jamais et n'en a pas besoin.

Limites honnêtes

Pour automatiser, il te faut un déclencheur capable d'exécuter une IA (un cron, une GitHub Action, une tâche Claude Code…). Une IA de chat web, ouverte dans ton navigateur, ne peut pas se lancer toute seule chaque semaine : c'est précisément pour ça que cette page est marquée « avancé ».

Pas envie d'automatiser ?

Ce n'est pas grave : le rappel agenda hebdomadaire, déjà intégré dans l'app, reste la solution la plus simple. Tu reçois ton rappel, tu colles, c'est fait.

Questions fréquentes

Non, jamais. La clé d'IA reste exclusivement sur ton outil (cron, GitHub, Claude Code). Popotam ne reçoit que le résultat final, le planning, exactement comme si tu l'avais collé à la main.

Très peu : seulement récupérer ton prompt et soumettre une semaine. Le jeton ne donne aucun accès à tes données, préférences ou historique. Au moindre doute, régénère-le depuis le panneau : l'ancien est invalidé instantanément.

GitHub Action + Gemini si tu veux le coût le plus bas et un setup « pose et oublie ». Claude Code si tu l'utilises déjà : aucune clé à gérer. cron + curl si tu as un serveur ou un Raspberry qui tourne en continu.

Non. Tu peux POSTer la réponse brute (texte ou JSON, avec ou sans blabla autour). Popotam extrait le JSON automatiquement, comme lors du collage manuel.

Parfaitement valable. Le rappel hebdomadaire intégré à l'app te prévient ; tu ouvres ton IA, tu colles le prompt, tu colles la réponse. Trente secondes, zéro configuration.