Yoast 점수는 매주 보는데, 왜 다음 행동은 안 나올까?

콘텐츠 팀의 월요일은 비슷합니다. Yoast SEO를 열고 글 목록의 초록·주황·빨간 점을 훑습니다. 문제가 있으면 기억해두고, 괜찮으면 탭을 닫습니다. 그런데 다음 주가 되면 같은 점검을 반복합니다. 점수는 있었지만, 점수에서 다음 행동으로 이어지는 통로는 없었습니다.

이번 Yoast SEO Abilities API 연동은 이 병목을 건드립니다. SEO 점수를 더 잘 보여주는 기능이 아니라, 이미 계산된 점수를 AI와 리포트 도구가 읽을 수 있는 입력값으로 바꾸는 기능입니다. 이 차이를 이해하면 “AI가 글을 대신 써준다”는 이야기보다 훨씬 실용적인 도입 지점이 보입니다.

[외부 정보] Yoast 점수가 화면 밖으로 나왔다

Yoast는 2026년 4월 28일, WordPress Abilities API를 통해 AI 도구·대시보드·자동화 워크플로가 Yoast 콘텐츠 분석 점수를 직접 읽을 수 있게 됐다고 발표했습니다. 전제는 WordPress 6.9입니다. 플러그인 기능을 사람이 화면에서 확인하는 대신, 다른 시스템이 표준화된 방식으로 발견하고 호출할 수 있게 만든 것입니다.

Yoast가 현재 등록한 능력은 세 가지입니다. 모두 최근 수정된 글의 분석 결과를 돌려주는 읽기 전용 기능입니다.

  • yoast-seo/get-seo-scores — SEO 분석 점수와 포커스 키프레이즈
  • yoast-seo/get-readability-scores — 가독성 분석 점수
  • yoast-seo/get-inclusive-language-scores — 포용적 언어 분석 점수
Yoast SEO가 SEO, 가독성, 포용적 언어 점수를 세 가지 읽기 전용 능력으로 제공하는 표
Yoast 개발자 문서의 세 가지 읽기 전용 능력. 출처: Yoast SEO Abilities 분석 점수 문서.

클라이언트는 /wp-json/wp-abilities/v1/abilities?category=yoast-seo에서 이 능력들을 발견할 수 있습니다. 각 능력은 입력·출력 스키마와 권한 정보를 갖습니다. 점수 조회 범위는 number_of_posts로 지정하며, 공식 문서 기준 기본값은 10개, 허용 범위는 1~100개입니다. 결과에는 글 제목, score 값(na, bad, ok, good), 사람이 읽는 라벨이 포함되고 SEO 점수에는 포커스 키프레이즈도 포함됩니다.

WordPress 쪽의 역할도 중요합니다. WordPress 6.9의 Abilities API는 플러그인 기능을 이름, 입력·출력 스키마, 권한 검사와 함께 등록하는 표준 레지스트리입니다. 공식 MCP Adapter를 사용하면 등록된 능력을 MCP 도구로 노출할 수 있고, Claude Desktop·Cursor·Claude Code·VS Code 같은 MCP 클라이언트가 능력을 발견하고 호출할 수 있습니다.

Yoast SEO 능력이 글 제목, 점수, 라벨, 포커스 키프레이즈를 JSON으로 반환하는 예시
화면용 점수가 구조화된 응답이 되면, AI가 글별 결과를 묶어 비교할 수 있습니다. 출처: Yoast 개발자 문서.

[필자의 분석] 핵심은 AI가 아니라 ‘점수의 두 번째 생명’이다

내가 이 발표를 중요하게 보는 이유는 “Yoast가 AI와 연결됐다”는 문장 때문이 아닙니다. 더 근본적인 변화는 한 번 계산한 결과를 여러 워크플로가 재사용할 수 있게 됐다는 것입니다.

지금까지 SEO 점수는 화면에 표시되는 순간 소비됐습니다. 담당자는 점수를 읽고, 필요한 내용을 메모하고, 팀 리포트에 옮기고, 다음 회의에서 다시 설명했습니다. API가 생기면 이 중 복사·정리·요약 단계는 기계에 맡길 수 있습니다. 사람의 시간이 점수를 옮기는 데서 점수의 의미를 판단하는 데로 이동합니다.

이때 중요한 것은 “AI에게 SEO를 맡긴다”가 아닙니다. 정확히는 AI에게 진단 데이터의 수집과 분류를 맡기고, 사람은 우선순위와 수정 결정을 맡는 구조입니다. 현재 Yoast 능력이 읽기 전용인 것도 이 단계에서는 장점입니다. 에이전트가 글을 마음대로 고치지 않고, 최근 글에서 반복되는 약점을 찾아주는 데 머물기 때문입니다.

실제 워크플로는 이렇게 설계하면 된다

도입 목표를 “AI에게 SEO를 물어보기”로 잡으면 금방 장난감이 됩니다. 목표는 주간 콘텐츠 리뷰의 준비 시간을 줄이고, 수정할 글의 우선순위를 빠르게 정하는 것이어야 합니다. 다음과 같은 작은 루프부터 시작하는 편이 낫습니다.

  1. 범위를 고정합니다. 최근 수정된 글 10개처럼 작은 집합으로 시작합니다. 처음부터 전체 아카이브를 읽히면 오래된 글과 새 글의 문제가 섞입니다.
  2. 세 점수를 같은 기준으로 받습니다. SEO만 보지 말고 가독성과 포용적 언어 점수도 함께 가져옵니다. 한 글의 검색 최적화가 좋아도 독자가 읽기 어렵다면 수정 순서는 달라질 수 있습니다.
  3. AI에게 숫자보다 패턴을 묻게 합니다. “좋은 글과 개선이 필요한 글의 주제·형식·키프레이즈에 공통점이 있는가?”처럼 비교 질문을 사용합니다.
  4. 답변을 행동 목록으로 바꿉니다. AI의 결론을 그대로 게시하지 말고, 담당자·수정 대상·검토 기준이 있는 작업 항목으로 변환합니다.
  5. 원본 화면과 한 번 대조합니다. 첫 운영 주에는 API 응답과 Yoast 화면의 점수가 같은지 확인합니다. 연결보다 신뢰 형성이 먼저입니다.

주간 프롬프트도 구체적이어야 합니다. 예를 들어 다음처럼 요청할 수 있습니다.

최근 수정된 글 10개의 SEO·가독성·포용적 언어 점수를 가져와 표로 정리해줘. 점수가 낮은 글을 나열하는 데 그치지 말고, 제목 형식·주제·포커스 키프레이즈에서 반복되는 패턴을 찾아줘. 추정과 실제 응답을 구분하고, 사람이 검토할 수정 우선순위 3개만 제안해줘.

이 루프의 이득은 AI가 더 그럴듯한 조언을 하는 데 있지 않습니다. 매주 같은 데이터를 수집하는 비용을 줄이고, 팀이 같은 출발선에서 논의하게 만드는 데 있습니다. 대시보드가 “확인용 화면”이었다면, 구조화된 점수는 “의사결정용 재료”가 됩니다.

도입 전에 확인할 세 가지

다만 이 기능을 켠다고 바로 자동화가 완성되는 것은 아닙니다. 공식 문서가 제시한 전제와 운영상 주의점을 먼저 확인해야 합니다.

  • 버전: WordPress 6.9 이상이 필요합니다. Yoast SEO도 Abilities 기능을 포함한 버전인지 확인해야 합니다.
  • Indexables: Yoast Indexables가 활성화되어 있고 완전히 구축되어야 합니다. 이 조건이 빠지면 능력이 등록되지 않을 수 있습니다.
  • 권한: MCP 연결은 로그인한 WordPress 사용자의 권한으로 동작합니다. 운영 사이트에서는 관리자 계정을 그대로 연결하지 말고, 필요한 읽기 권한만 가진 전용 사용자를 고려해야 합니다.

특히 읽기 전용 점수 조회에서 쓰기 작업으로 범위를 넓힐 때는 속도를 늦춰야 합니다. 공식 WordPress MCP Adapter 문서도 권한 콜백을 신중하게 설정하고, 파괴적인 작업에 무조건 허용을 사용하지 말며, 사용량을 기록하라고 안내합니다. 이번 Yoast 연동을 처음 도입한다면 “진단 리포트”까지만 열고, 글 수정이나 게시 자동화는 별도의 승인 단계로 분리하는 것이 안전합니다.

결론: 대시보드를 없애는 게 아니라, 대시보드에 가기 전을 자동화하자

Yoast SEO Abilities API는 SEO의 정답을 대신 내리는 도구가 아닙니다. 대신 점수를 사람이 매주 찾아 읽어야 한다는 오래된 전제를 없앱니다. 이 변화의 가장 현실적인 쓰임은 콘텐츠를 자동으로 고치는 데 있지 않고, 어떤 글을 먼저 보고 무엇을 확인할지 미리 정리하는 데 있습니다.

이번 주에 할 일은 거창하지 않습니다. WordPress와 Yoast의 버전을 확인하고, 공식 문서의 능력 발견 엔드포인트에서 세 가지 능력이 보이는지 확인하세요. MCP 클라이언트를 연결했다면 최근 글 10개만 읽혀서 “낮은 점수의 목록”이 아니라 “반복되는 패턴과 검토할 우선순위”를 답하게 해보세요. 첫 답변은 반드시 Yoast 화면과 대조하세요.

그 결과 주간 리뷰의 준비 시간이 실제로 줄었는지, AI가 찾은 패턴 중 사람이 유효하다고 판단한 것이 무엇이었는지 기록해보면 됩니다. 이 작은 기록이 쌓이면 점수는 더 이상 닫고 잊는 숫자가 아니라, 다음 콘텐츠 결정을 움직이는 입력값이 됩니다.

근거 출처

외부 정보 (하베스터 수집) — 아래 공식 문서와 발표에서 기능, 버전, 엔드포인트, 데이터 형식, 보안 권고를 확인했습니다.

상호작용 (에이전트-드루 대화·작업) — 이 글에는 실제 WordPress 사이트에 MCP를 연결해 운영한 상호작용 기반 근거를 사용하지 않았습니다. “점수가 산출물에서 입력값이 된다”는 해석, 주간 리뷰 루프, 도입 순서와 CTA는 위 외부 정보를 바탕으로 한 필자의 분석·제안입니다.