# Kész integrációk – galéria

Tíz kész recept gyakori forgatókönyvekhez. Minden recept egyetlen fájl, build lépés nélkül. Beilleszted a saját API-kulcsod → futtatsz `npx tsx` vagy `python` → működik.

Az összes recept alább másolás-és-beillesztés-ready: a kulcs az `X-Api-Key` header-ben, a kérések a standard `fetch` vagy `requests` segítségével. A TypeScript / Python SDK tervezés alatt áll – jelenleg ez elegendő.

## Mi van a galériában

| # | Recept | Stack | Use case |
|---|---|---|---|
| 1 | Napi horoszkóp SMS-ben | Twilio + Node.js | Cron, amely napi horoszkópot küld SMS-ben a felhasználóknak |
| 2 | Discord-bot `/chart` | discord.js | Slash-parancs – bárki a chatben születési térképet generálhat |
| 3 | OpenAI function-calling | openai + Node.js | A GPT önállóan kérdez térképeket tool-hívásokon keresztül |
| 4 | Slack-bot `/synastry` | @slack/bolt | A csapat parancsa egyetlen sorban kiértékeli az összeillőséget |
| 5 | Notion adatok gazdagítása | @notionhq/client | Születési dátum az adatbázisban → automatikus teljes natal |
| 6 | Cloudflare Worker cache | CF Workers KV | Edge-cache azonos kérésekre 30 napig |
| 7 | Claude MCP tools | @astroway/mcp | A Claude Desktop / Code az API-t natív eszközként hívja meg |
| 8 | Előrejelzés exportálása CSV-be | Python + pandas | 12 hónapos előrejelzés → CSV BI / Tableau számára |
| 9 | Rektifikációs UI Streamlitben | Python + Streamlit | Interaktív UI a születési idő rektifikációjához |
| 10 | Összeillőségi szolgáltatás FastAPI-vel | Python + FastAPI | HTTP-szolgáltatás randi alkalmazásoknak: 2 térkép → score |

## Hogyan használjam

1. Másold a megfelelő fájlt a projektedbe.
2. Telepítsd a függőségeket a fájl fejlécéből (`npm install ...` vagy `pip install ...`).
3. Állítsd be a környezeti változókat (minimum: `ASTROWAY_API_KEY`).
4. Futtasd.

## Minták a galériában

- **Egyszeri szkript** (1, 5, 8) – batch feldolgozás cron stílusban.
- **Hosszú életű bot** (2, 4) – folyamatos kapcsolat, slash-parancsokat figyel.
- **HTTP-szolgáltatás** (10) – drop-in REST a saját autentikációddal.
- **Edge-függvény** (6) – cache réteg a kliens és az API között.
- **LLM-eszköz integráció** (3, 7) – az endpointok függvényként való kiállítása AI számára.
- **UI** (9) – interaktív front-endek.

## Még nincs lefedve

Ha a forgatókönyved nincs a listában (például: Telegram-bot, n8n workflow, Zapier action, beágyazott widget egy weboldalon) – **írd meg a [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** címen a leírással. A recepteket valós igények alapján adjuk hozzá, nem találgatjuk.