feat(agent-office): Blog + Realestate 에이전트 추가

기존 Stock/Music 에이전트 패턴을 따라 2개 신규 에이전트 도입.

- Blog 에이전트 (10:00 매일): 트렌드 키워드 1개 자동 선택
  → blog-lab 파이프라인 전체 (research→generate→market→review) 자동 실행
  → 평가 점수와 본문 요약을 텔레그램 승인 요청으로 푸시
  → 승인 시 published 전환, 거절 시 작업 종료
- Realestate 에이전트 (09:15 매일): realestate-lab 수집 트리거
  → 신규 매칭 상위 5건 + 대시보드를 텔레그램 리포트
  → 조회한 매칭은 자동 읽음 처리
- service_proxy: blog-lab/realestate-lab REST 호출 래퍼 추가
- agents 레지스트리 + DB 시드 + 스케줄러 3개 잡 등록
- docker-compose: agent-office에 BLOG_LAB_URL/REALESTATE_LAB_URL 주입
- README: 에이전트 구성 표 + 명령어 + 스케줄러 잡 정리

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

agent-office/app/agents/__init__.py

@@ -1,11 +1,15 @@
 from .stock import StockAgent
 from .music import MusicAgent
+from .blog import BlogAgent
+from .realestate import RealestateAgent
 
 AGENT_REGISTRY = {}
 
 def init_agents():
     AGENT_REGISTRY["stock"] = StockAgent()
     AGENT_REGISTRY["music"] = MusicAgent()
+    AGENT_REGISTRY["blog"] = BlogAgent()
+    AGENT_REGISTRY["realestate"] = RealestateAgent()
 
 def get_agent(agent_id: str):
     return AGENT_REGISTRY.get(agent_id)

agent-office/app/agents/blog.py

@@ -0,0 +1,187 @@
+import asyncio
+from typing import Optional
+
+from .base import BaseAgent
+from ..db import (
+    create_task, update_task_status, approve_task, reject_task,
+    get_task, get_agent_config, add_log,
+)
+from .. import service_proxy
+from .. import telegram_bot
+
+
+DEFAULT_TREND_KEYWORDS = [
+    "다이어트 식단", "재택근무 꿀템", "캠핑 장비 추천",
+    "홈트레이닝", "제주도 여행", "에어프라이어 레시피",
+]
+
+
+class BlogAgent(BaseAgent):
+    """블로그 마케팅 에이전트.
+
+    매일 10:00 자동 실행: 키워드 1개 리서치 → 글 생성 → 마케터 → 평가자
+    → 평가 점수와 요약을 텔레그램 승인 요청으로 푸시
+    → 승인 시 `published` 상태로 전환, 거절 시 재생성
+    """
+
+    agent_id = "blog"
+    display_name = "블로그 마케터"
+
+    async def on_schedule(self) -> None:
+        if self.state not in ("idle", "break"):
+            return
+
+        config = get_agent_config(self.agent_id) or {}
+        custom = config.get("custom_config", {}) or {}
+        keywords = custom.get("trend_keywords") or DEFAULT_TREND_KEYWORDS
+        if not keywords:
+            return
+
+        import random
+        keyword = random.choice(keywords)
+
+        task_id = create_task(
+            self.agent_id,
+            "auto_blog_pipeline",
+            {"keyword": keyword},
+            requires_approval=True,
+        )
+        await self.transition("working", f"리서치: {keyword}", task_id)
+        asyncio.create_task(self._run_pipeline(task_id, keyword))
+
+    async def _run_pipeline(self, task_id: str, keyword: str) -> None:
+        try:
+            # 1) 리서치 시작 (백그라운드 task)
+            research = await service_proxy.blog_research(keyword)
+            research_task_id = research.get("task_id")
+            keyword_id = None
+
+            # 2) 리서치 완료까지 폴링 (최대 3분)
+            for _ in range(36):
+                await asyncio.sleep(5)
+                status = await service_proxy.blog_task_status(research_task_id)
+                if status.get("status") == "succeeded":
+                    keyword_id = status.get("result", {}).get("keyword_id")
+                    break
+                if status.get("status") == "failed":
+                    raise Exception(f"research failed: {status.get('error')}")
+            if not keyword_id:
+                raise Exception("research timeout")
+
+            # 3) 작가 단계
+            await self.transition("working", f"글 생성: {keyword}", task_id)
+            gen = await service_proxy.blog_generate(keyword_id)
+            post_id = gen.get("post_id") or gen.get("id")
+            if not post_id:
+                raise Exception("generate did not return post_id")
+
+            # 4) 마케터 단계
+            await self.transition("working", "링크 삽입 중", task_id)
+            await service_proxy.blog_market(post_id)
+
+            # 5) 평가자 단계
+            await self.transition("working", "품질 리뷰 중", task_id)
+            review = await service_proxy.blog_review(post_id)
+            score = review.get("score")
+            passed = review.get("passed", False)
+
+            post = await service_proxy.blog_get_post(post_id)
+            title = post.get("title", "(제목 없음)")
+            excerpt = (post.get("body") or "")[:300]
+
+            update_task_status(task_id, "pending", {
+                "keyword": keyword,
+                "post_id": post_id,
+                "score": score,
+                "passed": passed,
+                "title": title,
+            })
+
+            await self.transition("waiting", f"승인 대기 · {score}/60", task_id)
+
+            detail = (
+                f"키워드: {keyword}\n"
+                f"제목: {title}\n"
+                f"평가 점수: {score}/60 ({'통과' if passed else '미통과'})\n\n"
+                f"{excerpt}..."
+            )
+            await telegram_bot.send_approval_request(
+                self.agent_id, task_id,
+                "✍️ [블로그 에이전트] 발행 승인 요청", detail,
+            )
+
+        except Exception as e:
+            add_log(self.agent_id, f"Blog pipeline failed: {e}", "error", task_id)
+            update_task_status(task_id, "failed", {"error": str(e), "keyword": keyword})
+            await self.transition("idle", f"오류: {e}")
+            await telegram_bot.send_task_result(
+                self.agent_id, "✍️ [블로그 에이전트] 파이프라인 실패",
+                f"키워드: {keyword}\n오류: {e}",
+            )
+
+    async def on_command(self, command: str, params: dict) -> dict:
+        if command == "research":
+            keyword = (params.get("keyword") or "").strip()
+            if not keyword:
+                return {"ok": False, "message": "keyword 필수"}
+            task_id = create_task(
+                self.agent_id, "auto_blog_pipeline",
+                {"keyword": keyword}, requires_approval=True,
+            )
+            await self.transition("working", f"리서치: {keyword}", task_id)
+            asyncio.create_task(self._run_pipeline(task_id, keyword))
+            return {"ok": True, "task_id": task_id, "message": f"파이프라인 시작: {keyword}"}
+
+        if command == "add_trend_keyword":
+            keyword = (params.get("keyword") or "").strip()
+            if not keyword:
+                return {"ok": False, "message": "keyword 필수"}
+            config = get_agent_config(self.agent_id) or {}
+            custom = config.get("custom_config", {}) or {}
+            kws = list(custom.get("trend_keywords") or [])
+            if keyword not in kws:
+                kws.append(keyword)
+            from ..db import update_agent_config
+            update_agent_config(self.agent_id, custom_config={**custom, "trend_keywords": kws})
+            return {"ok": True, "keywords": kws}
+
+        if command == "list_trend_keywords":
+            config = get_agent_config(self.agent_id) or {}
+            custom = config.get("custom_config", {}) or {}
+            return {"ok": True, "keywords": custom.get("trend_keywords") or DEFAULT_TREND_KEYWORDS}
+
+        return {"ok": False, "message": f"Unknown command: {command}"}
+
+    async def on_approval(self, task_id: str, approved: bool, feedback: str = "") -> None:
+        task = get_task(task_id)
+        if not task:
+            return
+        result = task.get("result_data") or {}
+        post_id = result.get("post_id")
+
+        if not approved:
+            reject_task(task_id)
+            await self.transition("idle", "발행 거절됨")
+            await telegram_bot.send_task_result(
+                self.agent_id, "✍️ [블로그 에이전트] 발행 취소",
+                f"키워드: {result.get('keyword', '')}\n사용자가 거절했습니다.",
+            )
+            return
+
+        approve_task(task_id, via="telegram")
+        await self.transition("reporting", "발행 중...", task_id)
+
+        try:
+            if post_id:
+                await service_proxy.blog_publish(int(post_id))
+            update_task_status(task_id, "succeeded", {**result, "published": True})
+            await telegram_bot.send_task_result(
+                self.agent_id, "✍️ [블로그 에이전트] 발행 완료",
+                f"키워드: {result.get('keyword', '')}\n제목: {result.get('title', '')}\n"
+                f"점수: {result.get('score')}/60",
+            )
+            await self.transition("idle", "발행 완료")
+        except Exception as e:
+            add_log(self.agent_id, f"Blog publish failed: {e}", "error", task_id)
+            update_task_status(task_id, "failed", {**result, "publish_error": str(e)})
+            await self.transition("idle", f"발행 오류: {e}")

agent-office/app/agents/realestate.py

@@ -0,0 +1,98 @@
+import asyncio
+from .base import BaseAgent
+from ..db import create_task, update_task_status, add_log
+from .. import service_proxy
+from .. import telegram_bot
+
+
+class RealestateAgent(BaseAgent):
+    """부동산 청약 에이전트.
+
+    매일 09:15 자동 실행: realestate-lab의 수집을 트리거하고
+    신규 매칭 결과를 텔레그램으로 푸시 (승인 없는 리포트형).
+    """
+
+    agent_id = "realestate"
+    display_name = "청약 애널리스트"
+
+    async def on_schedule(self) -> None:
+        if self.state not in ("idle", "break"):
+            return
+
+        task_id = create_task(self.agent_id, "daily_match_report", {})
+        await self.transition("working", "청약 공고 수집 중", task_id)
+
+        try:
+            collect = await service_proxy.realestate_collect()
+            new_count = collect.get("new_count", 0) or 0
+
+            await self.transition("working", "신규 매칭 조회 중", task_id)
+            matches = await service_proxy.realestate_matches(limit=20)
+            dashboard = await service_proxy.realestate_dashboard()
+
+            await self.transition("reporting", "리포트 전송 중", task_id)
+
+            if not matches:
+                body = (
+                    f"수집된 신규 공고: {new_count}건\n"
+                    f"진행 중 공고: {dashboard.get('active_count', 0)}건\n"
+                    f"신규 매칭: 없음"
+                )
+            else:
+                lines = [
+                    f"📌 수집 {new_count}건 / 매칭 {len(matches)}건",
+                    "",
+                ]
+                for m in matches[:5]:
+                    title = m.get("title") or m.get("announcement_title") or "(제목 없음)"
+                    region = m.get("region") or ""
+                    score = m.get("match_score") or m.get("score") or ""
+                    lines.append(f"• [{region}] {title} (매칭 {score})")
+                if len(matches) > 5:
+                    lines.append(f"… 외 {len(matches) - 5}건")
+                body = "\n".join(lines)
+
+            tg = await telegram_bot.send_task_result(
+                self.agent_id,
+                "🏢 [청약 에이전트] 오늘의 매칭 리포트",
+                body,
+            )
+
+            # 확인한 매칭 read 처리
+            for m in matches[:5]:
+                mid = m.get("id")
+                if mid:
+                    try:
+                        await service_proxy.realestate_mark_read(int(mid))
+                    except Exception:
+                        pass
+
+            update_task_status(task_id, "succeeded", {
+                "new_count": new_count,
+                "match_count": len(matches),
+                "telegram_sent": tg.get("ok", False),
+                "telegram_message_id": tg.get("message_id"),
+            })
+            await self.transition("idle", f"매칭 {len(matches)}건")
+
+        except Exception as e:
+            add_log(self.agent_id, f"Realestate report failed: {e}", "error", task_id)
+            update_task_status(task_id, "failed", {"error": str(e)})
+            await self.transition("idle", f"오류: {e}")
+
+    async def on_command(self, command: str, params: dict) -> dict:
+        if command == "fetch_matches":
+            await self.on_schedule()
+            return {"ok": True, "message": "매칭 리포트 시작"}
+
+        if command == "dashboard":
+            try:
+                data = await service_proxy.realestate_dashboard()
+                return {"ok": True, "dashboard": data}
+            except Exception as e:
+                return {"ok": False, "message": str(e)}
+
+        return {"ok": False, "message": f"Unknown command: {command}"}
+
+    async def on_approval(self, task_id: str, approved: bool, feedback: str = "") -> None:
+        pass