# Intégrations prêtes — galerie

Voici dix projets prêts à l'emploi pour des cas d'usage typiques. Chaque recette tient en un seul fichier, sans étape de build. Il te suffit d'y coller ta clé API → lance avec `npx tsx` ou `python` → c'est parti.

Tous les exemples ci-dessous sont prêts à copier-coller : la clé passe via l'en-tête `X-Api-Key`, les requêtes utilisent `fetch` ou `requests`. Des SDK TypeScript/Python sont prévus — pour l'instant, ça suffit.

## Que trouve-t-on dans la galerie

| # | Recette | Stack | Cas d'usage |
|---|---|---|---|
| 1 | Horoscope quotidien par SMS | Twilio + Node.js | Cron qui envoie l'horoscope quotidien aux utilisateurs par SMS |
| 2 | Bot Discord `/chart` | discord.js | Commande slash — n'importe qui dans le salon génère une carte natale |
| 3 | Appel de fonction OpenAI | openai + Node.js | GPT appelle lui-même l'API pour récupérer les cartes via un tool call |
| 4 | Bot Slack `/synastry` | @slack/bolt | Commande slash pour évaluer la compatibilité d'un simple trait |
| 5 | Enrichissement Notion | @notionhq/client | Date de naissance dans la base → carte natale complète générée automatiquement |
| 6 | Cache Cloudflare Worker | CF Workers KV | Cache edge des requêtes identiques pendant 30 jours |
| 7 | Outils MCP pour Claude | @astroway/mcp | Claude Desktop / Code appelle l'API comme un outil natif |
| 8 | Export des prévisions en CSV | Python + pandas | Prévisions sur 12 mois → CSV pour BI / Tableau |
| 9 | UI de rectification sur Streamlit | Python + Streamlit | Interface interactive pour rectifier l'heure de naissance |
| 10 | Service de compatibilité sur FastAPI | Python + FastAPI | Service HTTP pour les apps de rencontre : 2 cartes → score |

## Comment utiliser

1. Copie le fichier qui t'intéresse dans ton projet.
2. Installe les dépendances indiquées dans l'en-tête (`npm install ...` ou `pip install ...`).
3. Configure les variables d'environnement (au minimum `ASTROWAY_API_KEY`).
4. Lance le script.

## Patterns dans la galerie

- **Script ponctuel** (1, 5, 8) — traitement par lots façon cron.
- **Bot persistant** (2, 4) — connexion permanente, écoute les commandes slash.
- **Service HTTP** (10) — REST drop-in avec ton propre système d'authentification.
- **Fonction edge** (6) — couche de cache entre le client et l'API.
- **Intégration d'outils LLM** (3, 7) — exposition des endpoints comme fonctions pour l'IA.
- **UI** (9) — interfaces front-end interactives.

## Pas encore couvert

Si ton cas d'usage n'est pas dans la liste (par exemple : bot Telegram, workflow n8n, action Zapier, widget intégré sur un site) — **écris-nous à [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** en décrivant ton besoin. On ajoute des recettes à partir des demandes réelles, on ne devine pas.