# Hazır Entegrasyonlar — Galeri

## On hazır proje senaryoları

Her reçete tek bir dosya, build adımı yok. API anahtarını ekle → `npx tsx` ya da `python` çalıştır → hazır.

Aşağıdaki tüm reçeteler kopyala-yapıştır hazır: anahtar `X-Api-Key` header'ında, istekler standart `fetch` ya da `requests` ile. TypeScript / Python SDK'ları planlanıyor — şimdilik bu kadar yeterli.

## Galeride neler var

| # | Reçete | Stack | Kullanım durumu |
|---|---|---|---|
| 1 | Günlük burç tahmini SMS | Twilio + Node.js | Kullanıcılara günlük burç tahminini SMS olarak gönderen cron |
| 2 | Discord bot `/chart` | discord.js | Sohbetteki herkesin natal haritasını oluşturabilen slash komutu |
| 3 | OpenAI function-calling | openai + Node.js | GPT haritaları almak için tool çağrısı yapan |
| 4 | Slack bot `/synastry` | @slack/bolt | Ofis takımının uyumluluğu tek satırda kontrol eden komut |
| 5 | Notion zenginleştirme | @notionhq/client | Doğum tarihi veritabanında → otomatik tam natal harita |
| 6 | Cloudflare Worker önbelleği | CF Workers KV | Aynı istekleri 30 gün boyunca edge önbelleğe alma |
| 7 | Claude MCP tools | @astroway/mcp | Claude Desktop / Code'un API'yi native araç gibi çağırması |
| 8 | Tahmini CSV'ye dışa aktarma | Python + pandas | 12 aylık tahmin → BI / Tableau için CSV |
| 9 | Streamlit ile rektifikasyon UI | Python + Streamlit | Doğum zamanının rektifikasyonu için interaktif UI |
| 10 | FastAPI uyumluluk servisi | Python + FastAPI | Flört uygulamaları için HTTP servisi: 2 harita → puan |

## Nasıl kullanılır

1. İhtiyacın olan dosyayı kendi projenin içine kopyala.
2. Dosyanın başlığındaki bağımlılıkları kur (`npm install ...` ya da `pip install ...`).
3. Ortam değişkenlerini ayarla (en azından `ASTROWAY_API_KEY`).
4. Çalıştır.

## Galerideki desenler

- **Tek seferlik script** (1, 5, 8) — cron tarzı toplu işleme.
- **Uzun ömürlü bot** (2, 4) — sürekli bağlantı, slash komutlarını dinler.
- **HTTP servisi** (10) — kendi yetkilendirmenle drop-in REST.
- **Edge fonksiyonu** (6) — istemci ile API arasında önbellek katmanı.
- **LLM araç entegrasyonu** (3, 7) — AI için fonksiyon olarak endpoint'leri sunma.
- **UI** (9) — interaktif front-end'ler.

## Daha kapsanmayanlar

Senaryon listede yoksa (örneğin: Telegram botu, n8n workflow, Zapier action, web sitesine gömülü widget) — **api@astroway.info** adresine [açıklamayla birlikte](mailto:api@astroway.info?subject=Integration%20recipe) yaz. Gerçek taleplere göre reçeteler ekliyoruz, tahmin etmiyoruz.