# 완료된 통합 — 갤러리

## 10가지 완성된 프로젝트: 전형적인 시나리오를 위한 레시피

각 레시피는 빌드 단계 없이 단일 파일로 구성되어 있습니다. 자신의 API 키를 삽입하고 `npx tsx` 또는 `python`으로 실행하면 즉시 작동합니다.

아래 모든 레시피는 복사-붙여넣기만 하면 되는 완전 준비 상태입니다. 키는 `X-Api-Key` 헤더를 통해 전달하고, 요청은 표준 `fetch` 또는 `requests`를 사용합니다. TypeScript/Python SDK는 계획 중이며, 현재는 이 정도로 충분합니다.

## 갤러리 소개

| # | 레시피 | 스택 | 케이스 |
|---|---|---|---|
| 1 | 매일의 운세 SMS | Twilio + Node.js | 사용자에게 매일 운세를 SMS로 보내는 크론 |
| 2 | Discord 봇 `/chart` | discord.js | 슬래시 명령어 — 채팅방의 누구나 natal 차트를 생성 |
| 3 | OpenAI function-calling | openai + Node.js | GPT가 툴 호출을 통해 스스로 차트를 가져옴 |
| 4 | Slack 봇 `/synastry` | @slack/bolt | 사무실 명령어로 한 줄에 호환성 분석 |
| 5 | Notion 데이터 enrichment | @notionhq/client | 데이터베이스에 생년월일 → natal 차트 자동 생성 |
| 6 | Cloudflare Worker 캐시 | CF Workers KV | 30일 동안 동일한 요청을 엣지 캐시 |
| 7 | Claude MCP tools | @astroway/mcp | Claude Desktop/Code에서 API를 네이티브 도구처럼 호출 |
| 8 | CSV로 운세 내보내기 | Python + pandas | 12개월 예측 → BI/Tableau용 CSV |
| 9 | Streamlit로 rectification UI | Python + Streamlit | 출생 시간 rectification을 위한 인터랙티브 UI |
| 10 | FastAPI 호환성 서비스 | Python + FastAPI | 데이팅 앱용 HTTP 서비스: 2개의 차트 → 점수 |

## 사용 방법

1. 원하는 파일을 프로젝트로 복사합니다.
2. 파일 헤더의 의존성을 설치합니다 (`npm install ...` 또는 `pip install ...`).
3. 환경 변수를 설정합니다 (최소 `ASTROWAY_API_KEY`).
4. 실행합니다.

## 갤러리의 패턴

- **일회성 스크립트** (1, 5, 8) — 크론 스타일의 배치 처리.
- **장기 실행 봇** (2, 4) — 지속적인 연결, 슬래시 명령어 수신.
- **HTTP 서비스** (10) — 인증과 함께 즉시 사용 가능한 REST.
- **엣지 함수** (6) — 클라이언트와 API 사이의 캐시 레이어.
- **LLM 도구 통합** (3, 7) — AI용 함수로 엔드포인트 노출.
- **UI** (9) — 인터랙티브 프론트엔드.

## 아직 다루지 않은 경우

Telegram 봇, n8n 워크플로우, Zapier 액션, 웹사이트 내장 위젯 등 목록에 없는 시나리오가 있다면 **api@astroway.info**로 [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)에 설명과 함께 문의해 주세요. 실제 요청을 바탕으로 레시피를 추가하며, 추측하지 않습니다.