# 完成した統合 — ギャラリー

## 典型シナリオ向けの10個の完成済みプロジェクト。各レシピは1ファイルで、ビルドステップなし。自分のAPIキーを埋め込んで、`npx tsx` または `python` を実行するだけで動作します。

以下のレシピはすべてコピー＆ペーストで即利用可能です。キーは `X-Api-Key` ヘッダー経由で送信し、リクエストには標準の `fetch` または `requests` を使用します。TypeScript / Python 用のSDKも計画中ですが、現在はこれだけで十分です。

## ギャラリーの内容

| # | レシピ | スタック | ユースケース |
|---|---|---|---|
| 1 | 毎日のホロスコープをSMSで | Twilio + Node.js | 毎日のホロスコープをユーザーにSMSで送信するcron |
| 2 | Discordボット `/chart` | discord.js | スラッシュコマンドでチャット参加者が誰でも Natal チャートを作成 |
| 3 | OpenAI function-calling | openai + Node.js | GPTがツール呼び出しで自動的にチャートを取得 |
| 4 | Slackボット `/synastry` | @slack/bolt | オフィスのメンバーが1行で相性診断 |
| 5 | Notionのデータ拡張 | @notionhq/client | 誕生日データからDBに自動で Natal チャートを生成 |
| 6 | Cloudflare Worker キャッシュ | CF Workers KV | 30日間にわたる同一リクエストのEdgeキャッシュ |
| 7 | Claude MCP tools | @astroway/mcp | Claude Desktop / CodeがネイティブツールのようにAPIを呼び出し |
| 8 | 予測をCSVにエクスポート | Python + pandas | 12ヶ月分の予測をBI / Tableau用のCSVに出力 |
| 9 | StreamlitによるレクティフィケーションUI | Python + Streamlit | 誕生時刻のレクティフィケーション用インタラクティブUI |
| 10 | FastAPIによる相性診断サービス | Python + FastAPI | デーティングアプリ向けHTTPサービス：2つのチャートからスコアを算出 |

## 使い方

1. 必要なファイルを自分のプロジェクトにコピーします。
2. ファイルのヘッダーに記載された依存関係をインストールします（`npm install ...` または `pip install ...`）。
3. 環境変数を設定します（最低限 `ASTROWAY_API_KEY`）。
4. 実行します。

## ギャラリー内のパターン

- **ワンショットスクリプト** (1, 5, 8) — cronスタイルのバッチ処理
- **常時稼働ボット** (2, 4) — 常時接続し、スラッシュコマンドをリッスン
- **HTTPサービス** (10) — 認証付きのdrop-in RESTサービス
- **Edge関数** (6) — クライアントとAPIの間にキャッシュレイヤーを配置
- **LLMツール統合** (3, 7) — AI関数としてエンドポイントを公開
- **UI** (9) — インタラクティブなフロントエンド

## まだカバーされていないケース

リストにないシナリオ（例：Telegramボット、n8nワークフロー、Zapierアクション、ウェブサイト埋め込みウィジェット）については、**[api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** までシナリオの説明とともにご連絡ください。実ユースケースに基づいてレシピを追加します。当社が推測することはありません。