n8n, Claude API를 활용하여 프로그래매틱 SEO (Programmatic SEO) 파이프라인을 구축하고 3일 만에 200개 이상의

몇 달 전, 한 클라이언트가 저에게 5개 도시 전역의 150개 이상의 로컬 검색 쿼리(local search queries)에서 순위를 높여달라고 요청했습니다. 하지만 예산은 일반적인 대행사의 월간 유지보수 비용(retainer)조차 충당할 수 없는 수준이었습니다.

150개의 기사를 수동으로 작성하는 대신, 저는 파이프라인(pipeline)을 구축했습니다. 정확히 어떻게 작동하는지 소개합니다.

규모 있는 SEO에서 발생하는 문제점

지리적 타겟팅(geo-targeted) 콘텐츠를 수동으로 제작하는 것은 느리고, 비용이 많이 들며, 일관성이 없습니다. SEO 구조를 이해하고, 지역적 맥락을 알며, 수백 개의 페이지에 걸쳐 품질을 유지할 수 있는 작가가 필요합니다.

저는 그 프로세스를 다음과 같은 시스템으로 대체했습니다: n8n + Claude API + WordPress REST API.

아키텍처 (Architecture)

Google Sheets (입력)
→ n8n 워크플로우 (workflow)
→ Claude API (콘텐츠 생성)
→ WordPress REST API (발행)
→ Next.js 재검증 (revalidation, ISR)
세 가지 도구. 하나의 트리거(trigger). 수동 발행 제로.

1단계 — 입력 시트 (The input sheet)

Google Sheets의 각 행은 하나의 페이지를 정의합니다:

n8n은 정해진 일정에 따라(또는 웹훅(webhook)을 통해 요청 시) 이 시트를 읽습니다.

2단계 — n8n 워크플로우 (The n8n workflow)

핵심 워크플로우는 6개의 노드(nodes)로 구성됩니다:

Google Sheets 트리거 — 처리되지 않은 행(status = "pending")을 읽음
HTTP Request — 구조화된 프롬프트(prompt)와 함께 Claude API를 호출
JSON 파서 (parser) — 제목(title), 슬러그(slug), 본문(content), 요약(excerpt), 태그(tags)를 추출
WordPress REST API — 포스트를 초안(draft) 상태로 생성
Google Sheets 업데이트 — 해당 행을 포스트 URL과 함께 "published"로 표시
Next.js 재검증 (revalidation) — ISR 캐시를 삭제하기 위해 /api/revalidate 호출

Claude 프롬프트가 핵심적인 부분입니다. 간소화된 버전은 다음과 같습니다:

당신은 SEO 콘텐츠 전문가입니다. 다음 항목에 대한 완전한 기사를 작성하세요:

서비스 (Service): {{service}}
도시 (City): {{city}}
타겟 키워드 (Target keyword): {{target_keyword}}
단어 수 (Word count): 2000단어 이상
언어 (Language): 프랑스어

필수 구조:

3단계 — WordPress REST API 호출

// n8n HTTP Request 노드
POST https://your-site.com/wp-json/wp/v2/posts
Authorization: Bearer {{wp_token}}

{
"title": "{{title}}",
"slug": "{{slug}}",
"content": "{{content}}",
"status": "publish",
"categories": [{{category_id}}],
"meta": {
"excerpt": "{{excerpt}}"
}
}

4단계 — Next.js ISR 재검증 (revalidation)

WordPress 앞단에서 Next.js를 실행 중이라면 (또는 커스텀 백엔드를 사용 중이라면), 게시 후 캐시를 무효화(bust the cache)해야 합니다:

// app/api/revalidate/route.ts
import { revalidatePath } from 'next/cache';
import { NextRequest, NextResponse } from 'next/server';

export async function POST(req: NextRequest) {
const { slug } = await req.json();
const secret = req.headers.get('x-revalidate-secret');

if (secret !== process.env.REVALIDATE_SECRET) {
return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
}

revalidatePath(/blog/${slug});
return NextResponse.json({ revalidated: true });
}

n8n은 매 게시물 발행 후 이 엔드포인트를 호출합니다. 페이지는 몇 분 이내에 라이브 상태가 되고 인덱싱(indexing)됩니다.

결과

3일 만에 200개 이상의 지역 타겟팅(geo-targeted) 페이지 배포
페이지당 평균 2,100단어, 일관된 구조 유지
중복 콘텐츠 문제 제로 (도시 + 서비스 조합이 고유함)
경쟁이 낮은 쿼리(low-competition queries)에서 3주 이내에 첫 순위 노출

이 파이프라인은 무인으로 작동합니다. 저는 클라이언트 검토를 위해 수동으로 실행하지만, 크론(cron)을 통해 완전히 자동화하여 실행할 수도 있습니다.

배운 점

프롬프트 엔지니어링 (Prompt engineering)이 병목 구간입니다. Claude가 매번 올바른 HTML 구조를 갖춘 유효한 JSON을 출력하도록 만드는 과정이 n8n 워크플로(workflow) 자체를 구축하는 것보다 더 많은 반복 작업을 필요로 했습니다. 게시하기 전에 JSON을 확인하는 검증 노드 (validation node)를 반드시 추가하세요. 이 단계를 건너뛰지 마십시오.

WordPress REST API의 속도 제한 (rate limits)이 존재합니다. 한 번의 실행으로 200개의 페이지를 배포하려는 경우, 요청 사이에 대기 노드 (Wait node)를 추가하세요 (2~3초). 그렇지 않으면 429 오류(Too Many Requests)를 마주하게 될 것입니다.

ISR 캐시 버스팅 (cache busting)이 중요합니다. 이것이 없으면 새로 게시된 페이지가 몇 시간 동안 오래된 "404 Not Found" 콘텐츠를 제공하게 됩니다. 항상 워크플로에 재검증 (revalidation) 호출을 연결해 두세요.

더 큰 그림

저는 클라이언트를 위해 이러한 종류의 시스템 — SEO 파이프라인, 자동화 워크플로, AI 통합 (AI integrations) — 을 구축합니다. 만약 당신이 이 기술의 비즈니스 측면에 호기심이 있는 개발자이거나, 무엇이 가능한지 이해하고 싶은 기업가라면: 이것이 바로 현대의 디지털 에이전시들이 수동 작업에 대해 시간당 비용을 청구하는 것을 그만두었을 때 실제로 하는 일입니다.

제 사이트에서 이와 관련된 더 많은 내용을 기록하고 있습니다: paulmaximedossou.com

감사 (Audits)는 무료입니다. DM은 언제든 열려 있습니다.

Paul Maxime Dossou — EkoMedia의 설립자. 프랑스와 서아프리카 기업들을 위해 자동화 시스템, SEO 파이프라인, 그리고 AI 통합을 구축합니다.

n8n, Claude API를 활용하여 프로그래매틱 SEO (Programmatic SEO) 파이프라인을 구축하고 3일 만에 200개 이상의

요약

핵심 포인트

댓글