몇 달 전, 한 클라이언트가 저에게 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의 각 행은 하나의 페이지를 정의합니다:

city (도시) | service (서비스) | target_keyword (타겟 키워드) | population (인구) | competitors (경쟁사)
Cotonou | n8n automation consultant | n8n cotonou | 800,000 | ...
Abidjan | automatisation processus | automatisation abidjan | 4M | ...

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

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

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

1. Google Sheets 트리거 — 처리되지 않은 행(status = "pending")을 읽음
2. HTTP Request — 구조화된 프롬프트(prompt)와 함께 Claude API를 호출
3. JSON 파서 (parser) — 제목(title), 슬러그(slug), 본문(content), 요약(excerpt), 태그(tags)를 추출
4. WordPress REST API — 포스트를 초안(draft) 상태로 생성
5. Google Sheets 업데이트 — 해당 행을 포스트 URL과 함께 "published"로 표시
6. 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 통합을 구축합니다.