플랫폼별 API 연결 설정 가이드 (초보자용) Claude

플랫폼별 API 연결 설정 가이드 (초보자용)

API 연결 설정은 각 플랫폼(네이버 블로그, 티스토리 등)과 프로그램이 통신할 수 있도록 하는 중요한 단계입니다. 코드를 어디에 넣고 어떻게 시작해야 하는지 처음부터 차근차근 설명해 드리겠습니다.

## 1. 기본 환경 설정

### 1.1 Python 설치
먼저 Python을 설치해야 합니다.
1. [Python 공식 웹사이트](https://www.python.org/downloads/)에서 최신 버전 다운로드
2. 설치 시 "Add Python to PATH" 옵션 체크
3. 설치 완료 후 명령 프롬프트(cmd)나 터미널을 열고 `python --version` 입력하여 설치 확인

### 1.2 작업 폴더 생성
1. 컴퓨터에 '콘텐츠_자동화' 같은 이름의 폴더 생성
2. 이 폴더 안에 'app.py'라는 파일 생성 (메인 코드용)
3. 같은 폴더에 'config.py'라는 파일 생성 (API 키 저장용)

### 1.3 필요한 라이브러리 설치
명령 프롬프트(cmd)나 터미널을 열고 다음 명령어 입력:
```
pip install requests anthropic google-api-python-client apscheduler
```

## 2. API 키 획득 방법

### 2.1 네이버 블로그 API
1. [네이버 개발자 센터](https://developers.naver.com) 가입
2. "애플리케이션 등록" 클릭
3. 애플리케이션 이름 입력 (예: "내 콘텐츠 자동화")
4. "사용 API" 선택에서 "블로그" 선택
5. 등록 완료 후 발급받은 "Client ID"와 "Client Secret" 저장

### 2.2 티스토리 API
1. [티스토리 개발자 페이지](https://www.tistory.com/guide/api/manage/register) 접속
2. "API 인증키 발급"에서 앱 이름과 설명 입력
3. 콜백 URL 입력 (로컬 테스트용: http://localhost:8080)
4. 발급받은 "API Key"와 "Secret Key" 저장

### 2.3 인스타그램/스레드(Meta) API
1. [Meta for Developers](https://developers.facebook.com/) 가입
2. "My Apps" → "Create App" 선택
3. 앱 유형으로 "Business" 선택
4. 앱 이름 입력 후 생성
5. "Instagram Graph API" 추가 및 설정
6. 발급받은 "App ID"와 "App Secret" 저장

### 2.4 유튜브 API
1. [Google Cloud Console](https://console.cloud.google.com/) 가입
2. 새 프로젝트 생성
3. "API 및 서비스" → "라이브러리" 메뉴
4. "YouTube Data API v3" 검색하여 활성화
5. "사용자 인증 정보" → "사용자 인증 정보 만들기" → "API 키"
6. 생성된 API 키 저장

## 3. API 키 설정 파일 작성

'config.py' 파일을 열고 다음 코드 입력:

```python
# API 키 설정 파일

# 네이버 블로그 API 키
NAVER_CLIENT_ID = "여기에_네이버_클라이언트_ID_입력"
NAVER_CLIENT_SECRET = "여기에_네이버_클라이언트_시크릿_입력"

# 티스토리 API 키
TISTORY_API_KEY = "여기에_티스토리_API_키_입력"
TISTORY_SECRET = "여기에_티스토리_시크릿_키_입력"

# 인스타그램/스레드 API 키
INSTAGRAM_APP_ID = "여기에_메타_앱_ID_입력"
INSTAGRAM_APP_SECRET = "여기에_메타_앱_시크릿_입력"
INSTAGRAM_ACCESS_TOKEN = "여기에_메타_액세스_토큰_입력"

# 유튜브 API 키
YOUTUBE_API_KEY = "여기에_유튜브_API_키_입력"

# Claude API 키
ANTHROPIC_API_KEY = "여기에_앤트로픽_API_키_입력"
```

## 4. API 연결 설정 코드 작성

'app.py' 파일을 열고 다음 코드를 입력합니다:

```python
# 필요한 라이브러리 가져오기
import requests
import json
import os
import sqlite3
from datetime import datetime
from googleapiclient.discovery import build
import anthropic

# 설정 파일에서 API 키 가져오기
from config import *

# 데이터베이스 폴더 생성
if not os.path.exists('data'):
    os.makedirs('data')

# 콘텐츠 저장 폴더 생성
if not os.path.exists('content'):
    os.makedirs('content')

# 네이버 블로그 API 연결 함수
def connect_naver_blog():
    """네이버 블로그 API 연결에 필요한 헤더를 반환합니다."""
    headers = {
        "X-Naver-Client-Id": NAVER_CLIENT_ID,
        "X-Naver-Client-Secret": NAVER_CLIENT_SECRET
    }
    print("네이버 블로그 API 연결 준비 완료")
    return headers

# 티스토리 API 연결 함수
def connect_tistory():
    """티스토리 API 연결에 필요한 헤더를 반환합니다."""
    headers = {"Authorization": f"Bearer {TISTORY_API_KEY}"}
    print("티스토리 API 연결 준비 완료")
    return headers

# 인스타그램/스레드 API 연결 함수
def connect_instagram():
    """인스타그램 API 연결에 필요한 토큰을 반환합니다."""
    # 실제 구현에서는 액세스 토큰 갱신 로직이 필요할 수 있습니다
    access_token = INSTAGRAM_ACCESS_TOKEN
    print("인스타그램 API 연결 준비 완료")
    return {"access_token": access_token}

# 유튜브 API 연결 함수
def connect_youtube():
    """유튜브 API 서비스 객체를 반환합니다."""
    try:
        youtube = build('youtube', 'v3', developerKey=YOUTUBE_API_KEY)
        print("유튜브 API 연결 준비 완료")
        return youtube
    except Exception as e:
        print(f"유튜브 API 연결 오류: {e}")
        return None

# Claude API 연결 함수
def connect_claude():
    """Claude API 클라이언트를 반환합니다."""
    try:
        client = anthropic.Anthropic(api_key=ANTHROPIC_API_KEY)
        print("Claude API 연결 준비 완료")
        return client
    except Exception as e:
        print(f"Claude API 연결 오류: {e}")
        return None

# 모든 API 연결 테스트
def test_all_connections():
    """모든 API 연결을 테스트합니다."""
    print("\n=== API 연결 테스트 시작 ===")
    
    # 네이버 블로그
    try:
        naver_headers = connect_naver_blog()
        print("✓ 네이버 블로그 API 설정 완료")
    except Exception as e:
        print(f"✗ 네이버 블로그 API 설정 오류: {e}")
    
    # 티스토리
    try:
        tistory_headers = connect_tistory()
        print("✓ 티스토리 API 설정 완료")
    except Exception as e:
        print(f"✗ 티스토리 API 설정 오류: {e}")
    
    # 인스타그램
    try:
        instagram_tokens = connect_instagram()
        print("✓ 인스타그램 API 설정 완료")
    except Exception as e:
        print(f"✗ 인스타그램 API 설정 오류: {e}")
    
    # 유튜브
    try:
        youtube = connect_youtube()
        if youtube:
            print("✓ 유튜브 API 설정 완료")
        else:
            print("✗ 유튜브 API 설정 실패")
    except Exception as e:
        print(f"✗ 유튜브 API 설정 오류: {e}")
    
    # Claude
    try:
        claude = connect_claude()
        if claude:
            print("✓ Claude API 설정 완료")
        else:
            print("✗ Claude API 설정 실패")
    except Exception as e:
        print(f"✗ Claude API 설정 오류: {e}")
    
    print("=== API 연결 테스트 완료 ===\n")

# 메인 함수
if __name__ == "__main__":
    print("콘텐츠 발행 자동화 시스템 시작")
    test_all_connections()
```

## 5. 코드 실행 방법

1. 명령 프롬프트(cmd)나 터미널을 엽니다
2. 작업 폴더로 이동합니다 (예: `cd C:\사용자\이름\콘텐츠_자동화`)
3. 다음 명령어로 코드를 실행합니다: `python app.py`
4. 각 API 연결 테스트 결과가 화면에 표시됩니다

## 6. 문제 해결 가이드

### API 키 오류
- 각 API 키가 올바르게 입력되었는지 확인
- 인증 정보가 만료되지 않았는지 확인
- 개발자 포털에서 해당 API의 활성화 상태 확인

### 라이브러리 설치 오류
- `pip install --upgrade 라이브러리이름` 명령으로 최신 버전 설치 시도
- Python 버전 호환성 확인 (Python 3.7 이상 권장)

### 권한 오류
- 각 API에 필요한 권한(scope)이 올바르게 설정되었는지 확인
- 네이버/티스토리의 경우 블로그 접근 및 쓰기 권한 필요
- 인스타그램의 경우 콘텐츠 게시 권한 필요

## 7. 다음 단계

API 연결 설정이 완료되면, 다음 단계로:

1. 데이터베이스 구축 (앞서 제공한 `create_content_database` 함수 구현)
2. 콘텐츠 생성 및 최적화 기능 구현
3. 발행 일정 관리 시스템 구축

이렇게 하면 기본적인 API 연결 설정이 완료됩니다. 이 코드는 실제 시스템의 기초가 되며, 여기에 기능들을 하나씩 추가해나가면 됩니다.

기능들에 대한 것은
—> 콘텐츠 발행 자동화 시스템 구축 가이드