README.md

metadata

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）

できること

• 競合/トレンドの要約（OpenAI使用）
• 1週間分の投稿案と画像ラフ文の自動生成（OpenAI使用）
• 承認→予約投稿（APScheduler）
• 投稿カレンダー（DB保存）
• キーワード監視（疑似 or X/Instagram APIアダプタに差し替え）

すぐ動かす

1. Space を Python / Gradio で作成し、このリポジトリをアップロード。
2. Settings > Secrets に以下を登録:
   • 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 … トレンド要約
• POST /api/generate_week_plan … 1週間投稿案生成
• POST /api/approve_post/{post_id} … 承認
• POST /api/schedule_post/{post_id} … 予約設定
• GET /api/calendar … 投稿カレンダー
• POST /api/keywords / GET /api/keywords … 監視キーワード

技術スタック

• LLM: OpenAI (OPENAI_API_KEY)
• スケジューラ: APScheduler（UTC動作）
• DB: SQLAlchemy（SQLite / PostgreSQL）
• UI: Gradio（/ にマウント）, API: FastAPI（/api）

開発メモ

• 画像は生成せず、Canvaに貼るラフ文をimage_promptとして出力
• X/Instagramの実APIはservices/social_adapters/*を差し替え
• 日本時間で予約する場合はISOに+09:00などのTZを付与
  例: 2025-09-01T09:00:00+09:00

参考: スペース設定の詳細は公式ドキュメントを参照