# Fertige Integrationen — Galerie

## Zehn fertige Projekte für typische Anwendungsfälle

Jedes Rezept ist eine einzelne Datei – ohne Build-Schritt. Du fügst deinen API-Key hinzu → startest mit `npx tsx` oder `python` → und es läuft.

Alle Rezepte unten sind Copy-Paste-fertig: Der Key wird über den `X-Api-Key`-Header übergeben, die Anfragen erfolgen mit Standard-`fetch` oder `requests`. SDKs für TypeScript / Python sind geplant – aktuell reicht das.

## Was dich in der Galerie erwartet

| # | Rezept | Stack | Anwendungsfall |
|---|---|---|---|
| 1 | Tageshoroskop per SMS | Twilio + Node.js | Cron, der täglich das Horoskop an Nutzer:innen per SMS schickt |
| 2 | Discord-Bot `/chart` | discord.js | Slash-Befehl – jede:r im Chat kann eine Geburtskarte erstellen |
| 3 | OpenAI Function-Calling | openai + Node.js | GPT holt sich selbst Karten über Tool-Aufrufe |
| 4 | Slack-Bot `/synastry` | @slack/bolt | Einfacher Befehl fürs Büro, um Kompatibilität zu prüfen |
| 5 | Notion-Anreicherung | @notionhq/client | Geburtsdatum in der Datenbank → automatische Geburtskarte |
| 6 | Cloudflare Worker Cache | CF Workers KV | Edge-Cache identischer Anfragen für 30 Tage |
| 7 | Claude MCP Tools | @astroway/mcp | Claude Desktop / Code ruft die API wie ein natives Tool auf |
| 8 | Horoskop-Prognose als CSV exportieren | Python + pandas | 12-Monats-Prognose → CSV für BI / Tableau |
| 9 | UI für Rectifikation mit Streamlit | Python + Streamlit | Interaktives UI zur Rectifikation der Geburtszeit |
| 10 | Kompatibilitätsdienst mit FastAPI | Python + FastAPI | HTTP-Dienst für Dating-Apps: 2 Karten → Score |

## So verwendest du die Rezepte

1. Kopiere die gewünschte Datei in dein Projekt.
2. Installiere die Abhängigkeiten aus dem Datei-Header (`npm install ...` oder `pip install ...`).
3. Setze die Umgebungsvariablen (mindestens `ASTROWAY_API_KEY`).
4. Starte das Skript.

## Muster in der Galerie

- **Einmal-Skript** (1, 5, 8) – Batch-Verarbeitung im Cron-Stil.
- **Langlebiger Bot** (2, 4) – Dauerhafte Verbindung, hört auf Slash-Befehle.
- **HTTP-Dienst** (10) – Drop-in REST-Dienst mit deiner Autorisierung.
- **Edge-Funktion** (6) – Cache-Schicht zwischen Client und API.
- **LLM-Integration** (3, 7) – Endpunkte als Funktionen für KI verfügbar machen.
- **UI** (9) – Interaktive Frontends.

## Noch nicht abgedeckt?

Falls dein Anwendungsfall nicht in der Liste steht (z. B. Telegram-Bot, n8n-Workflow, Zapier-Aktion, eingebettetes Widget auf einer Website) – **schreib uns eine E-Mail an [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** mit einer Beschreibung. Wir fügen Rezepte basierend auf echten Anfragen hinzu – wir raten nicht.