Claude Code에서 Threads 포스트를 자동으로 작성하고 게시할 수 있는 스킬을 만들었습니다. Meta Threads API를 활용하여 텍스트, 이미지, 캐러셀 포스트는 물론 댓글과 대댓글까지 프로그래밍 방식으로 처리합니다.
TL;DR
- Claude Code 스킬로 Threads 포스트 작성/게시를 자동화
- 텍스트, 이미지, 캐러셀(다중 이미지) 포스트 지원
- 댓글/대댓글 최대 3단계까지 지원
- 기술 공유, 작업 세션 정리, 브랜드 홍보, 교육 콘텐츠 등 용도별 템플릿 내장
- 자연어 명령 한 줄로 포스트 초안 생성부터 게시까지 완료
왜 만들었나
개발 작업 중 얻은 인사이트나 제품 업데이트를 Threads에 공유하려면, 매번 앱을 열고 글을 작성하는 과정이 필요합니다. 특히 기술적인 내용을 500자 이내로 정리하거나, 브랜드 톤에 맞게 홍보 포스트를 쓰는 건 생각보다 시간이 걸립니다.
Claude Code 안에서 작업 흐름을 끊지 않고, 자연어 한 줄로 Threads에 바로 게시할 수 있으면 훨씬 편리할 것이라 판단했습니다.
스킬 구조
스킬은 세 개의 파일로 구성됩니다:
threads-post/
├── SKILL.md # 워크플로우, API 사용법, 제약사항
├── scripts/
│ └── publish_thread.py # Threads API 게시 스크립트
└── references/
└── post-templates.md # 용도별 포스트 템플릿- SKILL.md: Claude가 언제/어떻게 이 스킬을 사용할지 판단하는 핵심 파일
- publish_thread.py: Meta Threads API의 2단계 게시 플로우(컨테이너 생성 → 퍼블리시)를 처리하는 Python 스크립트
- post-templates.md: 상황별 포스트 작성 템플릿 모음
사용 편의성: 자연어로 바로 게시
이 스킬의 핵심 장점은 자연어 명령만으로 모든 게시 작업이 완료된다는 점입니다. API 파라미터나 엔드포인트를 알 필요가 없습니다.
포스트 작성 예시
Claude Code에서 아래처럼 입력하면 됩니다:
# 기술 콘텐츠 공유
오늘 Python에서 match 문의 구조적 패턴 매칭 배운 거 쓰레드에 올려줘
# 브랜드 홍보
우리 서비스 소개하는 쓰레드 포스트 작성해줘. AI 기반 업무 자동화 플랫폼이고 링크 포함해줘
# 교육 콘텐츠
FastAPI 마스터 강의 소개 쓰레드 포스트 써줘
# 작업 세션 정리
오늘 세션에서 작업한 내용 쓰레드에 정리해줘Claude는 요청을 분석하여 용도에 맞는 템플릿을 선택하고, 500자 이내의 초안을 작성한 후 확인을 거쳐 게시합니다.
댓글과 대댓글도 동일한 방식
# 댓글 달기
포스트 18050206876707110에 "좋은 인사이트네요!" 댓글 달아줘
# 대댓글 달기
댓글 18099887766554433에 대댓글 달아줘. 수강 안내 내용으로포스트 ID만 알려주면 댓글/대댓글(최대 3단계)까지 동일한 플로우로 처리됩니다.
지원하는 콘텐츠 유형
미디어 타입
| 유형 | 설명 | 사용 예 |
|---|---|---|
| TEXT | 텍스트만 | TIL, 의견 공유 |
| IMAGE | 텍스트 + 이미지 1개 | 스크린샷 포함 소개 |
| CAROUSEL | 텍스트 + 이미지 2~20개 | 제품 이미지 슬라이드 |
용도별 템플릿
스킬에는 다섯 가지 용도에 맞는 포스트 템플릿이 내장되어 있습니다:
- 기술 콘텐츠 공유 — TIL, 기술 팁, 도구/라이브러리 추천
- 작업 세션 정리 — 오늘의 개발 로그, 문제 해결 기록
- 기업/브랜드 홍보 — 제품 소개, 업데이트 발표, 이벤트 안내, 고객 사례
- 교육 콘텐츠 소개 — 강의/코스 소개, 워크숍 안내, 학습 로드맵, 수강생 후기
- 일반 포스트 — 의견 공유, 링크 공유
Claude가 요청 내용을 분석하여 적절한 템플릿을 자동으로 선택합니다.
기술적 구현
연동 방식 도식
아래 도식은 사용자의 자연어 입력이 Threads API를 통해 게시되기까지의 전체 플로우를 보여줍니다.
Threads API 2단계 게시 플로우
Meta Threads API는 두 단계로 게시가 이루어집니다.
- 컨테이너 생성:
POST /{user_id}/threads— 미디어 타입, 텍스트, 이미지 URL 등을 담은 드래프트 생성 - 퍼블리시:
POST /{user_id}/threads_publish— 생성된 컨테이너를 실제로 게시
댓글/대댓글의 경우 1단계에서 reply_to_id 파라미터만 추가하면 되므로, 포스트와 댓글이 동일한 코드 경로를 공유합니다.
publish_thread.py 핵심 옵션
| 옵션 | 설명 |
|---|---|
--text | 포스트 텍스트 (최대 500자) |
--image-url | 이미지 공개 URL |
--carousel-images | 캐러셀 이미지 URL (쉼표 구분, 2~20개) |
--reply-to | 답글 대상 미디어 ID (최대 3단계) |
--dry-run | 게시 없이 페이로드만 확인 |
스크립트는 표준 라이브러리(urllib)만 사용하므로 별도 패키지 설치가 필요 없습니다.
장점 정리
1. 작업 흐름 유지
Claude Code에서 코딩하다가 바로 Threads에 공유할 수 있습니다. 브라우저를 열거나 앱을 전환할 필요 없이, 터미널에서 자연어로 요청하면 됩니다.
2. 500자 제약 자동 준수
Threads의 500자 제한, 해시태그 1개 제한을 Claude가 자동으로 검증합니다. 긴 내용도 핵심만 추려서 제한에 맞게 작성해 줍니다.
3. 용도별 최적화된 톤
기술 공유, 브랜드 홍보, 교육 콘텐츠 등 용도에 따라 다른 톤과 구조의 템플릿을 적용합니다. “TIL 공유”와 “제품 런칭 공지”는 전혀 다른 방식으로 작성됩니다.
4. 게시 전 확인 단계
항상 초안을 먼저 보여주고 사용자 확인 후 게시합니다. --dry-run 옵션으로 실제 API 호출 없이 페이로드를 미리 확인할 수도 있습니다.
5. 포스트-댓글-대댓글 통합 관리
하나의 스크립트와 동일한 워크플로우로 포스트, 댓글, 대댓글(최대 3단계)을 모두 처리합니다. --reply-to 파라미터 유무만 다를 뿐 나머지는 동일합니다.
6. 의존성 제로
Python 표준 라이브러리만 사용합니다. pip install 없이 Python 3만 있으면 바로 동작합니다.
Threads API 제약사항
스킬 사용 시 알아두면 좋은 API 제약사항입니다.
- 포스트당 최대 500자
- 해시태그 1개만 허용
- 24시간 내 최대 250개 게시 (댓글 포함)
- 이미지는 공개 URL 필요 (최대 8MB)
- 캐러셀은 2~20개 이미지
- 댓글 깊이 최대 3단계
- 링크 5개 초과 시 게시 실패
시작하기
사용을 위해 필요한 것은 두 가지입니다.
- Meta Developer Portal에서 Threads API 앱 생성 및 Access Token 발급
- 환경변수 설정:
export THREADS_ACCESS_TOKEN="your-long-lived-access-token"
export THREADS_USER_ID="your-threads-user-id"설정 후 Claude Code에서 “쓰레드 포스트 써줘”라고 말하면 스킬이 자동으로 활성화됩니다.
마치며
Claude Code 스킬 시스템의 강점은, 반복적인 작업을 한 번 정의해두면 이후에는 자연어 한 줄로 실행할 수 있다는 점입니다. Threads 포스팅도 마찬가지입니다. API 문서를 뒤지거나 curl 명령어를 조합할 필요 없이, 말만 하면 됩니다.
기술 블로그처럼 정기적으로 콘텐츠를 공유하거나, 제품 업데이트를 여러 채널에 동시에 알려야 하는 경우에 유용합니다.
전체 코드는 Github에서 확인할 수 있습니다: https://github.com/greeun/threads-post