구글 서치 콘솔을 열었는데 빨간 오류가 가득합니다. “페이지를 색인할 수 없음”이라는 메시지가 수십 개씩 쌓여 있는데, 무슨 뜻인지, 뭘 고쳐야 하는지 도무지 알 수가 없어요. 개발자한테 물어보자니 이런 걸로 부탁하기 민망하고, 외주를 맡기자니 비용이 만만치 않습니다. PHP 파일을 직접 건드렸다가 사이트가 통째로 날아갈까봐 그냥 놔두고 있는 분들, 분명히 계실 거예요.
이 글은 그 답답함을 해결하는 방법을 다룹니다. Claude Code와 SSH, WP-CLI를 연결하면 개발자 없이도 워드프레스 SEO를 직접 자동화할 수 있어요. 명령어를 몰라도 괜찮습니다. 한국어로 말하면 Claude가 알아서 서버를 움직입니다.
왜 지금 이 방법이 필요한가
워드프레스로 블로그나 쇼핑몰을 운영하는 분들이 SEO에서 가장 많이 막히는 지점은 크게 세 가지입니다. 첫째, GSC(구글 서치 콘솔)에서 오류가 뜨는데 그게 무슨 말인지 이해하기 어렵습니다. 둘째, 뭘 고쳐야 하는지는 어렴풋이 알겠는데 어떻게 고치는지 모릅니다. 셋째, PHP나 서버 파일을 건드리는 게 두렵고, 그렇다고 매번 개발자에게 의뢰하기엔 비용 부담이 큽니다.
기존에는 이 간격을 메울 방법이 마땅치 않았어요. 그런데 Claude Code가 등장하면서 상황이 달라졌습니다. AI에게 한국어로 지시하면, 그 지시가 실제 서버 명령어로 번역되어 워드프레스를 직접 조작하는 게 가능해졌거든요. 개발자가 하던 일을 이제는 말 한 마디로 처리할 수 있습니다.
이 방법에서 쓰는 도구 4가지
기술 용어가 낯설더라도 비유로 이해하시면 됩니다. 복잡한 설정보다 각 도구가 어떤 역할을 하는지 먼저 파악하는 게 중요해요.
- Claude Code — 통역사: 내가 한국어로 말한 내용을 서버가 이해하는 명령어로 바꿔줍니다. “색인 안 된 포스트 찾아서 원인 알려줘”라고 하면 Claude가 알아서 처리해요.
- SSH — 출입문: 워드프레스가 올라가 있는 서버에 들어가는 열쇠입니다. 이 연결이 되어야 나머지 모든 게 작동해요.
- WP-CLI — 리모컨: 워드프레스 관리자 화면을 열지 않고도 포스트를 수정하고, 플러그인을 설치하고, 데이터베이스를 조작할 수 있는 도구입니다.
- GSC CLI — 성적표: 구글이 내 사이트를 어떻게 보고 있는지 데이터를 자동으로 가져옵니다. 어떤 포스트의 CTR이 낮은지, 어떤 페이지가 색인되지 않았는지 파악할 수 있어요.
핵심 워크플로우: 말하면 서버가 움직인다
전체 흐름은 단순합니다. 내가 Claude에게 한국어로 지시하면, Claude가 그 내용을 서버 명령어로 변환하고, SSH를 통해 서버에 접속한 뒤 WP-CLI로 워드프레스를 직접 조작합니다. 결과는 다시 나에게 읽기 쉬운 형태로 돌아와요. 중간에 내가 할 일은 없습니다.
예를 들어 이렇게 말할 수 있어요. “어제 발행한 포스트 SEO 점검하고 문제 있는 거 고쳐줘.” 그러면 Claude가 SSH로 서버에 접속하고, WP-CLI로 포스트 목록을 조회한 뒤, robots.txt와 sitemap, noindex 태그까지 한꺼번에 확인하고 문제를 수정합니다. 10분이면 충분해요.
실전에서 이렇게 씁니다: 5가지 시나리오
① 색인 안 된 포스트 찾고 원인 파악하기
GSC에서 색인 오류가 떠도 원인을 모르는 경우가 많습니다. Claude에게 “색인 안 된 포스트 있으면 찾아서 왜 그런지 알려줘”라고 하면, robots.txt 설정, sitemap 포함 여부, noindex 태그 세 가지를 동시에 점검하고 원인을 특정해줍니다. 확인이 끝나면 수정까지 자동으로 처리해요.
② CTR 낮은 포스트 제목과 메타 디스크립션 일괄 개선
노출은 되는데 클릭이 없는 포스트가 쌓여있는 경우에 유용합니다. “노출은 되는데 클릭이 없는 포스트 찾아서 제목 개선안 뽑아줘”라고 하면, GSC 데이터에서 CTR 1% 미만인 포스트를 추출하고 개선된 제목과 메타 디스크립션 목록을 만들어줍니다. 포스트가 수백 개여도 한 번에 처리돼요.
③ 이미지 alt 태그 일괄 처리
이미지 alt 태그가 비어있는 걸 알면서도 수백 개를 하나씩 고치기 어려워 그냥 둔 경험이 있으실 거예요. “alt 태그 비어있는 이미지 전부 채워줘”라고 하면 WP-CLI가 전체 미디어 라이브러리를 스캔하고 일괄 업데이트합니다. 포스트 200개 분량도 3분이면 끝납니다.
④ 내부 링크 구조 분석과 추천
내부 링크가 SEO에 중요하다는 건 알지만 어떻게 구조를 짜야 할지 막막한 분들이 많아요. “내부 링크가 없는 포스트 찾아서 어디에 링크 넣을지 추천해줘”라고 하면 전체 포스트를 분석해 연결 가능한 포스트 쌍을 목록으로 뽑아줍니다.
⑤ 주간 SEO 리포트 자동 생성
“이번 주 SEO 현황 요약해서 리포트 만들어줘”라고 하면 색인 수, 평균 순위, CTR, 개선된 항목을 자동으로 집계해 마크다운 리포트 파일로 저장합니다. 매주 수동으로 GSC를 들여다보는 수고를 없앨 수 있어요.
시작하는 방법: 딱 하나만 직접 하면 됩니다
이 설정에서 사람이 직접 해야 하는 건 SSH 연결 하나뿐입니다. 카페24 기준으로는 호스팅 관리자 → 보안관리 → SSH 접속관리에서 활성화하고 SSH 키를 등록하면 돼요. 이후 Claude Code와 연결 정보를 설정하는 것까지 끝나면 나머지는 모두 Claude에게 맡길 수 있습니다.
WP-CLI 경로 설정도, 백업 자동화 스크립트 작성도, GSC 연동 설정도 전부 Claude에게 지시하면 됩니다. “작업 전에 항상 자동으로 DB 백업하도록 설정해줘”라고 한 마디 하면 Claude가 백업 스크립트를 만들고 규칙으로 등록해요. 이후 모든 작업 전에 타임스탬프 스냅샷이 자동으로 생성됩니다.
주의사항: 서버 직접 수정이라 롤백이 없습니다
이 방법의 한 가지 주의점은 서버를 직접 수정하기 때문에 즉각적인 롤백이 없다는 점입니다. 카페24는 하루 한 번 백업을 제공하지만, 오늘 여러 작업을 했다면 작업 직전 상태로 되돌리기 어려울 수 있어요. 그래서 앞서 언급한 DB 스냅샷 자동화가 중요합니다. 작업마다 타임스탬프가 붙은 백업 파일이 생성되어 있으면, 문제가 생겼을 때 원하는 시점으로 정확하게 복구할 수 있습니다.
PHP 파일을 수정하는 경우라면 Claude가 자동으로 .bak 파일을 만들어두도록 규칙을 추가해두는 것도 좋은 방법이에요. 모르면 Claude한테 물어보면 됩니다. 설정 방법을 모른다고 해서 못 쓰는 도구가 아닙니다.
자주 묻는 질문
코딩을 전혀 몰라도 사용할 수 있나요?
네, 가능합니다. Claude Code는 한국어로 지시를 받아 서버 명령어로 변환해줍니다. 명령어를 직접 입력할 일은 거의 없어요. SSH 연결 설정만 처음 한 번 하면 이후 모든 작업은 자연어로 지시할 수 있습니다.
카페24 호스팅에서도 동작하나요?
네, 동작합니다. 단, 카페24에서 WP-CLI를 실행할 때는 PHP 경로를 직접 지정해야 합니다. 이 부분도 Claude에게 “카페24에서 WP-CLI 실행하도록 설정해줘”라고 하면 알아서 처리해줍니다.
GSC CLI 연동이 어렵지 않나요?
GSC CLI는 OAuth 토큰을 최초 한 번 발급받아야 해서 초보자에게 다소 복잡할 수 있습니다. 처음에는 GSC 웹에서 CSV로 내보낸 파일을 Claude에게 드래그해서 분석하는 방식으로 시작하는 걸 권장드립니다. 익숙해지면 단계적으로 자동화 수준을 높여가시면 돼요.
작업 중 사이트가 다운되면 어떻게 하나요?
Claude에게 “작업 전에 항상 DB 백업부터 해줘”라는 규칙을 CLAUDE.md에 추가해두면, 이후 모든 작업 전에 타임스탬프 백업이 자동 생성됩니다. 문제가 생기면 wp db import 명령으로 특정 시점으로 복구할 수 있어요.
이걸 배우는 데 얼마나 걸리나요?
SSH 연결 설정에 30분 정도 걸립니다. 이후 Claude Code 설치와 연결 정보 입력까지 포함하면 총 1시간 내외예요. 그 이후부터는 익숙해질수록 활용 범위가 자연스럽게 넓어집니다.
마무리
모르는 게 문제가 아닙니다. 모른다는 걸 Claude한테 말하지 못하는 게 문제예요. PHP가 무섭다면 Claude한테 시키면 됩니다. 백업 설정을 모른다면 Claude한테 시키면 됩니다. GSC 오류 해석이 어렵다면 Claude한테 물어보면 됩니다.
SSH 연결 하나만 직접 하세요. 그 이후는 말 한 마디로 서버가 움직입니다.
작성: 전시진 | 시리얼(Sireal)
