# Integrazioni pronte — galleria

Dieci progetti pronti per scenari tipici. Ogni ricetta è un singolo file, senza passaggi di build. Inserisci la tua chiave API → esegui `npx tsx` o `python` → funziona.

Tutte le ricette qui sotto sono copy-paste-ready: la chiave tramite header `X-Api-Key`, le richieste tramite `fetch` o `requests` standard. Gli SDK TypeScript/Python sono in programma: per ora questo è sufficiente.

## Cosa c'è nella galleria

| # | Ricetta | Stack | Caso d'uso |
|---|---|---|---|
| 1 | Oroscopo giornaliero via SMS | Twilio + Node.js | Cron che invia l'oroscopo quotidiano agli utenti via SMS |
| 2 | Bot Discord `/chart` | discord.js | Comando slash — chiunque nel chat costruisce una carta natale |
| 3 | OpenAI function-calling | openai + Node.js | GPT chiama autonomamente le carte tramite tool-calling |
| 4 | Bot Slack `/synastry` | @slack/bolt | Il team verifica la compatibilità con un semplice comando |
| 5 | Arricchimento Notion | @notionhq/client | Data di nascita nel DB → carta natale completa automatica |
| 6 | Cache su Cloudflare Worker | CF Workers KV | Cache edge per richieste identiche per 30 giorni |
| 7 | Strumenti MCP per Claude | @astroway/mcp | Claude Desktop/Code chiama l'API come strumento nativo |
| 8 | Esportazione previsioni in CSV | Python + pandas | Previsione a 12 mesi → CSV per BI/Tableau |
| 9 | UI di rettifica su Streamlit | Python + Streamlit | UI interattiva per la rettifica dell'ora di nascita |
| 10 | Servizio di compatibilità su FastAPI | Python + FastAPI | Servizio HTTP per app di dating: 2 carte → punteggio |

## Come usare

1. Copia il file che ti serve nel tuo progetto.
2. Installa le dipendenze indicate nell'header del file (`npm install ...` o `pip install ...`).
3. Imposta le variabili d'ambiente (almeno `ASTROWAY_API_KEY`).
4. Esegui.

## Pattern nella galleria

- **Script one-shot** (1, 5, 8) — elaborazione batch in stile cron.
- **Bot long-running** (2, 4) — connessione permanente, ascolta i comandi slash.
- **Servizio HTTP** (10) — drop-in REST con la tua autorizzazione.
- **Funzione edge** (6) — strato di cache tra client e API.
- **Integrazione strumenti LLM** (3, 7) — esposizione degli endpoint come funzioni per l'AI.
- **UI** (9) — front-end interattivi.

## Non ancora coperto

Se il tuo scenario non è nella lista (ad esempio: bot Telegram, workflow n8n, action Zapier, widget integrato nel sito) — **scrivi a [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** descrivendo il caso. Aggiungiamo ricette basate su richieste reali, non indoviniamo.