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 with a description. We add recipes based on real requests, we don’t guess.