워드프레스 이전 4편: 데이터 이전 자동 프로그램

워드프레스 이전에서 가장 큰 장벽은 역시 기존 데이터를 어떻게 옮기느냐 하는 문제입니다. 특히 티스토리 같은 플랫폼에서 워드프레스로 둥지를 옮길 때, 단순히 글만 복사하는 것이 아니라 이미지와 서식을 깨끗하게 유지하는 것이 관건이죠.

오늘은 워드프레스 이전 시리즈 4편으로, 수작업의 번거로움을 줄이고 효율을 높여주는 데이터 이전 자동화 프로그램 활용법에 대해 자세히 알아보겠습니다.

1. 기존 블로그 데이터 백업 방식 선택하기

블로그 데이터를 옮기기 전 가장 먼저 해야 할 일은 블로그 원본 데이터를 확보하는 것입니다. 방법은 크게 두 가지로 나뉩니다.

1-1 블로그플랫폼 제공 백업 기능 활용 (티스토리 등)

대부분의 블로그 플랫폼은 자체적인 데이터 백업 기능을 제공합니다.

• 장점: 클릭 몇 번으로 누구나 쉽게 전체 데이터를 내려받을 수 있어 진입 장벽이 매우 낮습니다.
• 단점: 플랫폼 특유의 불필요한 태그(Div, Span 등)와 인라인 스타일 코드가 그대로 포함됩니다. 이 데이터들을 그대로 워드프레스나 이전할 플랫폼에 밀어 넣으면 테마와 충돌하거나 본문 디자인이 깨지는 현상이 발생하며, 이미지 경로가 꼬이는 경우도 빈번합니다.

1-2 블로그 데이터 이전 자동 추출 프로그램(크롤링) 활용

내 블로그의 주소를 이용해 직접 데이터를 긁어오는 방식입니다.

• 장점: 내가 원하는 코드 양식(예: 마크다운 또는 깨끗한 HTML)을 지정해서 추출할 수 있습니다. 특히 이미지를 자동으로 다운로드하고 워드프레스 경로에 맞게 매칭해주는 기능을 활용하면 사후 수정 작업이 획기적으로 줄어듭니다. 불필요한 광고 코드나 플랫폼 전용 스크립트를 제거한 ‘순수 본문’만 추출하기에 최적입니다.

2. 백업 데이터 적용하기: 자동화 데이터 이전 방식

기존 블로그에서 추출한 데이터를 이전할 워드프레스에 수동으로 복사 붙여넣기 하는 것은 수백 개의 글을 가진 운영자에게 불가능에 가깝습니다. 이때 자동화 프로그램을 통해 데이터를 일괄 적용해야 합니다.

2-1. 워드프레스 자동화 적용 프로세스

워드프레스에서 데이터를 자동화하여 적용하는 방법은 주로 REST API 또는 WP-CLI를 활용하는 방식이 선호됩니다.

1. 데이터 구조화: 추출한 데이터를 워드프레스가 이해할 수 있는 JSON 또는 CSV 형식으로 정리합니다.
2. 이미지 서버 업로드: 백업된 이미지 파일들을 워드프레스의 wp-content/uploads 경로로 먼저 전송하거나, API를 통해 미디어 라이브러리에 등록합니다.
3. 포스트 일괄 생성: 자동화 스크립트를 실행하여 제목, 본문, 카테고리, 태그를 매칭합니다. 이때 본문 내의 이미지 경로가 내 워드프레스 도메인인 openipc.kr의 경로와 일치하도록 치환하는 과정이 포함됩니다.
4. 고유주소(Permalink) 설정: 이전 글의 주소 체계를 그대로 유지해야 SEO(검색 엔진 최적화) 손실을 방지할 수 있습니다. 자동화 프로그램 설정 시 중복된 슬러그에 숫자가 임의로 붙지 않도록 정교하게 세팅하는 것이 중요합니다.

2-2. 워드프레스 REST API (원격 자동화 방식)

REST API는 HTTP 요청을 통해 워드프레스와 통신하는 방식입니다. 주로 내 컴퓨터나 외부 서버(Python, Node.js 등)에서 실행되는 프로그램이 워드프레스에 접속하여 글을 쓰거나 수정할 때 사용합니다.

작동 원리

데이터를 JSON 형식으로 주고받습니다. 예를 들어, 티스토리에서 크롤링한 데이터를 파이썬 스크립트가 읽어 들인 후, REST API를 통해 워드프레스 서버로 전송하여 글을 생성합니다.

주요 장점

• 언어의 독립성: Python, JavaScript, PHP 등 어떤 언어로든 자동화 프로그램을 짤 수 있습니다.
• 원격 제어: 워드프레스가 설치된 서버에 직접 접속(SSH)할 필요 없이 도메인 주소만으로 데이터 제어가 가능합니다.
• 이미지 처리: API를 통해 미디어 라이브러리에 이미지를 먼저 올리고, 그 결과로 받은 ID를 본문에 연결하기 쉽습니다.

활용 예시 (Python 코드 구조)

import requests

url = "https://openipc.kr/wp-json/wp/v2/posts"
auth = ("사용자ID", "애플리케이션_비밀번호")

data = {
    "title": "자동화로 올리는 첫 번째 글",
    "content": "이 내용은 파이썬 스크립트를 통해 작성되었습니다.",
    "status": "publish"
}

response = requests.post(url, json=data, auth=auth)
print(response.status_code)

2-3. WP-CLI (서버 내부 제어 방식)

WP-CLI는 워드프레스 전용 명령줄 인터페이스(Command Line Interface)입니다. 서버 터미널(SSH)에 직접 접속하여 명령어를 입력하는 방식으로, 마우스 클릭 없이 워드프레스의 모든 설정을 제어할 수 있습니다.

작동 원리

서버 터미널에서 wp로 시작하는 명령어를 입력합니다. 예를 들어 wp post create 명령어를 실행하면 즉시 글이 생성됩니다.

주요 장점

• 압도적인 속도: HTTP 통신 과정을 거치지 않고 서버 내부에서 직접 데이터베이스(DB)를 건드리기 때문에 대량의 데이터를 처리할 때 REST API보다 훨씬 빠릅니다.
• 강력한 기능: 플러그인 설치, 테마 업데이트, DB 검색 및 치환(search-replace) 등 워드프레스 관리 전반에 걸친 작업이 가능합니다.
• 안정성: 수천 개의 글을 한 번에 가져올 때 타임아웃 오류가 발생할 확률이 적습니다.

활용 예시 (터미널 명령어)

# 새로운 포스트 생성
wp post create --post_title="WP-CLI 이전 테스트" --post_content="본문 내용입니다." --post_status=publish

# 기존 데이터베이스 내의 특정 도메인 일괄 변경 (이전 후 필수 작업)
wp search-replace "old-site.com" "openipc.kr"

3. 워드프레스 REST API 사용하기

가장 권장되는 방식인 애플리케이션 비밀번호(Application Passwords) 설정법을 단계별로 설명해 드립니다.

3-1. 애플리케이션 비밀번호 생성 (기본 방식)

워드프레스 5.6 버전부터 별도의 플러그인 없이 코어 기능으로 포함된 방식입니다. 사용자의 주 비밀번호를 노출하지 않고 API 전용 비밀번호를 발급받을 수 있습니다.

1. 워드프레스 관리자 알림판에 접속합니다.
2. 왼쪽 메뉴에서 사용자 프로필로 이동합니다.
3. 페이지 하단으로 스크롤 하여 애플리케이션 비밀번호 섹션을 찾습니다.
4. 새 애플리케이션 비밀번호 이름 칸에 식별용 이름(예: Data_Migration_Bot 또는 Python_Automation)을 입력합니다.
5. 새 애플리케이션 비밀번호 추가 버튼을 클릭합니다.
6. 화면에 생성된 24자리의 임시 비밀번호를 안전한 곳에 복사해 둡니다. (창을 닫으면 다시 볼 수 없습니다.)

3-2. API 연결 테스트 (Postman 또는 Curl)

비밀번호가 생성되었다면 실제로 작동하는지 확인해야 합니다. 가장 간단한 방법은 터미널에서 curl 명령어를 사용하는 것입니다.

curl -X GET https://openipc.kr/wp-json/wp/v2/posts \
 -u "사용자ID:발급받은_비밀번호_24자리"

위 명령어를 실행했을 때 내 블로그의 글 목록이 JSON 형태로 출력된다면 설정이 완료된 것입니다.

3-3. 발생 가능한 문제 해결 (Troubleshooting)

API 설정을 마쳤음에도 연결이 되지 않는다면 다음 두 가지를 체크해 보세요.

고유주소(Permalink) 설정 확인

워드프레스 API는 고유주소가 ‘기본(Plain)’으로 설정되어 있으면 작동하지 않는 경우가 많습니다.

• 설정 고유주소 메뉴에서 ‘글 이름’ 또는 ‘숫자’ 등 다른 형식으로 변경하고 저장하세요.

수동 이전은 시간이 오래 걸릴 뿐만 아니라 사람이 실수를 할 확률이 높습니다. 자동화 프로그램을 활용하면 수천 개의 포스팅도 단 몇 분 만에 일관된 퀄리티로 이전할 수 있습니다. 특히 깔끔한 코드로 정리된 데이터는 향후 워드프레스의 로딩 속도를 높이고 구글 검색 노출에도 긍정적인 영향을 미칩니다.

정리되지 않은 코드로 가득 찬 백업 파일 때문에 머리 아파하지 마세요. 스마트한 추출과 자동화 도구를 적절히 섞어 사용한다면, 여러분의 소중한 기록들을 더 멋진 새 집으로 완벽하게 옮길 수 있습니다.