# Integraciones listas — galería

## Diez proyectos listos para escenarios típicos

Cada receta es un solo archivo, sin pasos de compilación. Solo pega tu clave de API → ejecuta `npx tsx` o `python` → listo.

Todas las recetas a continuación son **copiar-pegar-listos**: la clave va en el `header` `X-Api-Key`, las peticiones usan `fetch` o `requests` estándar. Tenemos planificado un SDK de TypeScript/Python, pero por ahora esto es suficiente.

## Qué hay en la galería

| # | Receta | Stack | Caso de uso |
|---|---|---|---|
| 1 | Horóscopo diario por SMS | Twilio + Node.js | Cron que envía el horóscopo diario de los usuarios por SMS |
| 2 | Bot de Discord `/chart` | discord.js | Comando slash: cualquier persona en el chat genera su carta natal |
| 3 | Llamada a funciones de OpenAI | openai + Node.js | GPT mismo consulta las cartas mediante tool-calling |
| 4 | Bot de Slack `/synastry` | @slack/bolt | El equipo prueba la compatibilidad con un solo comando |
| 5 | Enriquecimiento de Notion | @notionhq/client | Fecha de nacimiento en la base de datos → carta natal completa automáticamente |
| 6 | Cache de Cloudflare Worker | CF Workers KV | Cache en el edge de peticiones idénticas por 30 días |
| 7 | Herramientas MCP de Claude | @astroway/mcp | Claude Desktop / Code invoca la API como herramienta nativa |
| 8 | Exportación de pronósticos a CSV | Python + pandas | Pronóstico de 12 meses → CSV para BI / Tableau |
| 9 | UI de rectificación en Streamlit | Python + Streamlit | Interfaz interactiva para rectificar la hora de nacimiento |
| 10 | Servicio de compatibilidad en FastAPI | Python + FastAPI | Servicio HTTP para apps de citas: 2 cartas → score |

## Cómo usar

1. Copia el archivo que necesites a tu proyecto.
2. Instala las dependencias del encabezado del archivo (`npm install ...` o `pip install ...`).
3. Configura las variables de entorno (mínimo: `ASTROWAY_API_KEY`).
4. Ejecuta.

## Patrones en la galería

- **Script de una sola vez** (1, 5, 8) — procesamiento por lotes estilo cron.
- **Bot de larga duración** (2, 4) — conexión permanente, escucha comandos slash.
- **Servicio HTTP** (10) — REST drop-in con tu propia autorización.
- **Función edge** (6) — capa de cache entre el cliente y la API.
- **Integración con herramientas LLM** (3, 7) — exponer endpoints como funciones para IA.
- **UI** (9) — frontends interactivos.

## Aún no cubierto

Si tu escenario no está en la lista (por ejemplo: bot de Telegram, flujo de trabajo en n8n, acción en Zapier, widget incrustado en un sitio web) — **escríbenos a [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** con una descripción. Añadimos recetas basadas en solicitudes reales, no adivinamos.