# Galeria de integrări pregătite

## Zece proiecte gata făcute pentru scenarii tipice. Fiecare rețetă este un singur fișier, fără pași de build. Introdu cheia ta API → rulează cu `npx tsx` sau `python` → gata.

Toate exemplele de mai jos sunt gata de copiat și lipit: cheia se transmite prin header-ul `X-Api-Key`, iar cererile se fac cu `fetch` standard sau `requests`. SDK-urile pentru TypeScript / Python sunt în plan — pentru moment, acestea sunt suficiente.

## Ce poți găsi în galerie

| # | Rețetă | Tehnologie | Caz de utilizare |
|---|---|---|---|
| 1 | Horoscop zilnic pe SMS | Twilio + Node.js | Cron care trimite horoscopul zilnic utilizatorilor pe SMS |
| 2 | Bot Discord `/chart` | discord.js | Comanda slash — oricine în chat poate genera o hartă natală |
| 3 | Apelare funcțională OpenAI | openai + Node.js | GPT apelează API-ul pentru hărți printr-un tool call |
| 4 | Bot Slack `/synastry` | @slack/bolt | Comanda din birou verifică compatibilitatea cu un singur mesaj |
| 5 | Îmbogățirea Notion | @notionhq/client | Data nașterii în baza de date → hartă natală completă automat |
| 6 | Cache Cloudflare Worker | CF Workers KV | Cache la nivel de edge pentru cereri identice pe 30 de zile |
| 7 | Instrumente MCP pentru Claude | @astroway/mcp | Claude Desktop / Code apelează API-ul ca un instrument nativ |
| 8 | Exportul prognozei în CSV | Python + pandas | Prognoză pe 12 luni → CSV pentru BI / Tableau |
| 9 | UI de rectificare pe Streamlit | Python + Streamlit | Interfață interactivă pentru rectificarea orei de naștere |
| 10 | Serviciu de compatibilitate pe FastAPI | Python + FastAPI | Serviciu HTTP pentru aplicații de dating: 2 hărți → scor |

## Cum să le folosești

1. Copiază fișierul dorit în proiectul tău.
2. Instalează dependențele din antetul fișierului (`npm install ...` sau `pip install ...`).
3. Configurează variabilele de mediu (cel puțin `ASTROWAY_API_KEY`).
4. Rulează.

## Modelele din galerie

- **Script one-shot** (1, 5, 8) — procesare în loturi, stil cron.
- **Bot persistent** (2, 4) — conexiune constantă, ascultă comenzi slash.
- **Serviciu HTTP** (10) — drop-in REST cu autentificarea ta.
- **Funcție Edge** (6) — strat de cache între client și API.
- **Integrare cu instrumente LLM** (3, 7) — expunerea endpoint-urilor ca funcții pentru AI.
- **Interfață UI** (9) — front-end-uri interactive.

## Încă nu acoperit

Dacă scenariul tău nu este în listă (de exemplu: bot pentru Telegram, workflow n8n, acțiune Zapier, widget încorporat pe site) — **scrie-ne la [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** cu o descriere. Adăugăm rețete pe baza cererilor reale, nu ghicim.