GSC 커버리지 404 수집과 Blogger API v3의 한계
최근 티스토리 블로거 이관 작업을 진행한 뒤 구글 서치 콘솔을 확인해보니 아찔한 상황이 펼쳐져 있었다. 인덱싱 리포트에 GSC 커버리지 404 오류로 수집된 구URL 63개가 방치되어 있었기 때문이다. 기존 블로그의 SEO 점수를 유지하려면 빠르게 301 이동 처리를 해줘야 했다.
우선 서치 콘솔에서 엑셀 파일로 404 URL 목록을 추출한 뒤 새 주소와 연결하는 매핑표부터 작성했다. 당연히 구글에서 제공하는 Blogger API v3를 활용해 일괄 처리하려 했으나 API 문서를 아무리 뒤져봐도 리디렉션 등록 엔드포인트가 존재하지 않았다. 결국 Blogger 맞춤 리디렉션 설정은 관리자 UI를 통해서만 가능한 구조였다.
좌표 클릭 자동화 실패와 JS 컨텍스트 주입 전환
처음에는 마우스 좌표를 지정해 1건씩 자동으로 클릭하고 입력하는 매크로 방식을 시도했다. 하지만 화면이 리로드될 때마다 다이얼로그의 참조(refs)가 무효화되었고, 처리 속도마저 지나치게 느려 실용성이 없었다.
고민 끝에 완전히 새로운 접근법을 선택했다. 별도의 외부 프로그램을 쓰지 않고, 이미 관리자로 로그인되어 있는 브라우저 탭의 JS 컨텍스트 내부에서 DOM을 순회하며 직접 폼을 채우는 스크립트를 작성하기로 한 것이다.
안전장치를 갖춘 async 루프와 슬러그 피드 매핑
반복 폼 조작 과정은 '추가' 버튼 클릭, '값 입력', '확인' 클릭 단계를 거치도록 설계했다. 비동기 처리 과정에서 생길 수 있는 꼬임을 막기 위해 전체 로직을 async 루프로 감싸고, 실행 전후의 항목 수인 beforeCount와 afterCount를 비교하는 안전장치까지 촘촘히 넣었다.
정확한 새 URL 매핑 데이터를 얻기 위해 외부에서 직접 fetch를 날려봤으나 페이로드가 커서 실패했다. 이를 해결하기 위해 동일한 관리자 탭 내부에서 Blogger 공개 포스트 피드를 fetch한 뒤 슬러그 값으로 필터링하는 방식을 적용했다. 그 결과 사람의 개입 없이 단 몇 분 만에 63건의 블로거 301 리다이렉트 자동화 작업을 안전하게 마칠 수 있었다.
API가 없어도 브라우저 탭 자체가 훌륭한 대체 수단
이번 작업을 통해 API가 공식적으로 제공되지 않는 서비스라 할지라도, 이미 인증이 완료된 브라우저 탭 자체가 훌륭한 API 대체 수단이 될 수 있다는 중요한 인사이트를 얻었다. 개발자 도구의 콘솔을 잘 활용하면 수동 작업의 늪에서 얼마든지 벗어날 수 있다.
티스토리 블로거 이관 후 남아있던 유실 URL 문제도 깔끔하게 해결되어 검색 엔진 노출 손실을 최대로 방지할 수 있게 되었다. 나와 유사한 구URL 전환 이슈로 밤새 수동 입력 작업을 고민하고 있다면 브라우저 탭 내 JS 주입 방식을 꼭 검토해보길 바란다.