워드프레스 Rank Math 자동화를 적용해서 포커스 키워드와 메타 설명까지 자동으로 입력되도록 설정했어요. 블로그 글 발행할 때마다 수작업으로 SEO 필드를 채우는 게 번거로웠거든요.
오늘 목표
Code Snippets 플러그인을 활용해 Rank Math REST API에 SEO 필드를 자동으로 등록하는 기능 구현하기
준비물
Step 1: Rank Math 필드명 확인하기
가장 먼저 부딪힌 문제가 정확한 필드명을 모르는 것이었어요. 워드프레스 Rank Math 자동화를 구현하려면 포커스 키워드와 메타 설명의 정확한 필드명이 필요하거든요.
Claude한테 “Rank Math SEO 플러그인에서 포커스 키워드와 메타 설명의 정확한 필드명이 뭔지 알려줘”라고 물어봤더니 바로 답변이 나왔어요:
rank_math_focus_keyword
rank_math_description이 필드명들이 핵심이더라고요. 다음과 같이 정리해 주었습니다.
Step 2: Code Snippets에 REST API 등록 코드 추가
워드프레스 관리자 페이지에서 Code Snippets 메뉴로 들어가서 새로운 스니펫을 만들었어요. 제목은 “Rank Math REST API Fields”로 설정했죠.
Claude가 알려준 코드를 그대로 복사해서 붙여넣었더니 됐어요:
add_action('rest_api_init', function () {
register_rest_field('post', 'rank_math_focus_keyword', array(
'get_callback' => function($post_arr) {
return get_post_meta($post_arr['id'], 'rank_math_focus_keyword', true);
},
'update_callback' => function($value, $post) {
return update_post_meta($post->ID, 'rank_math_focus_keyword', $value);
},
'schema' => array(
'type' => 'string',
'description' => 'Rank Math Focus Keyword'
)
));
register_rest_field('post', 'rank_math_description', array(
'get_callback' => function($post_arr) {
return get_post_meta($post_arr['id'], 'rank_math_description', true);
},
'update_callback' => function($value, $post) {
return update_post_meta($post->ID, 'rank_math_description', $value);
},
'schema' => array(
'type' => 'string',
'description' => 'Rank Math Meta Description'
)
));
});“Run snippet everywhere”로 설정하고 활성화했어요. 이제 REST API를 통해 Rank Math 필드에 값을 전달할 수 있게 된 거죠.
Step 3: 자동화 시스템 연동 테스트
기존에 만들어둔 블로그 자동 생성 시스템에서 이 새로운 필드들을 활용해봤어요. JSON 데이터에 seo_keyword와 excerpt 값을 포함시켜서 보내니까 실제로 워드프레스 Rank Math 자동화가 작동하더라고요.
포스트를 확인해보니 포커스 키워드 필드에 값이 자동으로 들어가 있고, 메타 설명도 제대로 설정되어 있었어요. 수작업으로 하나씩 입력할 필요가 없어진 거죠.
테스트 결과는 아래 화면과 같습니다.
Step 4: SEO 점수 확인하기
Rank Math에서 SEO 점수를 체크해봤는데 예전보다 훨씬 높게 나오더라고요. 포커스 키워드가 제대로 설정되니까 다른 SEO 요소들도 자동으로 체크되는 것 같아요.
특히 메타 설명 길이나 키워드 밀도 같은 부분에서 녹색 점수를 받을 수 있게 됐어요. 워드프레스 Rank Math 자동화의 효과를 바로 확인할 수 있었죠.
현재 상황과 고민
시스템은 완벽하게 작동하는데 아직 구글 검색 결과에는 노출이 안 되고 있어요. SEO 효과가 실제로 있는 건지 의심스러운 마음도 들고요.
그래도 계속 써보려고 해요. 적어도 수작업으로 SEO 필드 채우는 시간은 확실히 줄었거든요. 하루에 몇 개씩 글을 올리다 보면 이런 자동화가 꽤 도움이 될 것 같아요.
결과
- Rank Math REST API 필드 등록 완료
- 포커스 키워드 자동 입력 기능 구현
- 메타 설명 자동 설정 기능 추가
- SEO 점수 개선 확인
- 블로그 발행 과정 자동화율 향상
자주 묻는 질문
Q: Code Snippets 말고 다른 방법은 없나요?
A: functions.php 파일에 직접 코드를 추가할 수도 있지만, Code Snippets를 쓰면 테마를 바꿔도 코드가 사라지지 않아서 더 안전해요.
Q: 다른 SEO 플러그인에서도 비슷하게 할 수 있나요?
A: 각 플러그인마다 필드명이 다르기 때문에 해당 플러그인의 메타 필드명을 확인해야 해요. Claude한테 물어보면 대부분 알려줄 거예요.
마무리
워드프레스 Rank Math 자동화 설정이 생각보다 간단했어요. 필드명만 정확히 알면 REST API 등록은 금방 끝나더라고요.
구글 노출은 아직 안 되고 있지만, 일단 시스템은 제대로 돌아가니까 계속 써볼 생각이에요. 몇 주 더 지켜보면 효과가 나타날지도 모르겠거든요.
썸네일 사진: Vitaly Gariev on Unsplash