# Galeri Integrasi Siap Pakai

## Sepuluh Proyek Siap Pakai untuk Skenario Umum

Setiap resep adalah satu berkas tanpa tahap build. Masukkan API-key kamu → jalankan `npx tsx` atau `python` → langsung berfungsi.

Semua resep di bawah ini siap pakai tinggal copy-paste: kunci melalui header `X-Api-Key`, permintaan menggunakan `fetch` atau `requests` standar. SDK TypeScript / Python sedang direncanakan — untuk saat ini ini sudah cukup.

## Apa yang Ada di Galeri

| # | Resep | Teknologi | Kasus Penggunaan |
|---|---|---|---|
| 1 | Horoskop Harian via SMS | Twilio + Node.js | Cron yang mengirim horoskop harian ke pengguna melalui SMS |
| 2 | Bot Discord `/chart` | discord.js | Perintah slash — siapa pun di obrolan dapat membuat peta natal |
| 3 | Pemanggilan Fungsi OpenAI | openai + Node.js | GPT secara otomatis mengambil peta melalui tool call |
| 4 | Bot Slack `/synastry` | @slack/bolt | Perintah satu baris untuk mengecek kompatibilitas di kantor |
| 5 | Enrichment Notion | @notionhq/client | Tanggal lahir di basis data → peta natal otomatis lengkap |
| 6 | Cache Cloudflare Worker | CF Workers KV | Cache edge untuk permintaan identik selama 30 hari |
| 7 | Alat MCP Claude | @astroway/mcp | Claude Desktop / Code memanggil API layaknya alat native |
| 8 | Ekspor Prediksi ke CSV | Python + pandas | Prediksi 12 bulan → CSV untuk BI / Tableau |
| 9 | UI Rektifikasi di Streamlit | Python + Streamlit | UI interaktif untuk rektifikasi waktu lahir |
| 10 | Layanan Kompatibilitas di FastAPI | Python + FastAPI | Layanan HTTP untuk aplikasi kencan: 2 peta → skor |

## Cara Menggunakan

1. Salin berkas yang kamu butuhkan ke dalam proyek kamu.
2. Pasang dependensi dari header berkas (`npm install ...` atau `pip install ...`).
3. Atur variabel lingkungan (minimal — `ASTROWAY_API_KEY`).
4. Jalankan.

## Pola-Pola di Galeri

- **Skrip sekali pakai** (1, 5, 8) — pemrosesan batch ala cron.
- **Bot jangka panjang** (2, 4) — koneksi konstan, mendengarkan perintah slash.
- **Layanan HTTP** (10) — REST drop-in dengan otorisasi kamu.
- **Fungsi Edge** (6) — lapisan cache antara klien dan API.
- **Integrasi Alat LLM** (3, 7) — mengekspos endpoint sebagai fungsi untuk AI.
- **UI** (9) — antarmuka front-end interaktif.

## Belum Tercakup

Jika skenario kamu tidak ada dalam daftar (misalnya: bot Telegram, alur kerja n8n, aksi Zapier, widget tertanam di situs) — **kirim email ke [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** dengan deskripsi. Kami menambahkan resep berdasarkan permintaan nyata, bukan tebak-tebak.