워드프레스 REST API가 뭐예요? Claude Code 연동 전 필수 개념

작성자:

Claude Code로 워드프레스 글 목록을 가져오는 건 생각보다 훨씬 쉬워요. 이번 글에서는 “내 워드프레스 글이 몇 개야?”, “최근에 올린 글 제목이 뭐였지?” 같은 걸 Claude Code로 바로 확인하는 방법을 알려드릴게요.

이걸 왜 쓰냐고요?

워드프레스 관리자 화면에서 확인하면 되지 않냐고요? 맞아요. 근데 이렇게 생각해보세요.

“발행된 글이 50개인데, 제목에 ‘자동화’가 들어간 글만 뽑고 싶다.”

관리자 화면에서는 일일이 검색해야 하지만, Claude Code로는 한 번에 쏙 뽑아낼 수 있어요. 나중에 글 일괄 수정, SEO 자동화, 예약 발행 자동화 같은 걸 하려면 이 기초가 꼭 필요합니다.

핵심 개념 딱 하나만

워드프레스에는 REST API라는 통로가 있어요.

쉽게 말하면 이렇습니다.

🏠 워드프레스 = 집
🚪 REST API = 현관문
🔑 엔드포인트 = 열쇠

Claude Code가 “글 목록 보여줘”라고 요청하면, 현관문을 통해 정보가 나옵니다. 이 현관문 주소가 바로 이거예요.

https://내사이트주소/wp-json/wp/v2/posts

kimsangjin.shop이면요?

https://kimsangjin.shop/wp-json/wp/v2/posts

브라우저에 직접 입력해도 데이터가 쭉 나와요. 직접 해보셨죠? 그게 맞는 거예요 😊

Claude Code가 실제로 하는 일

여기서 한 가지 짚고 넘어갈게요. 내가 “글 목록 가져와줘”라고 말하면 Claude Code가 어떻게 동작할까요?

단순히 보여주는 게 아니에요. Claude Code가 API 요청 코드를 직접 작성하고 실행해서 결과를 터미널에 출력해줘요.

쉽게 말하면 이런 과정이에요.

  1. 내가 말로 요청
  2. Claude Code가 자동으로 코드 작성
  3. 코드를 실행해서 워드프레스에 요청
  4. 결과를 보기 좋게 정리해서 출력

코드를 전혀 몰라도 되는 이유가 바로 이거예요.

실제로 해보기 (따라 하기)

STEP 1. Claude Code 열기

데스크톱 앱의 Cowork 또는 Code 탭을 열어주세요.

STEP 2. Claude Code에 이렇게 말하기

내 워드프레스 글 목록을 가져와줘.
사이트 주소는 https://kimsangjin.shop 이야.
글 제목이랑 발행 날짜를 표 형태로 정리해서 보여줘.

💡 “표 형태로 보여줘” 를 꼭 붙이세요!
REST API 결과는 원래 엄청 복잡한 JSON 형식으로 나오는데, 표로 달라고 하면 Claude Code가 깔끔하게 정리해줘요.

그러면 Claude Code가 알아서 아래 API를 호출해요.

GET https://kimsangjin.shop/wp-json/wp/v2/posts?per_page=10

STEP 3. 결과 확인

이런 식으로 깔끔한 표로 결과가 나옵니다.

| 번호 | 제목                              | 발행일     |
|------|-----------------------------------|------------|
| 1    | Claude Code로 워드프레스 연결하는 법 | 2025-06-01 |
| 2    | 워드프레스 REST API가 뭐예요?        | 2025-06-03 |
| 3    | AI가 뭐예요?                        | 2025-06-05 |

어렵지 않죠?

더 유용하게 쓰는 법

기본 글 목록 말고도 이렇게 활용할 수 있어요.

📌 특정 카테고리 글만 뽑기

'Claude Code 자동화' 카테고리 글만 가져와줘.

📌 임시 저장 글 또는 예약 발행 글 보기

초안(draft) 상태인 글 목록을 보여줘.
예약 발행(future) 상태인 글 목록을 보여줘.

⚠️ 초안·예약 발행 글은 인증이 필요해요!
기본 API는 공개된 글(publish)만 가져와요. 초안이나 예약 발행 글을 보려면 status=draft 또는 status=future 파라미터가 필요하고, 이때 반드시 Application Password 인증이 있어야 해요.
이 부분은 다음 글 “워드프레스 로그인 자동화하기”에서 다룰게요.

📌 글이 많을 때

REST API는 기본적으로 10개씩 가져와요. 최대 한 번에 100개까지 요청할 수 있고, 100개가 넘으면 페이지를 나눠서 가져와야 해요.

글이 100개 넘어. 페이지 나눠서 전부 가져와줘.

Claude Code가 자동으로 페이지를 넘겨가며 전부 가져와줍니다.

실전 활용 예시 (제가 실제로 쓴 방법)

저는 AI 용어 블로그 글을 20개 작성하고 예약 발행 설정을 했는데요. 나중에 “내가 설정한 예약 발행 날짜가 맞는지 확인하고 싶다”는 생각이 들었어요.

그래서 Claude Code에 이렇게 물어봤어요.

예약 발행(future) 상태인 글 목록이랑
각 글의 발행 예정 날짜를 표로 보여줘.

결과로 20개 글 전체의 예약 날짜가 쫙 나왔고, 발행 순서도 한눈에 확인할 수 있었습니다. 관리자 화면 들어가서 하나하나 클릭할 필요가 없었어요.

자주 나오는 오류

오류 메시지원인해결법
404 Not FoundREST API 주소가 틀리거나 고유주소 설정 문제사이트 주소 확인 + 워드프레스 설정 → 고유주소 → ‘글 이름’으로 변경
{"code":"rest_no_route"}API가 비활성화됨워드프레스 설정에서 REST API 활성화
빈 배열 []공개된 글이 없거나 인증 필요초안·예약글은 Application Password 인증 필요

💡 404 오류가 자주 나온다면?
워드프레스 설정 → 고유주소 에서 ‘기본(Plain)’ 으로 되어 있으면 REST API가 작동 안 해요. ‘글 이름’ 등 다른 옵션으로 바꾸면 대부분 해결됩니다.

정리

  • 워드프레스 글 목록은 /wp-json/wp/v2/posts 로 가져올 수 있어요
  • Claude Code는 코드를 직접 작성하고 실행해서 결과를 뿌려줘요
  • 기본 10개씩, 최대 100개까지 한 번에 요청 가능
  • “표 형태로 보여줘” 를 붙이면 훨씬 보기 편해요
  • 초안·예약 글은 Application Password 인증 필요

ClaudeCode워드프레스, 워드프레스글목록가져오기, REST API자동화,

댓글 남기기