# Готові інтеграції — галерея

Десять готових проектів для типових сценаріїв. Кожен рецепт — один файл, без build-кроку. Вкладеш свій API-ключ → запустиш `npx tsx` або `python` → працює.

Усі рецепти нижче — копі-пасте-готові: ключ через `X-Api-Key` header, запити через стандартний `fetch` або `requests`. SDK на TypeScript / Python заплановані — наразі цього достатньо.

## Що в галереї

| # | Рецепт | Стек | Кейс |
|---|---|---|---|
| 1 | Щоденний гороскоп у SMS | Twilio + Node.js | Cron, що шле щоденний горп користувачам у SMS |
| 2 | Discord-бот `/chart` | discord.js | Slash-команда — будь-хто в чаті будує натальну карту |
| 3 | OpenAI function-calling | openai + Node.js | GPT сам ходить за картами через tool-виклик |
| 4 | Slack-бот `/synastry` | @slack/bolt | Команда офісу пробиває сумісність одним рядком |
| 5 | Збагачення Notion | @notionhq/client | Дата народження в БД → повний натал автоматично |
| 6 | Cloudflare Worker кеш | CF Workers KV | Edge-кеш ідентичних запитів на 30 днів |
| 7 | Claude MCP tools | @astroway/mcp | Claude Desktop / Code викликає API як native-інструмент |
| 8 | Експорт прогнозу в CSV | Python + pandas | 12-місячний прогноз → CSV для BI / Tableau |
| 9 | UI ректифікації на Streamlit | Python + Streamlit | Інтерактивний UI для ректифікації часу народження |
| 10 | Сервіс сумісності на FastAPI | Python + FastAPI | HTTP-сервіс для дейтинг-застосунків: 2 карти → score |

## Як використовувати

1. Скопіюй потрібний файл у свій проєкт.
2. Постав залежності з заголовку файлу (`npm install ...` або `pip install ...`).
3. Виставі env-змінні (мінімум — `ASTROWAY_API_KEY`).
4. Запусти.

## Патерни в галереї

- **Одноразовий скрипт** (1, 5, 8) — пакетна обробка в стилі cron.
- **Довгоживучий бот** (2, 4) — постійне з'єднання, слухає slash-команди.
- **HTTP-сервіс** (10) — drop-in REST за твоєю авторизацією.
- **Edge-функція** (6) — шар кешу між клієнтом і API.
- **Інтеграція LLM-інструментів** (3, 7) — виставлення ендпоінтів як функцій для AI.
- **UI** (9) — інтерактивні front-end'и.

## Ще не покрито

Якщо твій сценарій не в списку (наприклад: Telegram-бот, n8n workflow, Zapier action, вбудований віджет на сайті) — **напиши на [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** з описом. Ми додаємо рецепти на основі реальних запитів, не вгадуємо.