
Google Search Console API를 사용하여 SEO 개선을 자동화하기
요약
Google Search Console API와 Gemini API를 활용하여 SEO 개선 프로세스를 자동화하는 파이프라인 구축 방법을 소개합니다. 저순위 기사를 자동으로 탐지하고, AI로 콘텐츠를 리라이트한 뒤 검색 엔진에 즉시 통지하는 시스템을 구현합니다.
핵심 포인트
- GSC API를 통한 저순위 기사 자동 탐지
- Gemini API를 활용한 SEO 최적화 리라이트 자동화
- IndexNow API를 이용한 신속한 검색 엔진 인덱싱 촉진
- Vercel Cron과 Next.js ISR을 결합한 자동 배포 시스템
서론
Futuristic Imagination LLC 대표 사토입니다. AI 기술을 실제 사업에 쏟아부어, 압도적인 개발·검증 속도와 **철저한 자동화·효율화(시스템화)**를 무기로 매일 제품 개발에 힘쓰고 있습니다. 자사에서는 AI 오운드 미디어(Owned Media)를 11개 사이트 운영하고 있으며, Next.js와 Gemini API, Vercel Cron을 조합함으로써 매일 기사를 자동 생성하여 저 혼자서 운영하고 있습니다.
그런 제가 평소에 강력하게 의식하고 있는 것이 바로 "같은 수작업을 두 번 반복하지 않는다"라는 철저한 자동화에 대한 집념입니다. SEO 개선에 있어서도 이는 예외가 아닙니다.
SEO 대책이라고 하면, 키워드 선정부터 기사 집필, 내부 링크 최적화, 백링크 획득, 그리고 효과 측정과 개선 사이클을 꾸준히 돌리는 이미지가 강할지도 모릅니다. 하지만 하나하나의 작업을 수동으로 하고 있다면, 특히 다수의 사이트를 운영하는 경우 시간과 리소스를 순식간에 고갈시키고 맙니다.
그래서 이번에는 제가 실제로 자사 미디어에서 구현하여 매일 효과를 실감하고 있는 **"Google Search Console API (GSC API)를 사용한 SEO 개선 자동화 파이프라인"**에 대해, 구체적인 구현 방법과 설계 사상을 곁들여 소개하고자 합니다. 이 글을 읽음으로써 여러분의 SEO 개선 프로세스도 극적으로 효율화되어, 보다 전략적이고 크리에이티브한 업무에 집중할 수 있게 될 것입니다.
GSC API를 활용한 SEO 자동 개선의 전체상
먼저, 제가 구축한 SEO 자동 개선 파이프라인의 전체상을 도식화하면 다음과 같습니다.
이 플로우의 포인트는 모든 것이 자동으로 연동되어, 사람의 손을 거치지 않고 기사 탐지부터 리라이트(Rewrite), 공개, 검색 엔진으로의 통지, 나아가 효과 측정까지 완결시킨다는 점입니다.
구체적으로는, Vercel Cron을 사용하여 정기적으로 GSC API를 호출하여 평균 게재 순위가 낮은 기사를 자동으로 특정합니다. 다음으로, 해당 기사의 콘텐츠를 데이터베이스에서 가져와 Gemini API를 사용하여 SEO 관점에서 리라이트합니다. 리라이트된 기사는 데이터베이스에 저장되며, Next.js의 Incremental Static Regeneration (ISR) 기능으로 웹사이트에 공개됩니다. 나아가, 업데이트된 URL은 IndexNow API를 통해 검색 엔진에 즉시 통지되어 신속한 인덱싱 업데이트를 촉진합니다. 마지막으로, 이러한 프로세스와 결과는 Discord의 전용 채널에 자동으로 리포트되어, 제가 "그렇구나" 하고 결과를 확인하기만 하면 되도록 구성했습니다.
이 시스템을 가동함으로써 저는 "진흙탕 같은 검증 프로세스"를 자동화하고, **"가공의 숫자나 실적은 사용하지 않는다"**라는 정책 아래, 실제 데이터와 진지하게 마주할 시간과 여유를 확보하고 있습니다.
GSC API를 통한 저순위 기사 탐지
자동화의 첫걸음은 개선해야 할 기사를 정확하게 특정하는 것입니다. GSC API (Search Console API)를 이용하면 특정 프로퍼티(웹사이트)의 퍼포먼스 데이터를 프로그램으로 가져올 수 있습니다.
1. 인증 정보 취득
GSC API를 이용하려면 Google Cloud Platform에서 프로젝트를 생성하고, Search Console API를 활성화하며, OAuth 2.0 클라이언트 ID를 발급받아야 합니다. 서비스 계정 키(Service Account Key)를 사용하는 방법도 있지만, 이번에는 사용자 계정 인증을 상정합니다.
인증에는 google-auth-library 등의 라이브러리를 사용하면 편리합니다.
import { google } from 'googleapis';
import { OAuth2Client } from 'google-auth-library';
const CLIENT_ID = process.env.GOOGLE_CLIENT_ID;
...
이 REFRESH_TOKEN은 한 번 오프라인에서 인증 프로세스를 실행하여 취득해 두어야 합니다. 보안 측면을 고려하여 본 환경에서는 환경 변수로서 엄격하게 관리하고 있습니다.
2. GSC API를 사용하여 데이터 쿼리하기
인증 정보를 취득했다면, GSC API의 searchanalytics.query 메서드를 사용하여 퍼포먼스 데이터를 가져옵니다.
저의 경우, 최근 90일간의 데이터를 대상으로 평균 게재 순위 (position)가 일정 값 이하(예를 들어 20위 이하)인 URL을 추출하도록 하고 있습니다.
import { google } from 'googleapis';
import { getOAuth2Client } from '../../lib/googleAuth';
const WEB_PROPERTY_URL = 'https://www.futuristicimagination.co.jp/'; // 당신의 웹사이트 URL
...
이 detectLowRankingPages 함수를 Vercel Cron을 통해 정기적으로 실행하면, 개선 대상 URL 리스트를 자동으로 가져올 수 있습니다. 제 경험상, "어라, 이거 좀 ~한 것 같은데?"라며 GSC (Google Search Console)를 빈번하게 확인하며 수동으로 판단하는 것보다, 어느 정도 자동화된 임계값 (threshold)을 설정하여 기계적으로 추출하는 것이 편차 없이 효율적으로 개선을 진행할 수 있습니다.
Gemini API를 활용한 기사 리라이트 (Rewrite)
순위가 낮은 기사를 특정했다면, 다음으로는 해당 기사의 내용을 개선합니다. 여기서는 Google의 고성능 LLM (Large Language Model)인 Gemini API를 활용합니다.
1. 기사 콘텐츠 가져오기
리라이트를 하려면 먼저 대상 기사의 현재 콘텐츠가 필요합니다. 저의 경우, 데이터베이스에 저장된 기사 본문을 가져오거나, 필요하다면 스크레이핑 도구 (Node.js + cheerio 또는 puppeteer 등)를 사용하여 웹 페이지에서 직접 가져옵니다.
2. Gemini API를 사용하여 리라이트 프롬프트 구축
Gemini API를 사용하여 효과적인 리라이트를 수행하려면 고품질의 프롬프트 (prompt)가 중요합니다. 저는 다음과 같은 관점에서 프롬프트를 설계하고 있습니다.
목적의 명확화: "SEO 개선을 위해 지정된 키워드를 포함하고, 독자의 검색 의도에 부합하는 내용으로 가필 및 수정해 주세요."
구체적인 지시: "현재의 문장 구성은 유지하면서 도입 부분의 후크 (hook)를 강화해 주세요", "소제목을 더 구체적이고 매력적으로 변경해 주세요", "결론을 간결하게 요약해 주세요"
키워드 지정: GSC API로 검출한 저순위 기사의 관련 키워드나, 새롭게 노리는 키워드를 명시적으로 지시합니다.
출력 형식 지정: Markdown 형식이나 HTML 형식 등, 생성된 텍스트를 시스템에서 바로 다루기 쉬운 형식으로 출력하도록 지시합니다.
글자 수 제한: 불필요하게 길어지지 않도록, 원본 기사 글자 수에서 ±X% 정도의 범위 내에서 조정하도록 지시하기도 합니다.
import { GoogleGenerativeAI } from '@google/generative-ai';
const API_KEY = process.env.GEMINI_API_KEY; // Gemini API Key
const genAI = new GoogleGenerativeAI(API_KEY);
...
저는 Gemini 1.5 Flash 모델을 사용하고 있습니다. 이는 저의 **"압도적인 개발·검증 속도"**와 "처리량 (throughput)"을 중시하는 스타일에 부합합니다. 이전에는 Gemini 2.0을 사용했으나, 더 빠른 Flash 모델로의 전환도 원활하게 진행할 수 있었습니다. 이러한 최신 모델로의 신속한 전환은 AI 시대의 골드러시에서 승리하기 위해 매우 중요하다고 생각합니다.
Next.js를 통한 공개 및 IndexNow 알림
리라이트된 기사는 제가 운영하는 Next.js 기반의 웹사이트에 공개됩니다.
1. 데이터베이스 저장 및 ISR 트리거
리라이트된 기사는 데이터베이스에 저장되며, 해당 업데이트를 트리거로 하여 Next.js의 ISR (Incremental Static Regeneration)을 실행합니다.
import { updateArticleInDatabase } from './databaseService'; // 데이터베이스 업데이트 함수를 가정
import { revalidatePath } from 'next/cache'; // Next.js 13.x 이후의 App Router용
export const publishRewrittenArticle = async (articleId: string, newContent: string, articleSlug: string) => {
...
이 ISR (Incremental Static Regeneration) 메커니즘을 통해 빠르고 견고한 배포 설계를 실현하고 있습니다. 콘텐츠가 업데이트되어도 다시 빌드할 필요 없이, 사용자 액세스 시 최신 콘텐츠가 배포되도록 합니다.
2. IndexNow를 통한 검색 엔진 통지
기사를 공개하면 가능한 한 빨리 검색 엔진이 새로운 콘텐츠를 인식하도록 해야 합니다. 여기서 활약하는 것이 바로 IndexNow입니다. IndexNow는 콘텐츠의 변경 사항을 검색 엔진(Google은 직접 지원하지 않지만, Bing이나 Yandex를 통해 간접적인 혜택을 받는다고 알려져 있습니다)에 즉시 통지하기 위한 프로토콜입니다.
const INDEXNOW_API_KEY = process.env.INDEXNOW_API_KEY; // IndexNow API Key
const YOUR_SITE_URL = 'https://www.futuristicimagination.co.jp/'; // 당신의 사이트 URL
export const notifyIndexNow = async (urls: string[]): Promise<void> => {
...
IndexNow를 이용하려면 웹사이트의 루트 디렉토리에 key.txt 파일을 배치하고, 그 안에 API 키를 기재해야 합니다. keyLocation은 해당 파일의 URL을 가리킵니다.
이 IndexNow 통지와 GSC API를 통한 데이터 취득을 결합함으로써, **「저순위 기사 자동 리라이트(Rewrite) & 전송 파이프라인」**이 완성됩니다. 저는 이 '비책'이라고도 할 수 있는 지름길을 항상 탐색하며, 더 스마트한 메커니즘이 없는지 매일 고민하고 있습니다.
자동 리포트와 지속적인 개선 사이클
일련의 자동화 프로세스가 완료된 후, 그 결과를 저 자신이 파악할 수 있도록 Discord로의 자동 리포트를 도입하고 있습니다.
Discord로의 주간 리포트 자동 전송
Node.js에서 Webhook을 사용하여 리라이트된 기사 리스트나 그 이후의 순위 변동 경향 등을 Discord로 자동 전송하고 있습니다. 이를 통해 제가 일일이 각 사이트의 GSC를 확인하지 않아도, 일주일에 한 번 Discord를 보는 것만으로
- 압도적인 효율화: 수동 SEO 개선 작업에서 해방되어 시간과 리소스를 대폭 절약할 수 있습니다.
- 고속 PDCA 사이클: 저순위 기사 탐지부터 리라이트 (Rewrite), 발행, 검색 엔진 통보까지 자동화함으로써 신속한 개선 사이클을 돌릴 수 있습니다.
- 데이터에 기반한 의사결정: GSC API에서 얻은 실제 데이터에 기반하여 객관적으로 개선 대상을 특정할 수 있습니다.
- 최신 기술 활용: Gemini API나 Next.js의 ISR 등 최첨단 기술을 실제 비즈니스에 응용할 수 있습니다.
저의 사업은 AI 에이전트를 말 그대로 '부하 직원이나 파트너'로서 병행 가동시켜, 자체 개발 프로덕트, 다수의 미디어, 수탁 개발을 소수 인원(또는 극한의 자동화 환경)으로 고속 운영하는 것을 목표로 하고 있습니다. 이번에 소개해 드린 메커니즘도 그 일환입니다.
여러분도 꼭 이 기사를 참고하여 자사의 SEO 개선 프로세스를 자동화하고, 미래의 일하는 방식을 실천해 보시기 바랍니다.
이번에 소개한 메커니즘의 구축 대행도 맡고 있습니다. 귀사의 비즈니스에 AI와 자동화의 힘을 도입하고 싶으신 분은 꼭 Futuristic Imagination LLC로 상담해 주세요. → https://www.futuristicimagination.co.jp/service/
참고
- Google Search Console API (공식 문서): https://developers.google.com/search-console/v1/
- Gemini API (공식 문서): https://ai.google.dev/docs/gemini_api_overview
- IndexNow (공식): https://www.indexnow.org/
- Next.js (공식 문서): https://nextjs.org/docs
Discussion

AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기