워드프레스 테크니컬 SEO, Claude Code로 자동 해결하는 법

워드프레스 사이트를 운영하면서 SEO에 신경 쓰고 싶은데, 막상 시작하려면 낯선 용어들이 쏟아져 막막했던 경험 있으신가요? robots.txt, 사이트맵 XML, HTTPS 리다이렉션, 구조화 데이터… 이름만 들어도 개발자의 영역처럼 느껴지는 것들이죠. 그런데 이 모든 테크니컬 SEO 작업을 Claude Code에 자연어로 요청하면, AI가 서버에 직접 접속해 처음부터 끝까지 처리해 준다면 어떨까요? 실제로 그 방법을 써봤고, 생각보다 훨씬 효과적이었어요.

테크니컬 SEO와 콘텐츠 SEO, 뭐가 다를까요

SEO를 공부하다 보면 크게 두 가지로 나뉜다는 걸 알게 돼요. 테크니컬 SEO는 건물로 치면 기초 공사예요. 사이트가 검색엔진에 올바르게 인식될 수 있도록 서버 환경, 색인 설정, URL 구조, 속도 등을 다듬는 작업이죠. 콘텐츠 SEO는 그 건물 안에 좋은 콘텐츠를 채워 넣는 일이고요.

문제는 테크니컬 SEO가 진입 장벽이 꽤 높다는 점이에요. robots.txt가 뭔지, 사이트맵 XML은 어떻게 만들어야 하는지, 스테이징 URL이 색인에 잡히면 왜 안 되는지—이런 개념을 모르면 어디서부터 손을 대야 할지 알 수가 없어요. 일반적으로는 개발자에게 의뢰하거나, 오랜 시간을 들여 직접 공부해야 했죠.

Claude Code가 이걸 어떻게 처리하나요

Claude Code는 터미널에서 동작하는 AI 코딩 도구예요. 단순히 코드를 생성해 주는 것에서 그치지 않고, SSH를 통해 원격 서버에 직접 접속해서 실제 명령어를 실행할 수 있어요. 워드프레스 사이트를 Cloudways나 cafe24 같은 호스팅에 올려두셨다면, Claude Code를 그 서버와 연결해 두는 것만으로 이후 작업을 모두 자연어로 지시할 수 있게 됩니다.

실제로 이런 식으로 요청해요: “robots.txt 확인하고 SEO에 맞게 최적화해줘. wp-includes랑 wp-admin은 차단하고, 사이트맵 위치도 추가해줘.” 그러면 Claude Code가 현재 서버의 robots.txt를 먼저 확인하고, 없으면 최적화된 파일을 직접 생성해 줘요. 에러가 나도 스스로 수정하고 다시 시도하니 기다리기만 하면 됩니다.

실제로 어떤 단계로 진행되나요

1단계: SSH 접속 설정
처음에 Claude Code가 해당 서버에 SSH로 접속할 수 있도록 SSH 키 또는 비밀번호를 설정해 두어야 해요. .ssh/config에 alias를 등록해 두면 이후 ssh 사이트명 한 줄로 접속할 수 있어요. 한 번만 설정하면 이후 작업은 전부 Claude Code가 처리합니다.

2단계: 테크니컬 SEO 점검 요청
“SEO 점검해줘”라고 요청하거나, SEO 체크리스트 파일을 통째로 주고 “다 확인하고 고쳐줘”라고 해도 됩니다. Claude Code는 robots.txt, 사이트맵, HTTPS 리다이렉션, 구조화 데이터 등을 하나씩 확인하면서 문제가 있는 항목을 직접 수정해요. 여러 항목을 한 번에 처리하면 10분 안에 주요 항목이 다 해결되는 경우도 많아요.

3단계: 구글 서치 콘솔(GSC) 제출
사이트맵이 생성되면, Claude Code가 제출할 사이트맵 URL을 알려줘요. 그 URL을 복사해서 구글 서치 콘솔에 붙여넣고 제출하면 끝이에요. 구글이 사이트 구조를 파악하는 속도가 훨씬 빨라집니다.

4단계: 구조화 데이터 추가
구글 AI 개요(AI Overview)나 리치 결과에 노출되려면 FAQ, Q&A 형식의 구조화 데이터가 필요해요. 이것도 “푸터 위에 FAQ 5개 추가해줘”처럼 요청하면, Claude Code가 워드프레스 테마 파일을 수정해 JSON-LD 형태로 넣어줘요.

이 방법을 어떻게 더 활용할 수 있을까요

한 가지 사이트에만 쓰는 게 아니라, 운영하는 워드프레스 사이트가 여러 개라면 각 사이트마다 SSH alias를 등록해 두고 같은 방식으로 활용할 수 있어요. SEO 체크리스트 파일을 미리 만들어 두면 “이 파일 기준으로 다 점검해줘”라는 요청 하나로 전체 진단이 가능하죠.

구글 서치 콘솔 API를 Claude Code에 연결하면 한 단계 더 나아가요. 검색 성과 데이터를 불러와서 클릭률이 낮은 페이지를 분석하거나, 크롤 에러를 바로 수정하는 것도 가능해집니다. 테크니컬 SEO와 콘텐츠 SEO를 하나의 워크플로우로 묶을 수 있게 되는 거예요.

주의사항 및 한계

Claude Code가 강력하긴 하지만, 몇 가지 주의할 점이 있어요. 서버 접속 권한이 있는 만큼, 잘못된 명령이 실행되면 설정이 바뀌거나 파일이 수정될 수 있어요. 중요한 작업 전에는 백업을 해두는 걸 권장해요. 또, Cloudflare를 사용하는 경우 HTTPS 설정이 Cloudflare 단에서 처리되는 경우가 있어, WordPress 서버 측에서 추가로 설정하면 무한 루프가 생길 수 있어요. 이 부분은 Claude Code도 주의하라고 안내해 주지만, 직접 확인하는 게 안전해요.

호스팅 환경에 따라 PHP 경로나 WP-CLI 명령어가 다를 수 있어요. cafe24는 openresty 기반으로 .xml URL 처리 방식이 일반적인 Apache와 달라서, 정적 파일을 루트에 직접 만들어야 하는 경우도 있었어요. Claude Code가 이런 환경 차이를 어느 정도 파악하고 대응하지만, 처음 연결할 때 환경 정보를 명확히 알려주는 게 좋아요.

자주 묻는 질문

Claude Code를 WordPress에 연결하려면 개발 지식이 필요한가요?
SSH 접속 설정은 처음 한 번만 해두면 돼요. 터미널에서 SSH 키를 등록하는 수준의 작업이 필요하고, 이 과정도 Claude Code에 요청하면 단계별로 안내를 받을 수 있어요. 이후 SEO 작업은 전부 자연어로 진행할 수 있어요.

WordPress 호스팅이 cafe24인데 사용할 수 있나요?
사용할 수 있어요. 다만 cafe24는 openresty 환경 특성상 .xml 파일을 URL로 접근할 때 홈으로 리다이렉션이 되는 경우가 있어요. 이 문제는 WordPress 루트에 정적 파일을 직접 만들어 해결할 수 있으며, Claude Code가 이 방법으로 처리해 줍니다.

구글 서치 콘솔 연동도 자동화할 수 있나요?
GSC API 토큰을 서버에 저장해 두면, Claude Code가 직접 서치 콘솔 데이터를 읽어 분석하고 피드백을 줄 수 있어요. 사이트맵 제출, 크롤 에러 확인, 색인 상태 점검 등을 자동화할 수 있는 방향으로 확장이 가능해요.

robots.txt를 잘못 설정하면 어떻게 되나요?
robots.txt에서 Disallow 범위를 너무 넓게 설정하면 구글이 사이트 전체를 크롤하지 못할 수 있어요. Claude Code는 일반적으로 안전한 기본 설정을 만들어 주지만, 생성 후 구글 서치 콘솔의 robots.txt 테스터로 검증해 보는 걸 권장해요.

구조화 데이터는 어디에 추가해야 가장 효과적인가요?
홈페이지와 자주 검색될 것 같은 주요 포스트에 FAQ 또는 Q&A 형식의 구조화 데이터를 추가하는 게 효과적이에요. JSON-LD 형식으로 WordPress 테마의 footer 직전에 넣으면 되고, 리치 결과 테스트 도구로 적격 여부를 확인해 볼 수 있어요.

마무리

테크니컬 SEO는 사이트가 검색엔진에 제대로 인식될 수 있는 기반을 다지는 작업이에요. 이 기초가 탄탄해야 이후 콘텐츠 SEO의 효과도 온전히 발휘될 수 있어요. Claude Code는 이 기초 공사를 개발자 없이, 자연어만으로 처리할 수 있게 해줘요. WordPress 사이트를 운영하신다면, Claude Code와 SSH 연결 한 번만 해두세요. 그 다음부터는 말로 모든 게 해결됩니다.

이 글은 Cursor Korea 커뮤니티 운영 과정에서 직접 Claude Code를 활용한 경험을 바탕으로 작성했습니다.

작성: 전시진 | 시리얼(Sireal)