매일 블로그 포스팅하면서 이미지 찾는 게 제일 번거롭더라고요. 무료 이미지 사이트 뒤져서 다운받고, 리사이즈하고, 업로드하고… 이 과정을 자동화할 수 없을까 생각하다가 Unsplash API 연결을 시도해봤어요.
오늘의 목표
워드프레스와 Unsplash API 연결해서 키워드만 입력하면 관련 이미지가 자동으로 업로드되는 시스템 만들기
준비물
Step 1: Unsplash API 연결을 위한 계정 설정

먼저 Unsplash 개발자 페이지에서 계정을 만들었어요. ‘New Application’ 버튼 눌러서 앱 이름이랑 설명 적고 승인받으면 끝이더라고요.

생각보다 간단했는데, API 키 발급까지 5분도 안 걸렸어요. 무료 플랜으로도 시간당 50개 이미지까지 가져올 수 있어서 개인 블로그용으론 충분했죠.
Step 2: Python으로 이미지 검색 스크립트 작성
Claude한테 “Unsplash API 연결해서 키워드로 이미지 검색하는 파이썬 코드 써줘”라고 부탁했어요. 그랬더니 requests 라이브러리 쓰는 코드를 뚝딱 만들어주더라고요.
import requests
import random
def search_unsplash_image(keyword, api_key):
url = f"https://api.unsplash.com/search/photos"
params = {
'query': keyword,
'per_page': 10,
'client_id': api_key
}
response = requests.get(url, params=params)
data = response.json()
if data['results']:
return random.choice(data['results'])
return None
이 코드로 키워드 넣으면 관련 이미지를 랜덤으로 하나씩 가져올 수 있게 됐어요.
Step 3: 워드프레스 자동 업로드 기능 추가
이미지를 가져오는 건 됐는데, 수동으로 업로드하면 의미가 없잖아요? 그래서 워드프레스 REST API를 활용해서 바로 미디어 라이브러리에 올리는 기능도 붙였어요.
이 부분에서 좀 헤맸는데, 인증 토큰 설정하는 게 까다롭더라고요. 결국 애플리케이션 패스워드 방식으로 해결했어요.
Step 4: 한글 키워드 영문 변환
Unsplash는 영문 검색이 훨씬 결과가 좋아서, 한글 주제를 영문으로 자동 변환하는 기능도 넣었어요. 구글 번역 API 쓸까 했는데, Claude가 간단한 딕셔너리 방식을 제안해서 그걸로 했죠.
💡 실전 팁
‘AI’ → ‘artificial intelligence’
‘여행’ → ‘travel photography’
‘음식’ → ‘food cooking’
이런 식으로 검색 결과가 더 좋은 키워드로 매핑해두면 이미지 퀄리티가 훨씬 좋아져요.
결과
- ✅ Unsplash API 연결 완료
- ✅ 키워드 입력만으로 관련 이미지 자동 검색
- ✅ 워드프레스 미디어 라이브러리 자동 업로드
- ✅ 썸네일 자동 설정까지 완료
- ✅ 한글-영문 키워드 자동 변환
마무리
생각보다 Unsplash API 연결이 어렵지 않았어요. Claude 도움 받으면서 하니까 비개발자인 저도 반나절 만에 뚝딱 만들었거든요.
이제 글 쓸 때마다 이미지 고민할 필요가 없어져서 정말 만족스러워요. 키워드만 넣으면 깔끔한 이미지가 알아서 올라가니까 블로그 작업 시간이 30% 정도 단축된 것 같아요.
다음엔 이미지에 자동으로 워터마크 넣는 기능도 추가해볼 생각이에요. 아직 완벽하진 않지만, 일단 써보면서 개선해나가려고요.
썸네일 사진: Nangialai Stoman on Unsplash