🔑 키 만들기 안내

이 사이트에서 쓰는 키·ID 를 만드는 방법입니다. 빨간 버튼을 누르면 그 단계의 화면이 바로 열립니다. 만든 키는 각 페이지 칸에 붙여넣으면 이 브라우저에만 저장됩니다(다른 PC·브라우저에서는 다시 입력). 구글 키 3종은 같은 구글 클라우드 프로젝트 하나에서 만들면 편합니다.

한눈에 보기

키어디에 넣나필요할 때비용
① YouTube API 키채널 조회 맨 위 · 롱폼 설정채널 조회·롱폼 벤치마킹 (필수)무료 (하루 10,000 단위)
② Gemini API 키롱폼 설정롱폼 분석·대본·이미지·음성 (필수)무료 등급 있음
③ 구글 OAuth 클라이언트 ID유튜브 자동화 → 올리기 → 「처음 한 번: 구글 클라이언트 ID」유튜브에 바로 올리기 (필수)무료
④ 버퍼 API 키유튜브 자동화 → 고급 → 버퍼 연동인스타·틱톡을 페이지에서 바로 보낼 때 (선택)버퍼 요금제 따름
⑤ GitHub 토큰유튜브 자동화 → 고급 → GitHub 저장 설정설정을 GitHub 에 저장 · 버퍼용 영상 주소 (선택)무료
⑥ 버퍼 Worker 앱 키유튜브 자동화 → 고급 → 버퍼 연동 ②버퍼 직접 호출이 막힐 때 (선택)무료
⑦ 데스크톱 앱 클라이언트PC 프로그램 uploader\.secrets\폴더만 넣으면 자동 업로드하는 PC 프로그램 (선택)무료

① YouTube Data API 키 필수 5분

넣는 곳: 채널 조회 맨 위 「API 키」, 롱폼 자동화 「설정 → YouTube 키」 (같은 키를 두 곳에)

  1. 구글 클라우드에 프로젝트 만들기 (이미 있으면 위쪽 프로젝트 선택만) 프로젝트 만들기 ↗
    이름은 아무거나(예: youtube-tools). 처음이면 약관 동의 화면이 먼저 나옵니다.
  2. YouTube Data API v3 사용 설정 → 「사용」 버튼 YouTube Data API v3 ↗
  3. 사용자 인증 정보 → 「+ 사용자 인증 정보 만들기」 → API 키 → 만들어진 키(AIza…) 복사 사용자 인증 정보 ↗
  4. (권장) 키 이름 클릭 → 「API 제한사항」 → 키 제한 → YouTube Data API v3 만 체크 → 저장. 키가 새어도 다른 곳에 못 씁니다.
  5. 채널 조회·롱폼 페이지의 칸에 붙여넣기 → 저장
한도: 하루 10,000 단위(무료). 주제 검색 1회 ≈ 101, 채널·영상 조회는 1~5 정도. 한국 시간 오후 4~5시에 초기화. quotaExceeded 가 나오면 다음 날 다시.

② Gemini API 키 롱폼 필수 2분

넣는 곳: 롱폼 자동화 「설정 → Gemini 키」

  1. 구글 AI 스튜디오에서 구글 계정으로 로그인 Gemini API 키 ↗
  2. 「API 키 만들기(Create API key)」 → 프로젝트를 고르라고 하면 ①에서 만든 프로젝트 선택(없으면 새로 만들어도 됨)
  3. 만들어진 키(AIza…) 복사 → 롱폼 설정 「Gemini 키」에 붙여넣기 → 저장 → 「모델 목록 불러오기」로 확인
무료 등급: 분당·하루 호출 수에 한도가 있어 429 가 나오면 1분쯤 기다렸다 다시. 이미지(나노바나나)·음성·Veo 영상 같은 모델은 무료 등급에서 한도가 작거나 막혀 있을 수 있습니다. 많이 쓰면 AI 스튜디오에서 결제(요금제)를 연결하세요. 한도 표 ↗ · 가격 ↗

③ 구글 OAuth 클라이언트 ID (웹) 유튜브 업로드 필수 10분 · 한 번만

넣는 곳: 유튜브 자동화 → 올리기 → 「처음 한 번: 구글 클라이언트 ID 만들기」 칸. 이후 「구글 계정(채널) 추가」로 채널을 넣습니다.

  1. ①과 같은 프로젝트에서 YouTube Data API v3 가 「사용」 상태인지 확인 YouTube Data API v3 ↗
  2. OAuth 동의 화면(구글 인증 플랫폼) 시작 → 앱 이름(아무거나)·지원 이메일 → 대상 외부 → 연락처 이메일 → 만들기 OAuth 동의 화면 ↗
  3. 대상(Audience) → 테스트 사용자 → 「+ Add users」 → 업로드할 채널의 구글 계정을 전부 추가 (채널 계정이 여러 개면 모두) 테스트 사용자 ↗
  4. 클라이언트 → 「+ 클라이언트 만들기」 → 애플리케이션 유형 웹 애플리케이션 클라이언트 만들기 ↗
  5. 「승인된 JavaScript 원본」 → 「+ URI 추가」 → 아래 주소를 그대로 (끝에 / 없이)
    https://shorts-uploader.pages.dev
    PC 미리보기(미리보기.bat)도 쓰면 http://localhost:8791 도 추가. 승인된 리디렉션 URI 는 비워 둠.
  6. 만들기 → 나오는 클라이언트 ID(…apps.googleusercontent.com) 복사 → 유튜브 자동화 올리기 화면 칸에 붙여넣기 (클라이언트 보안 비밀번호는 필요 없음)
  7. 「구글 계정(채널) 추가」 → 구글 창에서 계정·채널 선택 → "확인되지 않은 앱" 경고가 나오면 「고급 → (앱 이름)(으)로 이동」 → 허용
막히면: origin·redirect_uri_mismatch 오류 = 5번 주소가 다르거나 저장 후 몇 분 안 지남(최대 5분 대기). access_denied = 3번 테스트 사용자에 그 계정이 없음. 앱이 「테스트」 상태면 올린 영상이 비공개로 고정될 수 있어요(스튜디오에서 공개로 변경). 하루 업로드는 약 5~6편(API 한도).

④ 버퍼(Buffer) API 키 선택

넣는 곳: 유튜브 자동화 → 고급 → 버퍼 연동 ① · PC 프로그램은 uploader\.secrets\buffer-key.txt

  1. 버퍼에 로그인하고 인스타(비즈니스/크리에이터 계정)·틱톡 채널을 먼저 연결 버퍼 열기 ↗
  2. 오른쪽 위 계정 메뉴 → Settings → API → 키 만들기 → 복사
  3. 고급 → 버퍼 연동 ① 칸에 붙여넣기 → 「버퍼 사용」 켜기 → 「채널 확인」에 채널이 보이면 끝
참고: 네이버 클립은 버퍼가 지원하지 않습니다. 「연결 못 함」이 나오면 브라우저가 직접 호출을 막은 것 → ⑥ Worker 로 중계. 영상을 공개 주소로 만들려고 ⑤ GitHub 토큰도 필요합니다.

⑤ GitHub 토큰 (fine-grained) 선택

넣는 곳: 유튜브 자동화 → 고급 → GitHub 저장 설정 (설정 GitHub 저장, 버퍼용 영상 공개 주소)

  1. 새 토큰 만들기 화면 열기 GitHub 토큰 만들기 ↗
  2. 이름(예: shorts-uploader) · 만료 기간(예: 90일)
  3. Repository access → Only select repositories → 설정을 저장할 리포 1개 선택 (버퍼용이면 리포가 Public)
  4. Permissions → Repository permissions → Contents: Read and write → Generate token → github_pat_… 복사 (다시 볼 수 없으니 바로 붙여넣기)
  5. 이 사이트(pages.dev)에서 쓰면 upload.html 의 SITE = { owner, repo } 를 내 리포로 바꿔야 합니다 (작업기록 참고)

⑥ 버퍼 Worker 앱 키 선택

넣는 곳: Cloudflare Worker 의 Secret APP_KEY + 유튜브 자동화 → 고급 → 버퍼 연동 ② 「앱 키」 (같은 값)

  1. 앱 키는 정해진 게 아니라 내가 정하는 암호입니다. 아래 버튼으로 만들어 복사하세요.
    —
  2. Cloudflare → Workers & Pages → Create → Worker → 이름(buffer-relay) → Deploy → Edit code 에 cloudflare/buffer-worker.js 붙여넣기 → Deploy Cloudflare 열기 ↗
  3. Worker → Settings → Variables and Secrets → BUFFER_API_KEY(Secret, ④ 키) · APP_KEY(Secret, 1번 값)
  4. 페이지 고급 → 버퍼 연동 ② 에 Worker 주소(https://buffer-relay.○○.workers.dev)와 앱 키 → 「채널 확인」

⑦ 데스크톱 앱 OAuth 클라이언트 (PC 프로그램용) 선택

넣는 곳: uploader\.secrets\youtube-client.json (폴더째 자동 업로드하는 PC 프로그램만 해당 — 웹페이지만 쓰면 필요 없음)

  1. ③ 의 동의 화면·테스트 사용자는 그대로 씀. 클라이언트 → 「+ 클라이언트 만들기」 → 유형 데스크톱 앱 클라이언트 만들기 ↗
  2. 만들기 → JSON 다운로드 → 파일 이름을 youtube-client.json 으로 바꿔 uploader\.secrets\ 에 저장 (.secrets 폴더는 새로 만들기)
  3. 명령 프롬프트에서 cd uploader → npm run auth:youtube → 브라우저에서 채널 계정으로 승인 (계정이 더 있으면 npm run auth:youtube -- 이름)

키는 남에게 보여주지 마세요. 새어 나갔다면 위 링크의 같은 화면에서 키를 삭제(또는 재발급)하면 바로 무효가 됩니다.