X (Twitter) API 연동 가이드

X API v2 설정 · 약 20분 소요

X API는 유료입니다. 트윗 작성(POST)을 하려면 최소 Basic Plan ($200/월)이 필요합니다. Free 플랜은 읽기만 가능합니다.

플랜	비용	트윗 작성	월 한도
Free	무료	불가	읽기만
Basic	$200/월	가능	3,000 트윗
Pro	$5,000/월	가능	300,000 트윗

developer.x.com에 접속하여 X 계정으로 로그인합니다.

1. 개발자 이용 약관에 동의합니다.

2. 사용 목적을 간단히 설명합니다 (예: "Automated content publishing for my business")

3. 이메일/전화번호 인증을 완료합니다.

1. Developer Portal 대시보드에서 "+ Add Project" 클릭

2. 프로젝트 이름 입력 (예: "AutoPost 자동화")

3. Use Case 선택: "Making a bot"

4. 프로젝트 내에서 "+ Add App"으로 앱 생성

5. 앱 이름 입력 후 생성 완료

앱 생성 직후 표시되는 키들을 반드시 안전한 곳에 저장합니다.

앱 설정 → "Keys and Tokens" 탭:

⚠️ 키를 분실한 경우 "Regenerate"로 재발급 가능하지만, 기존 키는 즉시 무효화됩니다.

앱 설정 → "User authentication settings" → "Set up":

1. App permissions: "Read and write" 선택

2. Type of App: "Web App, Automated App or Bot" 선택

3. Callback URL: http://localhost:3000/callback (또는 서버 URL)

4. Website URL: 본인 웹사이트 또는 앱 URL

5. "Save" 클릭

"Keys and Tokens" 탭에서 Access Token and Secret을 생성합니다.

1. "Generate" 버튼 클릭

2. 아래 4가지 값을 모두 복사하여 저장:

AutoPost 웹앱 로그인 후 설정 페이지 → X (Twitter) 섹션:

1. API Key, API Secret, Access Token, Access Token Secret 입력

2. "저장" 클릭

3. "연동 테스트"로 정상 동작 확인

✅ 연동 완료! 트윗과 X 스레드를 자동으로 생성하고 발행할 수 있습니다.