# Ready-made integrations — gallery

Ten ready-made projects for typical use cases. Each recipe is a single file, no build step. Drop in your API key → run `npx tsx` or `python` → it works.

All recipes below are copy-paste-ready: key via `X-Api-Key` header, requests via standard `fetch` or `requests`. TypeScript and Python SDKs are planned — for now this is enough.

## What's in the gallery

| # | Recipe | Stack | Use case |
|---|---|---|---|
| 1 | Daily horoscope SMS | Twilio + Node.js | Cron sending a daily horoscope to users via SMS |
| 2 | Discord bot `/chart` | discord.js | Slash command — anyone in chat builds a natal chart |
| 3 | OpenAI function-calling | openai + Node.js | GPT fetches charts itself through tool-calls |
| 4 | Slack bot `/synastry` | @slack/bolt | Team command — run compatibility as a one-liner |
| 5 | Notion enrichment | @notionhq/client | Birthday in a DB → full natal chart auto-filled |
| 6 | Cloudflare Worker cache | CF Workers KV | Edge cache for identical requests, 30 days |
| 7 | Claude MCP tools | @astroway/mcp | Claude Desktop / Code calls the API as a native tool |
| 8 | Forecast CSV export | Python + pandas | 12-month forecast → CSV for BI/Tableau |
| 9 | Streamlit rectification UI | Python + Streamlit | Interactive UI for birth-time rectification |
| 10 | FastAPI compatibility service | Python + FastAPI | HTTP service for dating apps: two charts → score |

## How to use

1. Copy the file you need into your project.
2. Install the deps listed at the top of the file (`npm install ...` or `pip install ...`).
3. Set the env vars (at minimum — `ASTROWAY_API_KEY`).
4. Run it.

## Patterns in the gallery

- **Single-shot script** (1, 5, 8) — cron-like batch processing.
- **Long-running bot** (2, 4) — connection-based, listens on slash commands.
- **HTTP service** (10) — drop-in REST behind your own auth.
- **Edge function** (6) — a caching layer between client and API.
- **LLM-tool integration** (3, 7) — exposing endpoints as tool-callable functions for AI.
- **UI** (9) — interactive front-ends.

## Not covered yet

If your use case isn't in the list (say: Telegram bot, n8n workflow, Zapier action, embedded site widget) — **email [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** with a description. We add recipes based on real requests, we don't guess.