최근 개인 프로젝트인 KidStory의 블로그 글을 Pinterest에 자동으로 연동하는 자동게시 환경을 구축했다. 그런데 테스트 과정에서 예상치 못한 심각한 문제가 발생했다. 분명 발행한 블로그 글은 하나이고, 글 안에 들어있는 대표 이미지도 단 한 장뿐인데, 핀터레스트에는 동일한 핀이 꼬박꼬박 2개씩 생성되는 현상이었다.
대표 이미지 개수를 하나로 완전히 제한해 보고 본문 레이아웃을 수정해 보아도 중복 생성 문제는 전혀 해결되지 않았다. 똑같은 핀이 두 번씩 게시되는 것은 스팸처럼 보여 사용자 경험에 치명적이었다. 문제를 뿌리부터 파악하기 위해 직접 원인 분석에 나서기로 했다.
범인은 어디에? Blogger 피드 분석과 뜻밖의 발견
가장 먼저 의심한 것은 블로그 피드 데이터였다. 내 블로그 플랫폼인 Blogger가 발행하는 실제 RSS 피드를 뜯어보기로 했다. 주소 뒤에 alt=json 파라미터를 붙여 원본 피드 데이터를 상세히 분석하기 시작했다.
그 결과 놀라운 사실을 발견했다. 본문 내부의 img 태그와는 별도로, Blogger 시스템이 자동으로 media:thumbnail 필드를 피드에 추가해 발행하고 있었던 것이다. 이 두 필드에 담긴 이미지 주소는 시각적으로 완전히 동일한 사진을 가리키고 있었지만, 실제 텍스트로 된 URL 경로 자체는 미세하게 서로 달랐다.
Pinterest RSS 이미지 중복 처리 로직은 이 지점에서 오작동하고 있었다. 핀터레스트 연동 엔진은 이미지 파일의 시각적 동일성이 아니라 텍스트 URL 주소를 기준으로 데이터를 고유 식별한다. 즉, 같은 사진이라도 URL이 다르면 서로 다른 이미지로 인식해 각각 별개의 핀을 두 개 생성해 버린 것이었다.
양쪽 플랫폼의 한계, 설정으로는 답이 없었다
원인을 알았으니 설정에서 수정하면 해결될 일이라고 쉽게 생각했다. 먼저 핀터레스트 설정을 뒤졌다. 하지만 Pinterest의 핀 일괄 만들기 설정 화면이나 RSS 연동 메뉴 어디에도 이미지를 파싱할 때 특정 소스 필드만 고르게 하거나 중복을 거르는 옵션은 존재하지 않았다.
그렇다면 보내는 쪽인 Blogger 설정을 변경할 차례였다. 하지만 Blogger 관리자 화면을 아무리 뒤져도 자동으로 생성되어 피드에 추가되는 media:thumbnail 필드를 비활성화하거나 수동으로 제어하는 기능은 눈을 씻고 찾아봐도 없었다. 양쪽 플랫폼 모두 내부 설정을 통해서는 이 문제를 해결할 수 없는 진퇴양난의 상황이었다.
Apps Script 웹앱으로 나만의 RSS 프록시 만들기
결국 원본 RSS 피드가 핀터레스트로 전달되기 전에 중간에서 데이터를 가공하는 방법밖에 없다고 판단했다. 이를 해결하기 위해 원본 Blogger RSS를 그대로 가져와서 문제가 되는 media:thumbnail 태그만 깔끔하게 제거한 뒤 새롭게 피드를 재발행하는 방식을 고안했다.
가장 가볍고 비용이 들지 않는 도구로 Google Apps Script를 선택했다. 도구 내에서 Pinterest_RSS중복제거.gs 파일을 생성하고, XML 파싱 코드를 작성했다. 들어오는 원본 피드 데이터를 파싱하여 문제의 썸네일 태그들을 정규표현식과 XML 조작 기법으로 깨끗이 삭제한 뒤, 다시 유효한 XML 형태로 응답을 돌려주는 얇은 중개기를 만들었다.
이 스크립트를 Apps Script 웹앱 형태로 배포하여 고유한 엔드포인트 URL을 확보했다. 배포 과정은 진경이 직접 수행해 주었고, 최종적으로 확보한 이 프록시 주소를 Pinterest RSS 등록 메뉴에 기존 주소 대신 입력했다. 결과는 대성공이었다. 프록시를 거쳐 나간 피드 덕분에 이제는 글이 발행될 때마다 정확하게 1개의 핀만 정상적으로 생성되는 것을 확인했다.
느낀 점: 같은 사진도 URL이 다르면 타인이다
이번 삽질을 통해 API와 피드 설계 영역에서 아주 흔히 마주할 수 있는 함정을 깊이 경험했다. 개발자 눈에는 아무리 같은 이미지로 보여도 시스템 인터페이스 관점에서는 URL 문자열이 단 한 글자라도 다르면 완전히 다른 별개의 리소스로 간주된다는 단순한 진리를 다시금 뼈저리게 느꼈다.
동시에 연동하는 플랫폼 양측이 모두 폐쇄적이거나 고유의 설정을 변경하기 힘든 상황이라도, 낙담할 필요가 없다는 사실도 배웠다. 데이터가 오가는 통로 중간에 Apps Script 웹앱 같은 얇고 가벼운 RSS 프록시 레이어 하나만 살짝 끼워 넣는 것만으로도 서비스 인프라 변경 없이 아주 깔끔하고 우아하게 문제를 해결할 수 있었다.