# Připravené integrace — galerie

## Deset hotových projektů pro typické scénáře

Každý recept je jeden soubor, bez build kroku. Vložíš svůj API klíč → spustíš `npx tsx` nebo `python` → jede to.

Všechny recepty níže jsou copy-paste-ready: klíč přes `X-Api-Key` header, požadavky přes standardní `fetch` nebo `requests`. SDK pro TypeScript / Python jsou v plánu — prozatím tohle stačí.

## Co je v galerii

| # | Recept | Stack | Případ použití |
|---|---|---|---|
| 1 | Denní horoskop ve zprávách SMS | Twilio + Node.js | Cron, který posílá denní horoskop uživatelům prostřednictvím SMS |
| 2 | Discord bot `/chart` | discord.js | Příkaz ve slash-formátu — kdokoliv v chatu si může sestavit svůj natal chart |
| 3 | OpenAI function-calling | openai + Node.js | GPT samo chodí pro charty pomocí volání nástrojů (tool calls) |
| 4 | Slack bot `/synastry` | @slack/bolt | Příkaz kanceláře pro zjištění kompatibility jedním řádkem |
| 5 | Obohacení Notion | @notionhq/client | Datum narození v databázi → plný natal chart automaticky |
| 6 | Cloudflare Worker cache | CF Workers KV | Edge cache stejných požadavků na 30 dní |
| 7 | Claude MCP tools | @astroway/mcp | Claude Desktop / Code volá API jako nativní nástroj |
| 8 | Export předpovědi do CSV | Python + pandas | 12měsíční předpověď → CSV pro BI / Tableau |
| 9 | UI pro rectifikaci na Streamlit | Python + Streamlit | Interaktivní UI pro rectifikaci času narození |
| 10 | Služba pro kompatibilitu na FastAPI | Python + FastAPI | HTTP služba pro datingové aplikace: 2 charty → skóre |

## Jak používat

1. Zkopíruj si příslušný soubor do svého projektu.
2. Nainstaluj závislosti uvedené v hlavičce souboru (`npm install ...` nebo `pip install ...`).
3. Nastav environmentální proměnné (alespoň `ASTROWAY_API_KEY`).
4. Spusť.

## Vzorce v galerii

- **Jednorázový skript** (1, 5, 8) — dávkové zpracování ve stylu cronu.
- **Dlouhodobý bot** (2, 4) — trvalé připojení, naslouchá příkazům ve slash-formátu.
- **HTTP služba** (10) — ready-to-use REST podle tvé autorizace.
- **Edge funkce** (6) — cache vrstva mezi klientem a API.
- **Integrace nástrojů LLM** (3, 7) — vystavení endpointů jako funkcí pro AI.
- **UI** (9) — interaktivní front-endy.

## Ještě nepokryto

Pokud tvůj scénář není v seznamu (například: Telegram bot, n8n workflow, Zapier akce, vestavěný widget na webu) — **napiš na [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** s popisem. Přidáváme recepty na základě reálných požadavků, nehádáme se.