채널 실연동 — 플랫폼 자격증명 발급 안내 (사용자 직접 수행 필요)

대상 서비스: branding.crowny.org (크라우니 마케팅 OS) — 채널 "오늘의 화장품" 유튜브 핸들: www.youtube.com/@today-cosmetic 이 문서의 작업은 클로드가 대신할 수 없다 — 각 플랫폼이 사람의 로그인·동의·심사를 요구한다.

0. 공통 준비

리디렉션 URI(콜백)는 전 플랫폼 공통으로 아래를 등록한다.

https://branding.crowny.org/api/oauth/<플랫폼>/callback

로컬 테스트용도 함께 등록: http://127.0.0.1:9630/api/oauth/<플랫폼>/callback

발급받은 값은 채팅에 붙여넣지 말 것. 아래 파일에 직접 기입한다:

/Users/ef/crowny-brand/.env (권한 600, git·crowny-hub 커밋 제외)

1. 유튜브 (Google Cloud Console) — 난이도 하, 가장 먼저

읽기전용(구독자·조회수·영상목록)은 API 키만으로 즉시 가능하다. 업로드·댓글은 OAuth가 필요하다.

1-A. 읽기 전용 (API 키) — 오늘 바로 가능

1. https://console.cloud.google.com → 프로젝트 생성 (이름 예: crowny-marketing-os)
2. API 및 서비스 → 라이브러리 → YouTube Data API v3 검색 → 사용 설정
3. 사용자 인증 정보 → 사용자 인증 정보 만들기 → API 키
4. 생성된 키 → 키 제한: API 제한 = YouTube Data API v3 만
5. .env에 기입: YOUTUBE_API_KEY=...

• 무료 할당량 10,000 units/일. 채널 통계 조회 1건 = 1 unit이라 충분.

1-B. 업로드·댓글 (OAuth 2.0) — 심사 필요

1. OAuth 동의 화면 구성 → 사용자 유형 외부 → 앱 이름·지원 이메일·개발자 연락처 입력
2. 범위(scope) 추가:

- https://www.googleapis.com/auth/youtube.readonly (인사이트) - https://www.googleapis.com/auth/youtube.upload (업로드) - https://www.googleapis.com/auth/youtube.force-ssl (댓글 읽기·쓰기)

1. 테스트 사용자에 본인 구글 계정 추가 → 심사 없이 바로 테스트 가능(토큰 7일 만료)
2. 사용자 인증 정보 → OAuth 클라이언트 ID → 웹 애플리케이션 → 위 리디렉션 URI 2개 등록
3. .env: GOOGLE_CLIENT_ID=... / GOOGLE_CLIENT_SECRET=...

• ⚠️ 프로덕션 전환(테스트 사용자 밖 공개)은 Google 심사 필요 — 본인 채널만 쓸 거면 테스트 사용자 상태로 충분하다.

2. 인스타그램 (Meta for Developers) — 난이도 중, 선행조건 있음

선행조건 (이게 없으면 API 자체가 불가)

• 인스타그램 계정이 프로페셔널 계정(비즈니스 또는 크리에이터) 이어야 한다 (개인계정 불가)
• 그 계정이 페이스북 페이지와 연결되어 있어야 한다

→ 앱 만들 때 이 두 가지를 먼저 처리할 것.

절차

1. https://developers.facebook.com → 내 앱 → 앱 만들기 → 유형 비즈니스
2. 제품 추가: Instagram Graph API (+ Facebook 로그인)
3. 앱 설정 → 기본 설정에서 앱 ID/시크릿 확인
4. Facebook 로그인 → 설정 → 유효한 OAuth 리디렉션 URI에 위 콜백 등록
5. 권한 요청: instagram_basic, instagram_content_publish, instagram_manage_comments, instagram_manage_insights, pages_show_list
6. .env: META_APP_ID=... / META_APP_SECRET=...

• ⚠️ 개발 모드에서는 앱 역할에 추가된 계정만 동작. 본인 계정만 쓸 거면 앱 검수 불필요.
• ⚠️ Instagram Graph API는 릴스 업로드 가능하나 스토리는 제한적. 쇼츠형 콘텐츠는 릴스로 발행.

3. 틱톡 (TikTok for Developers) — 난이도 상, 심사 필수

1. https://developers.tiktok.com → Manage apps → Connect an app
2. 앱 정보 입력 → Add products: Login Kit, Content Posting API, Research API(인사이트 원할 시)
3. Redirect URI에 위 콜백 등록
4. 범위: user.info.basic, user.info.stats, video.publish, video.list, comment.list
5. .env: TIKTOK_CLIENT_KEY=... / TIKTOK_CLIENT_SECRET=...

• ⚠️ Content Posting API는 앱 심사(App Review) 승인 전까지 비공개 게시만 가능(SELF_ONLY). 승인에 수일~수주.
• ⚠️ 심사 시 앱 사용 시연 영상·개인정보처리방침 URL을 요구한다. 개인정보처리방침은 crowny.org 아래에 페이지가 필요할 수 있음.

4. 티옴타 — 자사 서비스라 외부 발급 불필요

• tiomta.com은 크라우니 자산이므로 OAuth 발급 없이 내부 토큰으로 연결한다.
• "오늘의 화장품" = 티옴타 내 브랜드/상점 개설(사용자 확정). 별도 자격증명 없음.

5. 발급 완료 후 사용자가 할 일

.env에 아래 형식으로 기입하고 알려주면, 연동 활성화·실데이터 검증은 클로드가 수행한다.

YOUTUBE_API_KEY=
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
META_APP_ID=
META_APP_SECRET=
TIKTOK_CLIENT_KEY=
TIKTOK_CLIENT_SECRET=

권장 순서

① 유튜브 API 키(오늘 10분) → ② 티옴타 브랜드 개설(자사, 즉시) → ③ 유튜브 OAuth 테스트사용자 → ④ 인스타(프로페셔널 계정 전환 선행) → ⑤ 틱톡(심사 리드타임 길어 가장 먼저 신청만 넣어두는 것도 방법)

틱톡은 심사가 오래 걸리므로 ①과 동시에 신청서만 먼저 접수해두는 편이 총 소요를 줄인다.