---
name: scraping-orchestrator
description: "GUARDiA ITSM 웹 스크랩핑 봇 오케스트레이터. URL 스크랩, DB 저장, 상태관리(DRAFT/PUBLISHED/DELETED), 메신저 알림, Manager UI 연동을 조율한다. 다음 상황에서 반드시 사용: (1) '스크랩', '웹 수집', 'URL 수집', '스크랩핑 봇' 요청; (2) '게시', '원복', '스크랩 삭제' 요청; (3) '!scrap' 봇 명령어 처리; (4) 스크랩 결과 조회, 타겟 등록; (5) 다시 실행, 업데이트, 수정, 보완 요청."
---

# GUARDiA 스크랩핑 오케스트레이터

## 에이전트 팀

| 에이전트 | 역할 |
|---------|------|
| scraping-bot | URL 스크랩 실행, 상태 전환, 메신저 알림 |

## 상태 흐름

```
URL 등록(ScrapingTarget)
  → 즉시 또는 스케줄 스크랩
    → DRAFT (저장됨)
      → PUBLISHED  (게시 + 메신저 알림)
      → DELETED    (소프트 삭제)
        → DRAFT    (원복)
```

## Phase 0: 요청 분류

- **타겟 등록** → `POST /api/scraping/targets`
- **즉시 스크랩** → `POST /api/scraping/run`
- **결과 조회** → `GET /api/scraping/results`
- **게시** → `POST /api/scraping/results/{id}/publish`
- **삭제** → `DELETE /api/scraping/results/{id}`
- **원복** → `POST /api/scraping/results/{id}/restore`

## Phase 1: 스크랩 실행

```
POST /api/scraping/run
{ "url": "...", "selector": ".content", "target_id": null }

응답: { id, title, content, status: "DRAFT", scraped_at }
```

## Phase 2: 게시

```
POST /api/scraping/results/{id}/publish
{ "room": "ops", "message": "커스텀 메시지 (선택)" }

→ status: PUBLISHED
→ POST /api/messenger/webhook (scrap_published 이벤트)
```

## Phase 3: 삭제/원복

```
DELETE /api/scraping/results/{id}     → status: DELETED
POST   /api/scraping/results/{id}/restore  → status: DRAFT
```

## 봇 명령어 (messenger.py)

| 명령어 | API 호출 |
|--------|---------|
| `!scrap <url>` | POST /api/scraping/run |
| `!scrap list [n]` | GET /api/scraping/results?size=n |
| `!scrap publish <id>` | POST /api/scraping/results/{id}/publish |
| `!scrap del <id>` | DELETE /api/scraping/results/{id} |
| `!scrap restore <id>` | POST /api/scraping/results/{id}/restore |
| `!scrap status <id>` | GET /api/scraping/results/{id} |

## 테스트 시나리오

정상: POST run → DRAFT → publish → PUBLISHED → messenger 수신
오류: 존재하지 않는 URL → status=FAILED, 서비스 무중단
