# Gotowe integracje — galeria

Dziesięć gotowych projektów do typowych scenariuszy. Każdy przepis to jeden plik, bez kroku budowania. Wstaw swój klucz API → uruchom `npx tsx` albo `python` → działa.

Wszystkie przepisy poniżej są gotowe do kopiowania: klucz przez nagłówek `X-Api-Key`, żądania przez standardowe `fetch` lub `requests`. SDK w TypeScript / Python są planowane — na razie to wystarczy.

## Co znajduje się w galerii

| # | Przepis | Stos | Przypadek użycia |
|---|---|---|---|
| 1 | Horoskop dzienny przez SMS | Twilio + Node.js | Cron wysyłający codzienny horoskop użytkownikom przez SMS |
| 2 | Bota Discord `/chart` | discord.js | Komenda slash — każdy w czacie może wygenerować mapę urodzeniową |
| 3 | Wywołanie funkcji w OpenAI | openai + Node.js | GPT sam pobiera mapy przez wywołanie narzędzia |
| 4 | Bota Slack `/synastry` | @slack/bolt | Zespół w biurze sprawdza kompatybilność jednym poleceniem |
| 5 | Wzbogacanie Notion | @notionhq/client | Data urodzenia w bazie → pełna mapa urodzeniowa automatycznie |
| 6 | Kesh w Cloudflare Worker | CF Workers KV | Keshowanie identycznych zapytań na edge przez 30 dni |
| 7 | Narzędzia Claude MCP | @astroway/mcp | Claude Desktop / Code wywołuje API jako natywne narzędzie |
| 8 | Eksport prognozy do CSV | Python + pandas | Prognoza 12-miesięczna → CSV do BI / Tableau |
| 9 | Interfejs do retyfikacji na Streamlit | Python + Streamlit | Interaktywny UI do retyfikacji czasu urodzenia |
| 10 | Usługa kompatybilności na FastAPI | Python + FastAPI | Usługa HTTP dla aplikacji randkowych: 2 mapy → wynik |

## Jak używać

1. Skopiuj odpowiedni plik do swojego projektu.
2. Zainstaluj zależności z nagłówka pliku (`npm install ...` albo `pip install ...`).
3. Ustaw zmienne środowiskowe (minimalnie — `ASTROWAY_API_KEY`).
4. Uruchom.

## Wzorce w galerii

- **Skrypt jednorazowy** (1, 5, 8) — przetwarzanie wsadowe w stylu cron.
- **Długotrwały bot** (2, 4) — stałe połączenie, nasłuchuje komend slash.
- **Usługa HTTP** (10) — gotowy REST pod twoją autoryzację.
- **Funkcja edge** (6) — warstwa keshu między klientem a API.
- **Integracja narzędzi LLM** (3, 7) — udostępnianie endpointów jako funkcji dla AI.
- **Interfejs UI** (9) — interaktywne front-endy.

## Jeszcze nieobjęte

Jeśli twój scenariusz nie znajduje się na liście (np. bot Telegram, workflow n8n, akcja Zapier, wbudowany widget na stronie) — **napisz na [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** z opisem. Dodajemy przepisy na podstawie rzeczywistych zapytań, nie zgadujemy.