Facebook·Threads 직접 API 연동

스케줄러를 쓰지 않는 이유

이 강은 선택 과정입니다. 7강까지의 스케줄러 방식으로 이미 충분하다면 건너뛰어도 됩니다. 설정이 길고(Meta 앱, 토큰) 어렵게 느껴지면 Threads 한 채널만 해보세요. 모든 발행은 --draft로 먼저 확인한 뒤, 사람이 최종 발행합니다.

용어 한 줄: Graph API는 페이스북의 공식 창구, Page Access Token은 "이 페이지에 글을 써도 된다"는 열쇠(비밀번호 같은 것, .env에만 보관), 앱 리뷰는 Meta가 앱 권한을 심사하는 절차입니다.

5강까지는 스케줄러 하나에 모든 채널을 연결했습니다. 그런데 두 가지 경우에는 직접 API를 쓰는 게 낫습니다.

1. 스케줄러 비용을 줄이고 싶을 때 — Facebook 페이지와 Threads는 공식 API가 무료입니다
2. 파이프라인 안에서 발행까지 한 번에 돌리고 싶을 때 — 스크립트 한 줄로 끝

이 강에서는 Facebook Graph API(페이지)와 Meta Threads API를 직접 연동합니다.

---

Facebook

Facebook은 페이지와 개인 프로필의 자동화 범위가 다릅니다.

페이지 — Graph API로 자동 포스팅

Facebook 페이지(예: "영어 듣기 대충영어" 같은 브랜드 페이지)는 Graph API로 텍스트·이미지·링크 포스팅이 가능합니다.

따라하기 1: 앱 만들기 & Page Access Token 발급

1. Meta for Developers 접속: developers.facebook.com 로그인
2. 앱 만들기: 내 앱 → 앱 만들기 → 비즈니스 유형 선택 → 앱 이름 입력
3. 제품 추가: 앱 대시보드에서 Facebook 로그인 제품 추가
4. Graph API 탐색기에서 토큰 발급: developers.facebook.com/tools/explorer
   • 앱 선택 → Get User Access Token → 권한에 pages_manage_posts, pages_read_engagement 체크
   • 토큰 받은 뒤 → 페이지 액세스 토큰으로 교환: 드롭다운에서 페이지 선택
5. 장기 토큰으로 교환: 단기 토큰은 1~2시간 만료. Claude Code에게 시킵니다:

.env에 추가:

FB_APP_ID=...
FB_APP_SECRET=...
FB_PAGE_ID=...
FB_PAGE_ACCESS_TOKEN=장기토큰

따라하기 2: 포스팅 스크립트

실행도 클로드 데스크탑 Code 탭에서 이렇게 시키세요.

scripts/fb-post.py를 --draft 옵션으로 실행해서 비공개로 먼저 올려줘. 결과 URL을 알려줘.

권한 요청의 명령에 --draft가 들어 있는지 읽고 수락합니다. 비공개 결과를 확인한 뒤에만 "이제 --draft 없이 실제로 발행해줘"라고 시키세요.

터미널로도 할 수 있어요

python3 scripts/fb-post.py --draft     # 비공개로 먼저 확인
python3 scripts/fb-post.py              # 실제 발행

더 해보기(선택): 예약 발행

Graph API는 예약 발행도 지원합니다:

더 해보기(선택): 개인 프로필 — Aside 브라우저 방식

개인 프로필(예: "오승종")은 Graph API로 자동 포스팅이 제한됩니다. publish_to_groups, user_posts 등의 권한은 앱 리뷰(Meta 심사)를 통과해야 하고, 개인 계정용 발행 API는 사실상 닫혀 있습니다.

현실적인 방법은 **Aside 브라우저(Computer Use)**입니다:

개인 프로필 포스팅이 필요한 분만 하세요. 페이지 하나로 충분한 경우가 많습니다.

---

Threads — Meta Threads API로 직접 발행

Meta는 Threads API를 공식 공개했습니다. 텍스트, 이미지, 링크 포스팅이 가능합니다.

따라하기 4: Threads API 설정

1. 같은 Meta 앱 사용: 따라하기 1에서 만든 앱을 그대로 씁니다
2. 제품 추가: 앱 대시보드 → Threads API 사용 사례 제품 추가
3. 권한 설정: threads_basic, threads_content_publish 스코프 추가
4. Access Token: Facebook 로그인 플로우로 Threads 토큰을 발급받습니다

.env에 추가:

THREADS_USER_ID=...
THREADS_ACCESS_TOKEN=장기토큰

따라하기 5: Threads 포스팅 스크립트

Code 탭에서는 이렇게 시키세요.

scripts/threads-post.py를 --draft 옵션으로 실행해서 컨테이너만 만들어줘. 확인하기 전에는 발행하지 마.

확인 후에 "이제 실제로 발행해줘"라고 하면 됩니다. 권한 요청의 명령을 매번 읽고 수락하세요.

터미널로도 할 수 있어요

python3 scripts/threads-post.py --draft   # 컨테이너만 생성
python3 scripts/threads-post.py            # 실제 발행

Threads API 제약 사항

항목	내용
발행 한도	24시간 내 250개 (충분)
지원 미디어	텍스트, 이미지(JPEG/PNG), 동영상, 캐러셀
답글	API로 가능하지만 이 과정에서는 손으로
인사이트	threads_basic 스코프로 조회수·좋아요 등 수집 가능

---

스킬 파이프라인에 추가

7강에서 만든 SNS 배포 스킬에 직접 API 발행 단계를 추가합니다:

## 3-B. 직접 API 발행 (8강, 선택)
- 스케줄러 대신 직접 API를 쓰는 채널:
  - Facebook 페이지: `python3 scripts/fb-post.py --draft` → ⏸ 확인 → 발행
  - Threads: `python3 scripts/threads-post.py --draft` → ⏸ 확인 → 발행
- 개인 프로필은 Computer Use로 반자동
- 나머지 채널은 기존 스케줄러 경로 유지

channels.json 업데이트

channels.json에 Facebook과 Threads 직접 API 경로를 추가합니다:

토큰 만료 관리

토큰	유효기간	갱신
Facebook Page (장기)	60일	60일마다 재발급. 스크립트에 만료 7일 전 경고 추가
Threads (장기)	60일	같은 방식. token_expires 필드를 .env에
Facebook 개인 프로필	—	Aside 방식이라 토큰 불필요

오늘의 체크리스트

• (선택 과정) Meta for Developers에 앱을 만들고 Page Access Token을 발급했다
• fb-post.py --draft로 비공개 게시 후 확인, 발행까지 성공했다
• Threads API 토큰을 발급하고 threads-post.py로 텍스트+링크 발행에 성공했다
• channels.json에 facebook-page, threads 채널이 추가됐다
• 스킬 파일에 직접 API 발행 단계(3-B)가 있다
• 커밋했다

다음 단계

이 과정의 7개 채널(X·스레드·인스타·링크드인·카카오채널·Facebook 페이지·Facebook 개인)이 모두 갖춰졌습니다. "배포해줘" 한 줄이면 스케줄러 경로와 직접 API 경로가 함께 돌아갑니다.