Update README.md

README.md

@@ -1,3 +1,14 @@
+---
+title: SNS運用AIライト
+emoji: 🚀
+colorFrom: indigo
+colorTo: blue
+sdk: gradio
+sdk_version: "4.44.0"
+app_file: app.py
+pinned: false
+---
+
 # SNS運用AIライト（Hugging Face Spaces / FastAPI + Gradio）
 
 ## できること
@@ -8,13 +19,13 @@
 - キーワード監視（疑似 or X/Instagram APIアダプタに差し替え）
 
 ## すぐ動かす
-1. Hugging Face Space を **Python** で作成し、このリポジトリ構成をアップロード。
+1. Space を **Python / Gradio** で作成し、このリポジトリをアップロード。
 2. `Settings > Secrets` に以下を登録:
-   - `OPENAI_API_KEY` : OpenAI APIキー
-   - （任意）`DATABASE_URL` : 例 `postgresql+psycopg://USER:PASS@HOST:PORT/DBNAME`  
-     指定が無い場合は `sqlite:///./app.db`
-   - （任意）`X_BEARER_TOKEN` / `IG_ACCESS_TOKEN` など（無い場合は疑似フェッチ/疑似投稿）
-3. Space を起動。Gradio UI が表示され、同時に FastAPI エンドポイントも有効です。
+   - `OPENAI_API_KEY`
+   - （任意）`DATABASE_URL` … 例 `postgresql+psycopg://USER:PASS@HOST:PORT/DBNAME`  
+     未設定なら `sqlite:///./app.db`
+   - （任意）`X_BEARER_TOKEN`, `IG_ACCESS_TOKEN`（未設定なら疑似フェッチ/疑似投稿）
+3. 起動すると、ルート(`/`)にGradio UI、`/api/*`にFastAPIエンドポイントが有効になります。
 
 ## 主要エンドポイント（FastAPI）
 - `POST /api/summarize_trends`  … トレンド要約
@@ -22,17 +33,18 @@
 - `POST /api/approve_post/{post_id}` … 承認
 - `POST /api/schedule_post/{post_id}` … 予約設定
 - `GET  /api/calendar` … 投稿カレンダー
-- `POST /api/keywords` … 監視キーワード保存/更新
-- `GET  /api/keywords` … 監視キーワード一覧
+- `POST /api/keywords` / `GET /api/keywords` … 監視キーワード
 
-## 技術メモ
-- LLM: OpenAI（chat.completions）※ `OPENAI_API_KEY` 必須
-- スケジューラ: APScheduler
-- DB: SQLAlchemy, SQLite→PostgreSQL（`DATABASE_URL`切替）
+## 技術スタック
+- LLM: OpenAI (`OPENAI_API_KEY`)
+- スケジューラ: APScheduler（UTC動作）
+- DB: SQLAlchemy（SQLite / PostgreSQL）
 - UI: Gradio（`/` にマウント）, API: FastAPI（`/api`）
-- X/Instagram は `services/social_adapters/*` を本物APIへ差し替えて利用
 
-## 開発の次ステップ
-- X/Instagram の OAuth 実装（コールバックURLは Space のURLに合わせる）
-- 画像生成ラフ→Canva連携（本コードは「画像ラフ文」出力をCanvaペースト前提で生成）
-- 評価・ABテスト、チーム権限、ログ/監査
+## 開発メモ
+- 画像は生成せず、**Canvaに貼るラフ文**を`image_prompt`として出力
+- X/Instagramの実APIは`services/social_adapters/*`を差し替え
+- 日本時間で予約する場合はISOに`+09:00`などのTZを付与  
+  例: `2025-09-01T09:00:00+09:00`
+
+参考: スペース設定の詳細は公式ドキュメントを参照