# ThreadAuto 기술 리서치 보고서

**작성일**: 2026-03-04
**작성**: 개발1팀 (헤르메스 팀장, 불칸, 이리스, 아테나, 아르고스)
**프로젝트**: Meta Threads 계정 운영 자동화 시스템
**대상 계정**: 인카다이렉트-TOP사업단 홍보용

---

## 목차

1. Meta Threads API
2. 카드뉴스 이미지 자동 생성
3. 보험업계 뉴스 크롤링
4. 랜딩페이지 파싱
5. LLM 콘텐츠 생성
6. 기술스택 제안

---

## 1. Meta Threads API (불칸 리서치)

### 1-1. 현황 요약

Meta는 2024년 6월 Threads API를 공식 출시했으며, 2025년 7월까지 대규모 기능 확장을 진행했다. 현재 **게시글 발행, 이미지/동영상 업로드, 캐러셀(최대 20장), 댓글 관리, 분석(Analytics)** 까지 포괄적으로 지원한다. 비공식 방법은 불필요하다.

### 1-2. 인증 방법 (OAuth 2.0)

**Base URL**: `https://graph.threads.net/v1.0/`

**필요 권한(Scopes)**:
- `threads_basic` — 프로필/게시글 조회
- `threads_content_publish` — 게시글 발행
- `threads_manage_replies` — 댓글 관리
- `threads_read_replies` — 댓글 조회
- `threads_manage_insights` — 분석 지표 조회

**토큰 발급 3단계**:

1. **인증 코드 요청** (브라우저 리다이렉트)
```
GET https://threads.net/oauth/authorize
  ?client_id={APP_ID}
  &redirect_uri={REDIRECT_URI}
  &scope=threads_basic,threads_content_publish,threads_manage_replies,threads_manage_insights
  &response_type=code
```

2. **단기 액세스 토큰 발급** (유효기간: 1시간)
```
POST https://graph.threads.net/oauth/access_token
Body: client_id, client_secret, grant_type=authorization_code, redirect_uri, code
```

3. **장기 액세스 토큰 교환** (유효기간: 60일, 만료 1일 전부터 갱신 가능)
```
GET https://graph.threads.net/access_token
  ?grant_type=th_exchange_token&client_secret={SECRET}&access_token={SHORT_TOKEN}
```

### 1-3. 주요 엔드포인트

**이미지 게시 (2단계)**:
```python
# Step 1: 미디어 컨테이너 생성 (이미지는 반드시 공개 HTTPS URL)
POST /v1.0/{USER_ID}/threads
  { "media_type": "IMAGE", "image_url": "https://cdn.example.com/image.jpg", "text": "캡션" }

# 30초 대기 권장

# Step 2: 발행
POST /v1.0/{USER_ID}/threads_publish
  { "creation_id": "MEDIA_CONTAINER_ID" }
```

**캐러셀 게시 (3단계)**:
```python
# Step 1: 각 이미지별 컨테이너 (최대 20개, is_carousel_item=true)
# Step 2: 캐러셀 컨테이너 묶기 (media_type=CAROUSEL, children=id1,id2,id3)
# Step 3: 발행
```

**댓글 관리**: 조회(`GET /replies`), 숨기기(`POST /manage_reply`), 답글 달기

**분석(Insights)**: views, likes, replies, reposts, quotes, clicks, shares, followers_count

### 1-4. Rate Limit 및 제한사항

- **발행**: 250건/24시간 (계정당) — 하루 10건은 충분
- **텍스트**: 최대 500자
- **캐러셀**: 최대 20장
- **이미지**: 반드시 **공개 HTTPS URL** (로컬 파일 업로드 불가)
- **컨테이너 생성 후**: 30초 대기 권장
- Rate limit 초과 시 HTTP 429 → Exponential Backoff 필수
- `X-RateLimit-Remaining` 헤더로 잔여 횟수 확인 가능

### 1-5. 2025년 7월 신규 기능

- 설문조사(Poll) 생성 및 결과 조회
- 위치 태그 검색/추가
- 단일 API 호출 텍스트 발행 (simplified publishing)
- 실시간 웹훅(Webhooks)
- 토픽 태그(Topic Tags)
- 클릭 메트릭 (링크 클릭 수 추적)
- GIF 미디어 지원
- 액세스 토큰 디버깅 도구

### 1-6. 추천 접근법

- **공식 API 사용 (권장)**: Meta Developer Portal에서 앱 생성 → 권한 신청
- 이미지는 GCS/S3에 업로드 후 공개 URL 생성하여 API에 전달
- 장기 토큰(60일) DB 저장 + 만료 전 자동 갱신 로직 구현
- `ThreadsPipe-py` 라이브러리 활용 고려
- 비공식 대안은 ToS 위반 위험 → 프로덕션 비권장

---

## 2. 카드뉴스 이미지 자동 생성 (이리스 리서치)

### 2-1. 템플릿 기반 방식 비교

**A. Python Pillow**
- 장점: 서버 비용 없음, 처리 속도 최고(< 100ms/장), 세밀한 픽셀 제어
- 단점: 복잡한 레이아웃 구현 어려움, CSS 미지원, 웹 디자이너 작업 어려움
- 평가: 정형화된 카드뉴스에 **가장 적합**

**B. html2image (Headless Chrome)**
- 장점: HTML/CSS로 템플릿 작성 가능, 브라우저 렌더링 품질, 웹폰트 완벽 지원
- 단점: Chromium 메모리 소비(200~400MB), 서버에 Chrome 필요
- 처리 속도: 500ms~2s/장

**C. Playwright 스크린샷**
- 장점: 픽셀 퍼펙트, 멀티 브라우저, Python 공식 지원, 2025년 기준 사실상 표준
- 단점: Chromium 인스턴스 관리 필요, 메모리 높음

**D. node-canvas (Canvas API)**
- 장점: 브라우저 없이 고속 처리
- 단점: CSS 미지원, 한글 설정 복잡

### 2-2. AI 이미지 생성 비교

**DALL-E / GPT Image API**:
- GPT Image 1 Mini (Low): $0.005/장 — 가성비
- DALL-E 3 Standard: $0.040/장
- DALL-E 3 HD: $0.080~$0.120/장
- 단점: 한글 텍스트 렌더링 품질 불안정, 일관성 낮음

**Midjourney**: 공식 API 없음, 비공식 래퍼만 존재, ToS 위반 위험 → 비권장

**Stable Diffusion**: API $0.030~$0.065/장, 로컬 시 GPU 서버 필요

### 2-3. 템플릿 vs AI 비교 결론

- **비용**: 템플릿 거의 무료 vs AI $60~120/월
- **일관성**: 템플릿 100% vs AI 매번 다름
- **한글**: 템플릿 완벽 vs AI 오류 빈번
- **속도**: 템플릿 0.5~2초 vs AI 5~15초
- **브랜드 가이드**: 템플릿 완벽 준수 vs AI 어려움

**결론: 카드뉴스 본체는 Pillow 템플릿 방식, 배경 이미지만 선택적 AI 생성 권장**

### 2-4. 하루 10건 이미지 생성 월간 비용

- Pillow/Playwright: $0 (서버 비용만)
- GPT Image 1 Mini (Low): $7.50/월
- DALL-E 3 Standard: $60/월
- DALL-E 3 HD: $120/월

---

## 3. 보험업계 뉴스 크롤링 (아르고스 리서치)

### 3-1. 사이트별 크롤링 가능성

**즉시 활용 가능 RSS 피드 (7개)**:
- 다자비 보험AI뉴스: `dazabi.com/insurance_magazine/rss.php`
- 뉴스와이어 보험: `api.newswire.co.kr/rss/industry/204`
- 이투데이 금융: `rss.etoday.co.kr/eto/finance_news.xml`
- 이데일리 금융: `rss.edaily.co.kr/finance_news.xml`
- 한국경제 경제: `rss.hankyung.com/economy.xml`
- 매일경제 경제: `news.mk.co.kr/rss/economy_all.xml`
- 파이낸셜뉴스 금융: `www.fnnews.com/rss/fn_realnews_finance.xml`

**requests+BS4 크롤링 가능**:
- 보험신보 (insweek.co.kr) — 정적 HTML
- 한국금융신문 (fntimes.com) — 정적 HTML, 706페이지
- 전자신문 (etnews.com) — 정적+추적JS
- 이투데이 (etoday.co.kr) — 서버렌더링
- 머니투데이 (mt.co.kr) — 기사 ID 기반

**403 차단 (Playwright 필요)**:
- 한국보험신문 (insnews.co.kr)
- 보험저널 (insjournal.co.kr)
- 보험매일 (fins.co.kr)

**네이버 뉴스 API**: 무료 25,000회/일, 키워드 검색 보완용

### 3-2. 이직 유도 소재 핵심 키워드

**1차 (이직 직접 관련)**: 정착지원금, 스카우트, 영입, GA 이직, 전속→GA, 사업단 모집, 리크루팅

**2차 (업계 환경 변화)**: 1200%룰, 수수료 상한제, GA 성장, 제판분리, 보험사 구조조정

**3차 (이직 유인)**: 수당체계, 성과급, 보험설계사 연봉, DB제공, 설계사 수 감소

### 3-3. 소재 추출 파이프라인

```
RSS 수집 → 키워드 1차 필터 → 문맥 2차 필터 → 소재 유형 분류
  ↓ 유형: 규제변화형 / 수입비교형 / 성공사례형 / 시장환경형 / 불안해소형
```

### 3-4. 크롤링 주기

- RSS 피드: 매시간
- 보험전문사이트: 3시간마다
- 종합경제지: 6시간마다
- 네이버 API: 1일 2회

### 3-5. 추천 구현 순서

- Phase 1 (1주): RSS 7개 피드 즉시 구현
- Phase 2 (1~2주): 정적 크롤링 (한국금융신문, 보험신보, 네이버 API)
- Phase 3 (2~4주): 동적 크롤링 (403 차단 사이트 Playwright 우회)

---

## 4. 랜딩페이지 파싱 (불칸 리서치)

### 4-1. incar-top1.tistory.com 구조 분석

**사이트 특성**: 티스토리에 호스팅된 **단일 페이지 랜딩페이지(SPA)** — 블로그가 아님
- Tailwind CSS + Vanilla JS
- Google Apps Script 연동 리드 수집 폼
- Meta Pixel 리드 전환 추적
- 이미지: `tistory1.daumcdn.net` CDN

**페이지 구조**:
```
Hero Section → INCAR Profile → Growth Engine → Leadership (3D Flip-card)
→ Core System (5가지 서비스) → Packages & Benefits (30+ 혜택)
→ Reviews (캐러셀) → Contact Form
```

### 4-2. 크롤링 방법

- **Playwright 권장** (JS 렌더링 필수 — Intersection Observer, 애니메이션 기반)
- `requests`만으로는 실질적 콘텐츠 추출 불가
- 티스토리 Open API는 2024년 2월 완전 종료
- RSS 피드 없음 (랜딩페이지이므로)

### 4-3. 추천 파이프라인

```
Playwright (headless Chromium)
  → wait_for_load_state("networkidle") + 스크롤 시뮬레이션
  → page.content() → BeautifulSoup 후처리
  → 구조화된 JSON (headline, services, benefits, images, cta)
  → 이미지 다운로드 → GCS 업로드 → Threads API image_url 전달
```

---

## 5. LLM 콘텐츠 생성 (이리스 리서치)

### 5-1. 프롬프트 설계 방향

**톤앤매너**: 전문적 + 친근, 수치/데이터 기반, 동기부여 중심, 과장 배제

**카드뉴스 5슬라이드 구조**:
1. 공감형 훅 제목 (15자 이내)
2. 공감 (현재 고민 나열)
3. 가치 제안 (3가지 이유)
4. 신뢰 증거 (통계/수치)
5. CTA (행동 유도 + 연락처)

**금지사항**: 현 직장 비하, 과도한 수익 보장, 금감원 규정 위반, 경쟁사 직접 언급

### 5-2. 하루 10건 LLM 비용 추정

토큰 추정: 1건당 입력 ~700 / 출력 ~600 토큰
월간: 입력 210K / 출력 180K 토큰

- GPT-4o-mini: **$0.14/월**
- Claude Haiku 4.5: **$1.11/월**
- GPT-4o: **$2.34/월**
- Claude Sonnet 4.6: **$3.33/월**
- Claude Opus 4.6: **$5.55/월**

**결론**: 모든 모델에서 월 $10 미만으로 매우 저렴. 품질이 선택 기준.

### 5-3. 콘텐츠 품질 관리

1. 구조화된 출력 강제 (JSON Schema / XML 태그)
2. 금지 키워드 필터링 (금융광고 규정 자동 검증)
3. 다양성 보장 (최근 30건 히스토리, 주제 카테고리 로테이션)
4. A/B 테스트 (CTA 2개 버전 → 성과 피드백)

---

## 6. 기술스택 제안 (아테나 리서치)

### 6-1. 전체 아키텍처

```
[콘텐츠 소스]
  ├── 랜딩페이지 크롤러 (Playwright)
  ├── 보험뉴스 RSS 크롤러 (feedparser)
  └── 수동 입력 (Admin Web UI)
        ↓
[AI 콘텐츠 엔진]         [이미지 생성 엔진]
  Claude Haiku             Pillow 템플릿 렌더링
        ↓                       ↓
[스케줄러 & 큐]
  Cloud Scheduler → Cloud Tasks → Cloud Run Workers
        ↓
[Threads API 발행]
  Meta Threads Graph API (공식 OAuth 2.0)
        ↓
[모니터링/알림]
  Firestore (로그) + Slack Webhook (알림)
```

### 6-2. 기술스택 상세

- **언어**: Python 3.12
- **프레임워크**: FastAPI (비동기, 자동 API 문서화)
- **이미지 생성**: Pillow + Jinja2 (브랜드 일관성, 비용 무료)
- **AI/LLM**: Claude Haiku 4.5 (한국어 우수, 저비용) → Sonnet 업그레이드 가능
- **크롤링**: feedparser (RSS), requests+BS4 (정적), Playwright (동적)
- **스케줄링**: Cloud Scheduler + Cloud Tasks
- **배포**: Cloud Run (Docker 컨테이너, 서버리스)
- **DB**: Firebase Firestore
- **이미지 저장**: Google Cloud Storage (공개 URL → Threads API)
- **시크릿**: GCP Secret Manager
- **모니터링**: Cloud Logging + Slack Webhook
- **관리 UI**: Firebase Hosting (React)

### 6-3. 카드뉴스 디자인 가이드

**Threads 권장 이미지**: 1080 x 1350px (4:5 비율)

**브랜드 컬러**:
- Primary: #003087 (인카다이렉트 코퍼레이트 블루)
- Accent: #C9A84C (골드 — 프리미엄/성공)
- Background: #FFFFFF
- Text Dark: #1A1A2E
- Highlight: #FF6B35 (긴급/강조)

**폰트**: Pretendard Bold(제목 48~64px), SemiBold(소제목 32~40px), Regular(본문 22~28px)

### 6-4. 카드뉴스 5가지 템플릿 타입

- **Type A (숫자훅)**: 수치/연봉 강조 → 클릭률 극대화
- **Type B (뉴스카드)**: 업계 뉴스 + 인사이트 코멘트 → 전문성 구축
- **Type C (비교카드)**: 현재 vs TOP사업단 비교 → 이직 욕구 자극
- **Type D (성공스토리)**: 설계사 사례/인용구 → 공감 + 신뢰
- **Type E (체크리스트)**: 이직 체크리스트/팁 → 저장/공유 유도

### 6-5. 발행 스케줄 (하루 10건)

```
08:00 출근 — 동기부여 (Type A)
09:30 업무 시작 — 업계 뉴스 (Type B)
11:00 오전 중반 — 비교 카드 (Type C)
12:30 점심 — 성공스토리 (Type D)
14:00 오후 — 체크리스트 (Type E)
15:30 미팅 전후 — 숫자훅 변형 (Type A)
17:00 영업 마감 — 뉴스 (Type B)
18:30 퇴근 — 이직 유도 (Type C)
20:00 저녁 — 성공스토리 (Type D)
21:30 취침 전 — CTA 강조 (Type E)
```

### 6-6. 월간 인프라 비용 추정

GCP Free tier 내 운영 가능: **$0~$5/월**
- Cloud Run, Cloud Scheduler, Cloud Tasks, Firestore, GCS 모두 무료 범위
- LLM 비용: $1~5/월
- 이미지 AI(선택): $0~8/월
- **총 예상 월 비용: $5~15/월** (풀 템플릿 방식 기준)

### 6-7. 구현 로드맵

- Phase 1 (1주): Threads API OAuth 인증 + 단일 게시 검증
- Phase 2 (2주): Pillow 카드뉴스 렌더러 5템플릿 구현
- Phase 3 (3주): Claude API + 크롤러 + Firestore 파이프라인
- Phase 4 (4주): Cloud Scheduler + Slack 모니터링
- Phase 5 (5주): 관리자 대시보드 + 전체 통합 테스트

---

## 7. 종합 결론

### 핵심 판단

1. **Threads API**: 공식 API 충분히 성숙. 비공식 방법 불필요. 하루 10건은 Rate Limit 여유.
2. **이미지 생성**: Pillow 템플릿 방식이 압도적 우위 (비용 $0, 일관성 100%, 한글 완벽).
3. **뉴스 크롤링**: RSS 7개 즉시 활용 가능. 보험 전문지 403 차단은 Phase 3에서 해결.
4. **LLM 비용**: 모든 모델 월 $10 미만. Claude Haiku 추천 (한국어 품질 대비 비용 최적).
5. **인프라**: GCP Free tier로 월 $5~15 수준 운영 가능.

### 실현 가능성: **매우 높음**

- 기술적 장벽 없음 (모든 핵심 API/라이브러리 검증 완료)
- 비용 매우 저렴 (월 $15 이내)
- 5주 내 MVP 구현 가능
- 기존 GCP/Firebase 인프라 활용으로 추가 셋업 최소화

---

## 참고 소스

- Meta Threads API 공식 문서
- Anthropic Claude API Pricing
- OpenAI DALL-E / GPT Image Pricing
- Stability AI API Pricing
- Playwright 공식 문서
- Pillow (PIL Fork) 공식 문서
- 뉴스와이어 보험 RSS API
- 다자비 보험AI뉴스 RSS
- 이투데이/이데일리/한국경제/매일경제/파이낸셜뉴스 RSS
- 한국보험신문, 보험신보, 보험저널, 보험매일 웹사이트
- 네이버 뉴스 검색 API
- GCP Cloud Run / Cloud Scheduler / Firestore 문서