Upload Post

Overview

이 스킬은 Upload Post API를 사용하여 비디오를 여러 플랫폼에 효율적으로 업로드할 수 있게 도와줍니다. 특히 플랫폼별로 서로 다른 첫 번째 댓글을 남기는 기능을 지원합니다.

Workflow

비디오 업로드 요청을 받으면 다음 단계를 따르세요:

1. 정보 수집

사용자로부터 다음 정보를 확인하세요. 누락된 정보가 있다면 정중히 요청하세요.

• API Key: Upload Post 서비스의 API 키 (보안을 위해 환경 변수 사용 권장)
• Profile ID/Name: 업로드에 사용할 프로필 식별자 (user)
• Video: 업로드할 비디오의 로컬 경로 또는 공개 URL
• Platforms: 업로드할 플랫폼 목록 (예: instagram, youtube, facebook 등)
• Title: 비디오 제목
• First Comments: 각 플랫폼마다 남길 첫 번째 댓글 내용 (선택 사항)

2. 업로드 실행

수집된 정보를 바탕으로 스크립트를 실행합니다. (Python 또는 Shell 중 선택 가능)

방법 A: Shell 스크립트 사용 (권장)

# 공통 댓글만 있는 경우
bash scripts/upload_video.sh \
  --api-key "YOUR_API_KEY" \
  --user-id "profile" \
  --video "video.mp4" \
  --platforms "instagram,youtube" \
  --title "Title" \
  --first-comment "Hello world!"

# 플랫폼별 개별 댓글이 있는 경우
bash scripts/upload_video.sh \
  --api-key "YOUR_API_KEY" \
  --user-id "profile" \
  --video "video.mp4" \
  --platforms "instagram,youtube" \
  --title "Title" \
  --platform-comments '{"instagram": "Link in bio!", "youtube": "Subscribe!"}'

방법 B: Python 스크립트 사용 (상세 에러 핸들링 필요 시)

python3 scripts/upload_video.py \
  --api-key "YOUR_API_KEY" \
  --user-id "profile_name" \
  --video "/path/to/video.mp4" \
  --platforms "instagram,youtube" \
  --title "My Awesome Video" \
  --first-comments '{"instagram": "Link in bio!", "youtube": "Subscribe!"}'

3. 결과 확인 및 안내

업로드 결과(성공 메시지 또는 request_id)를 사용자에게 안내합니다. 비동기 업로드의 경우 request_id를 통해 나중에 상태를 확인할 수 있음을 알립니다.

Guidelines

• 플랫폼 목록: references/api_spec.md를 참고하여 지원되는 플랫폼인지 확인하세요.
• 보안: API 키가 노출되지 않도록 주의하고, 가급적 사용자에게 환경 변수 설정을 안내하세요.
• 첫 댓글: 플랫폼별로 댓글이 다를 경우 JSON 형식으로 구성하여 스크립트에 전달합니다.

Resources

scripts/

• upload_video.sh: curl을 사용하여 API를 직접 호출하는 쉘 스크립트입니다. (설치 불필요)
• upload_video.py: 보다 정교한 요청 처리가 가능한 파이썬 스크립트입니다.

references/

• api_spec.md: API 엔드포인트, 파라미터, 지원 플랫폼 등의 상세 명세서입니다.