Claude Code + AgentKit로 SEO 콘텐츠 만드는 방법 (2026)

거의 매 근무일 Claude Code로 SEO 콘텐츠를 쓰는 개발자, Jasmine이 씁니다.

세상의 'SEO를 위한 AI' 가이드 대부분은 데이터를 분석하는 법이나, 이미 존재하는 페이지를 최적화하는 법을 알려줘요. 정작 제가 시간을 쏟는 부분—키워드를 완성된, 발행 가능한 글로 바꾸는 일—을 보여주는 곳은 거의 없어요. 바로 그게 이 가이드의 핵심이에요. 제가 실제로 쓰는 프롬프트, 무엇이 어긋나는지에 대한 솔직한 메모, 그리고 바로 쓸 수 있는 skill이 반나절의 세팅을 줄여주는 지점까지 담은, 글쓰기 루프의 전체 모습을 보여드릴게요.

어느 AgentKit일까요? (30초 만에 구분하기)

더 들어가기 전에, 이 주제를 검색할 때 누구나 걸려 넘어지는 한 가지가 있어요. 이제 'AgentKit'은 서로 무관한 두 제품을 가리켜요.

이 가이드가 사용하는 건 AgentKit for Claude Code예요—agentkit.best에 있는 키트로, ak CLI로 설치하고 seo skill과 ak-copywriting skill을 함께 제공해요. 이건 OpenAI의 AgentKit(Agent Builder와 ChatKit, 2025-10-06 출시)이 아니에요. 그건 에이전트를 만들기 위한 별개의 플랫폼이에요. 또한 GitHub에는 이름이 쌍둥이처럼 비슷한 무료 skill(AgriciDaniel/claude-seo)도 있어요. 그건 커뮤니티에서 만든 단일 스크립트지만, 제가 쓰는 AgentKit skill은 업데이트가 되는, 관리되는 한 쌍이에요. 엉뚱한 걸 설치하고 왜 명령어가 다른지 헷갈리지 않도록 일부러 짚어둘게요.

왜 SEO 콘텐츠에 Claude Code를 쓸까요? (채팅 창과 비교해서)

물론 채팅 창에서도 SEO 초안은 쓸 수 있어요. 저도 1년 동안 그렇게 했어요. 문제는 채팅에는 여러분의 파일에 대한 기억도, '손'도 없다는 거예요. 글마다 브랜드 보이스를 붙여넣고, 경쟁사 메모를 붙여넣고, 아웃라인을 붙여넣고, 초안을 다시 복사해 빼내고, 서식을 다시 맞추고—그리고 다음 주에 또 처음부터 하는, 복붙 의식이 반복돼요.

Claude Code는 Anthropic이 만든, 여러분의 프로젝트 폴더 안에서 실행되는 터미널 에이전트예요. 그래서 작업의 모양이 구체적으로 세 가지 방식으로 달라져요.

• 실제 파일을 읽고 써요. 브랜드 보이스는 CLAUDE.md 파일에, 브리프는 /briefs에, 초안은 .md나 .html로 남아요. 에이전트가 그걸 열고, 그 자리에서 편집하고, 저장해요. 복붙 왕복이 없어요.
• 명령을 실행해요. 기존 글을 grep해서 내부 링크 대상을 찾거나, 메타 디스크립션의 글자 수를 세거나, 두 글이 같은 키워드를 노리고 있지 않은지 확인할 수 있어요.
• 반복 가능해요. 지시가 파일과 skill 안에 있으니, 같은 파이프라인이 1번째 글이든 40번째 글이든 똑같이 돌아가요. 매번 다시 타이핑하는 채팅 프롬프트는 워크플로우가 아니에요. 불러내기만 하면 되는 skill이 워크플로우예요.

이 도구가 완전히 처음이라면, Claude Code가 무엇인지, 그리고 에디터 플러그인과 어떻게 다른지를 쉬운 말로 정리한 입문 글을 써뒀어요. 짧게 말하면, 자동완성 입력칸이라기보다 파일로 지시하는 주니어 팀원에 더 가까워요. 바로 이 관점이 아래의 SEO 파이프라인을 가능하게 해요.

솔직한 트레이드오프는 이래요. 일회성 한 문단이라면 채팅 창이 더 빨라요. 하지만 정기적으로 콘텐츠를 쓰고, 매번 같은 품질 기준을 원하는 순간부터 Claude Code가 이겨요.

시작하기 전에 필요한 것

다섯 가지예요. 처음 세 가지로 시작하고 나머지는 나중에 더해도 돼요.

• 설치하고 로그인한 Claude Code. 유료 Claude 요금제(Pro는 월 20달러, Max는 월 100달러와 200달러 등급)가 있으면 긴 글 세션도 편해요. 흐름을 테스트할 수 있는 제한된 무료 등급도 있어요.
• SEO+카피라이팅 skill. 직접 만들거나(에이전트가 불러오는 지시 폴더), 관리되는 걸 쓰세요. 개념이 처음이라면, 여기 Claude Code skill이 어떻게 작동하는지 보세요—에이전트가 필요할 때 활성화하는 재사용 가능한 지시 묶음이에요. AgentKit은 바로 이 파이프라인용으로 미리 연결된 seo skill과 ak-copywriting skill을 함께 제공해요. 자세한 건 뒤에서요.
• 브랜드 보이스와 규칙을 담은 CLAUDE.md. 이건 가장 효과가 큰 단 하나의 파일이에요. 톤, 금지 문구, 목표 독해 수준, 메타 타이틀·메타 디스크립션 글자 수 상한, 내부 링크 규칙을 여기에 적어요. 모든 세션이 자동으로 읽어요.
• 키워드 데이터. Claude Code는 실시간 검색 결과를 볼 수 없으니, 데이터는 여러분이 넘겨줘요. 노리는 키워드, 경쟁사 URL 몇 개, 그리고 Google Search Console, Semrush, Ahrefs나 수동 SERP 확인에서 얻은 지표들이에요.
• 콘텐츠 폴더 구조. /briefs, /drafts, /published 정도로 단순해도 에이전트가 방향을 잃지 않아요.

전체 워크플로우—키워드에서 발행된 글까지

이게 뼈대예요. 여섯 단계, 각 단계마다 실제 프롬프트나 명령, 에이전트가 돌려주는 것, 그리고 스크린샷이 들어갈 자리가 있어요. 저는 이걸 하나의 순서로 실행하면서, 각 출력을 파일에 저장해 다음 단계가 읽을 수 있게 해요.

1단계—키워드와 검색 의도 리서치하기

Claude Code는 실시간 SERP에 접근할 수 없으니, 원재료는 제가 넘겨줘요. 노리는 키워드와 상위 경쟁 페이지 URL(페이지에 보이는 텍스트를 파일로 복사하거나, 연결해둔 게 있으면 fetch/scrape 단계를 써요)을 붙여넣고, 제가 손으로 할 분석을 대신 해달라고 요청해요.

Target keyword: "claude code for seo content"
I've saved the top 5 competitor pages to /research/competitors.md.

Read that file and give me:
1. The dominant search intent (informational / commercial / transactional)
2. Every H2 each competitor uses, grouped by theme
3. Topics ALL of them cover (table stakes)
4. Topics NONE of them cover well (my opening)
5. Rough word count of the top 3

돌아오는 건 구조화된 의도 분류와 갭 목록이에요. 이 갭 목록이 노다지예요—상위 페이지에 빠져 있는 정보를 어디에 더할 수 있는지 알려주거든요. 그게 바로, 아홉 번째 똑같은 가이드를 쓰는 대신 성숙한 SERP에서 자리를 얻어내는 방법 그 자체예요.

2단계—콘텐츠 브리프 생성하기

다음으로, 그 리서치를 초안 단계가 그대로 따라갈 수 있는 브리프로 바꿔요. 섹션별 글자 수, 키워드 배치, 특정 H2에 매핑한 경쟁사 갭, 그리고 스키마 계획을 요청해요.

Using /research/intent.md, write a content brief to /briefs/brief.md with:
- H1 + meta title (≤60 chars) + meta description (130-150 chars)
- A full H2/H3 outline with a word-count target per section
- Where the primary + 2 secondary keywords go
- Which competitor gap each section fills
- The schema to add (FAQPage if there's an FAQ)
Keep every claim checkable - mark anything you're unsure of as.

진짜 신뢰를 쌓아주는 작은 메타 노트 하나. 지금 읽고 계신 이 글도 바로 이런 구조의 브리프에서 쓰였어요—섹션별 글자 수, 경쟁사 갭, 키워드 배치, 스키마 계획까지요. 이 파이프라인은 이론이 아니에요. 지금 이 페이지를 만들어내고 있어요.

3단계—글 초안 잡기 (슬롭 방지)

여기가 다들 틀리는 단계예요. AI에게 브리프를 주고 '써'라고만 하면 슬롭이 나와요—속 빈 도입부, '오늘날 빠르게 변하는 세상에서' 같은 상투구, 반복되는 같은 생각, 자신만만한 가짜 통계. 해법은 엄격하고 구체적인 프롬프트와, CLAUDE.md에 담긴 브랜드 보이스예요.

제가 실제로 쓰는 슬롭 방지 프롬프트는 이거예요.

Draft /drafts/article.md from /briefs/brief.md. Follow CLAUDE.md for voice.
Rules:
- No filler openings, no "in today's world", no throat-clearing. First
 sentence answers the question.
- Every claim is either checkable or marked. Invent NO statistics,
 prices, or study citations.
- Include at least one concrete, real example per major section.
- State limitations and trade-offs honestly - don't oversell.
- Vary sentence length. No paragraph over 4 sentences.
- Where I should add first-hand experience or a screenshot, leave a marker instead of faking it.

가장 중요한 두 줄은 '통계를 지어내지 마'와 '지어내는 대신 마커를 남겨'예요. 이 둘이 함께 있으면, 모델은 자신만만한 날조자에서, 자기 빈틈을 스스로 표시하는 신중한 초안 작성자로 바뀌어요. 그래도 많이 편집하게 되지만—슬롭을 지우는 게 아니라 진짜 뼈대를 편집하게 돼요.

4단계—온페이지 최적화

초안이 파일이라, 별도의 도구에 붙여넣는 대신 같은 세션 안에서 온페이지 요소를 최적화할 수 있어요. 모든 걸 한 번에 요청하고—결정적으로—글자 수는 에이전트에게 세게 시켜요. 모델은 검증하라고 시키지 않으면 길이 제한을 지키는 데 악명 높게 서투르거든요.

Optimize /drafts/article.md for on-page SEO:
- Meta title ≤60 chars - print the character count next to it
- Meta description 130-150 chars - print the count
- Check heading hierarchy (one H1, logical H2/H3)
- Suggest 3-5 internal links from /published (grep for related topics)
- Write descriptive alt text for each image placeholder
- Draft an FAQ (5-6 Q&A) and the matching FAQPage JSON-LD

'글자 수를 출력해'라는 지시가, 검색 결과에서 잘려나가는 68자 타이틀과 깔끔한 54자 타이틀을 가르는 차이예요. 먼저 카운트를 믿고, 그다음 직접 눈으로도 확인하세요.

온페이지를 같은 세션에서 하면 두 번째 이점이 있어요. 내부 링크 제안이 실제로 존재하는 파일에 근거한다는 거예요. 에이전트에게 /published를 grep해서 관련 주제를 찾아달라고 하면, 그럴듯해 보이기만 하는 슬러그를 지어내는 대신 제 사이트의 실재하는 라이브 URL로 링크를 제안해줘요—별도 도구에서 최적화하고 링크를 손으로 붙여 넣을 때 놓치기 쉬운 실수죠.

5단계—사람의 편집, 팩트체크, E-E-A-T

타협 불가예요. 여기서 글은 AI 출력이길 멈추고 여러분의 것이 돼요. 저는 네 가지를 해요.

• 모든 마커를 해결하기. 출처를 열어 숫자나 날짜를 확인하고, 마커를 교체해요. 검증할 수 없으면 그건 빼요.
• 모든 마커를 채우기—그럴듯한 지어낸 이야기가 아니라, 진짜 스크린샷이나 실제 경험에 근거한 메모로요.
• 모델이 가질 수 없는 경험을 더하기: 실제로 무엇이 망가졌는지, 무엇에 놀랐는지, 직접 해봐야만 아는 트레이드오프요.
• 출처를 밝히고 날짜를 적기. 기능이나 출시에 관한 주장은 공식 출처를 날짜와 함께 링크해요—Claude Code 기능이라면 Anthropic 문서를, 제품 사실이라면 벤더 페이지를요.

Google 자체 가이드도 콘텐츠가 경험·전문성·권위성·신뢰성을 보여줘야 한다고 말해요. 유용하고 사람 우선인 콘텐츠에 관한 Google 검색 기본 사항을 참고하세요(2026년 08월 접속). AI 초안에는 기본적으로 그중 아무것도 없어요. 여기서 여러분이 주입하거나, 아니면 글은 평범한 채로 남아요.

6단계—발행하고 추적하기

마지막 단계는 여러분의 스택에 달렸어요. 저는 Markdown이나 HTML로 쓰니, 발행은 CMS로의 푸시예요—제 경우엔 Strapi지만, 같은 파일 기반 흐름은 WordPress(임포터 경유)나 정적 사이트에도 잘 맞아요. 그다음은요.

• 검색 엔진에 제출하거나, 사이트맵이 핑을 보내게 해요.
• 나중에 글을 측정할 수 있게, 노린 키워드와 발행일을 기록해요.
• 2~4주 뒤에 순위와 AI Overview 노출 여부를 확인하고, 배운 걸 다음 브리프에 반영해요.

이 루프 전체를, 즉흥적인 프롬프트가 아니라 정의된 단계—브리프, 초안, 리뷰—로 이뤄진 에이전트 주도의 반복 가능한 프로세스로 돌리고 싶다면, 그 패턴을 AgentKit로 하는 AI 개발 워크플로우 가이드에서 자세히 풀어놨어요. 코드에서 통하는 '브레인스토밍→계획→구축→출하'의 리듬은 콘텐츠에서도 통해요.

더 빠르게—AgentKit의 바로 쓰는 SEO+카피라이팅 skill

위의 모든 건 직접 만든 skill로도 돼요. 문제는 그걸 제대로 만드는—브리프 형식, 슬롭 방지 규칙, 온페이지 점검, 스키마 계획—데 실제로 시간과 시행착오가 든다는 거예요. 이 조립을 건너뛰고 싶다면, 바로 여기서 관리되는 키트가 값을 해요.

AgentKit은 이 글의 것과 같은 파이프라인이 미리 연결된 seo skill과 ak-copywriting skill(Marketing 키트의 일부)을 함께 제공해요—섹션별 글자 수가 있는 콘텐츠 브리프, 경쟁사 스코어링, 키워드 배치 가이드, 그리고 전환 카피 공식까지요. 세팅은 ak CLI로 5분이 채 안 걸리고, skill은 평생 업데이트를 받아서 도구가 바뀌어도 워크플로우가 발맞춰 가요. 무료 GitHub 스크립트 하나와, 늘 최신을 유지하는 관리되는 한 쌍의 차이가 여기 있어요.

세팅 없이 파이프라인만 갖고 싶다면? Marketing 키트(seo+ak-copywriting skill 포함)는 99달러이고, 사이트에는 키트의 반복 요금이 적혀 있지 않아요. Engineer+Marketing 번들은 149달러예요. 환불 보장도 있어요(사이트가 고정된 기간을 명시하진 않아요). 전체 그림은 제 AgentKit 완전 리뷰를 읽거나 AgentKit 가격 보기(링크로 20% 할인)에서 확인하고, 사기 전에 실시간 숫자를 다시 점검하세요.

무엇에 돈을 내는지 분명히 해둘게요. 이 skill들이 5단계를 없애주지는 않아요. 팩트체크와 경험 더하기는 여전히 여러분 몫이에요. 없애주는 건 1~4단계의 세팅, 즉 번거로운 부분이에요.

실제 사례—글 한 편, 처음부터 끝까지

추상적으로 설명하기보다, 실제 글로 파이프라인을 보여드릴게요. 위의 여섯 단계를 그대로 써서 내부 링크에 관한 가이드를 썼어요.

1~2단계(리서치+브리프): 경쟁사 URL 다섯 개를 넣었어요. 갭 분석이 짚어낸 건, 상위 페이지들은 하나같이 내부 링크가 무엇인지는 설명하지만, 기존 사이트를 대상으로 한 반복 가능한 감사를 보여주는 곳은 하나도 없다는 점이었어요. 그게 제 각도가 됐고, 브리프는 그걸 중심으로 아웃라인을 짰어요.

3단계(초안): 슬롭 방지 프롬프트로 돌리니, 첫 초안은 지어내길 거부한 통계에 마커 세 개, 그리고 스크린샷이 들어갈 자리에 마커 두 개를 달고 돌아왔어요. 그 거부가 바로 여러분이 원해야 할 행동이에요—자기 사각지대에 대해 정직한 거죠.

4단계(온페이지): 처음 메타 타이틀은 63자로 돌아왔어요. 글자 수를 출력해달라고 해뒀던 덕에 초과가 한눈에 보였고, 잘린 스니펫으로 몇 주 뒤에야 알아채는 대신 한 번의 편집으로 55자로 다듬었어요.

5단계(정직한 부분): 여기에 가장 많은 시간을 썼어요. 초안의 '왜 내부 링크가 중요한가' 섹션은 기술적으로는 맞지만 평범했어요—그야말로 교과서였죠. 저는 어떤 모델도 알 수 없는, 제가 저질렀던 구체적인 실수(사이트 마이그레이션 후 고아가 된 페이지)를 넣어 다시 썼어요. 또 모델이 채워 넣은, 아무것도 더하지 않는 서브섹션 하나를 통째로 잘랐어요. 완성된 글의 대략 40%가 사람의 편집이었어요. 그게 정상이에요. AI 콘텐츠가 95% 완성 상태로 나온다고 말하는 사람은 뭔가를 팔고 있는 거예요.

결과: 완전히 수작업으로 했다면 걸렸을 시간의 대략 3분의 1 만에 발행 가능한 글이 나왔어요. 게다가 마지막 단계를 사람이 붙들고 있어서 품질 게이트도 그대로였고요. 이 같은 루프를 이미 조립된 skill로 돌리고 싶다면, 바로 쓰는 워크플로우를 시도하고 브리프를 여러분의 보이스에 맞게 조정해보세요.

베스트 프랙티스—자동화 vs 사람이 지키기

여기서 가장 쓸모 있는 사고 모델은, 에이전트가 잘하는 것과 반드시 여러분에게 남겨야 하는 것 사이에 분명한 선을 긋는 거예요. 그 선을 넘으면 품질이 빠르게 떨어져요.

경험칙은 이래요. 기계적이고 반복적인 건 자동화하고, 판단과 경험은 여러분이 지켜요. 작가로서 여러분이 더하는 가치는 바로 오른쪽 열 그 자체예요—그러니 그걸 지키세요.

솔직한 한계

좋은 면만 파는 가이드라면 의심하세요. 실제로 무엇이 잘못되는지 짚어볼게요.

• 실시간 SERP 접근 불가. Claude Code는 현재 검색 결과를 볼 수 없어요. 경쟁사에 대해 '아는' 모든 건 여러분이 넣어준 거예요. 낡거나 빈약한 입력은 곧 약한 브리프예요.
• 환각으로 지어낸 통계와 인용. 엄격한 프롬프트가 없으면 자신만만하게 통계나 연구를 지어내요. 슬롭 방지 규칙이 이걸 줄이지만, 없애지는 않아요. 모든 숫자를 검증해야 해요.
• 기본값은 슬롭. 기본 초안은 평범한 쪽으로 흘러요. 좋은 출력은 모델 하나가 아니라, 좋은 프롬프트와 강한 CLAUDE.md의 함수예요.
• 비용과 한도. 긴 글 세션은 요금제 사용량이나 API 토큰을 소모해요. 콘텐츠를 많이 만드는 팀은 Max 요금제를 예산에 넣거나 API 지출을 지켜봐야 해요(Opus와 Sonnet은 100만 토큰당 과금돼요).
• 검증 시간은 진짜예요. 이 파이프라인이 빠르게 하는 건 초안 작성이지 팩트체크가 아니에요. 5단계는 압축되지 않아요. 오히려 그걸 제대로 하는 게, AI를 쓰는 것에 대한 정직한 '세금'이에요.

그렇다고 이 도구가 나쁜 선택이 되는 건 아니에요. 그냥 도구라는 뜻이에요—실력 있는 사용자에게는 보답하고, 게으른 사용자에게는 벌을 주는 도구요.

자주 묻는 질문 (FAQ)

Claude Code가 정말로 SEO 콘텐츠를 쓸 수 있나요?

네, 파일 기반 파이프라인으로 구동하면요. 키워드를 리서치하고, 브리프를 생성하고, 슬롭 방지 규칙으로 초안을 잡고, 온페이지 최적화를 돌린 다음, 사람이 편집해요. 리서치 종합, 초안, 온페이지 기계 작업은 잘해요. 팩트체크나 실제 경험은 대신할 수 없어서, 마지막 단계는 여전히 사람이 가져요.

AI가 쓴 콘텐츠는 Google 가이드라인에 어긋나나요?

아니요. Google의 가이드가 겨냥하는 건, 어떻게 만들어졌든 상관없이 저품질에 도움이 안 되는 콘텐츠지 AI 사용 자체가 아니에요. 진짜 경험·전문성·정확성을 보여주는 콘텐츠는 AI가 쓰기를 도왔든 아니든 상위에 오를 수 있어요. 사람의 편집과 팩트체크 단계가 바로 그 선의 옳은 쪽에 콘텐츠를 붙들어줘요.

유료 요금제나 유료 키트가 필요한가요?

Claude 요금제는 필요해요(제한된 무료 등급이 있고, 정기적으로 쓴다면 월 20달러 Pro가 편해요). 유료 키트는 선택이에요—SEO와 카피라이팅 skill은 직접 무료로 만들 수 있어요. AgentKit 같은 키트는 그 skill들을 미리 연결해 제공함으로써 세팅 시간을 아껴줄 뿐이에요.

SEO 콘텐츠에서 Claude Code vs ChatGPT—뭐가 더 나을까요?

ChatGPT(채팅 창)는 일회성 한 문단이라면 더 빨라요. Claude Code는 반복 가능한 파일 기반 제작에서 이겨요. 여러분의 실제 콘텐츠 파일을 읽고 쓰고, 명령을 실행하고, 재사용 가능한 skill로 구동할 수 있으니까요—그래서 같은 품질 기준이 눈앞의 한 편만이 아니라 모든 글에 적용돼요.

이 가이드는 어느 AgentKit를 쓰나요?

AgentKit for Claude Code(agentkit.best, CLI는 ak)로, seo와 ak-copywriting skill을 함께 제공해요. 이건 OpenAI의 AgentKit(Agent Builder와 ChatKit)이 아니에요. 그건 2025년 10월에 출시된, 무관한 에이전트 구축 플랫폼이에요.

WordPress나 Strapi에 바로 발행할 수 있나요?

이 워크플로우는 Markdown이나 HTML 파일을 만들어내는데, 정적 사이트나 Strapi에 그대로 들어가고, WordPress에는 임포터나 REST API를 통해 들어가요. Claude Code가 기본적으로 CMS에 자동으로 푸시하진 않지만, 출력이 평범한 파일이라 발행 단계는 간단한 푸시나 임포트예요.

마무리와 다음 단계

이 방법 전체는 하나의 루프에 담겨요. 키워드를 리서치하고, 브리프를 생성하고, 슬롭 방지 규칙으로 초안을 잡고, 온페이지를 최적화하고, 사람이 편집하고 팩트체크한 다음, 발행하고 추적하는 거예요. 마법은 모델에 있지 않아요—콘텐츠를 파일로 다루고, 마지막 단계를 사람의 몫으로 남기는 데 있어요. skill을 직접 만들든, 관리되는 키트로 세팅을 건너뛰든, 중요한 곳에 시간을 쓰세요.

처음이신가요? 먼저 Claude Code가 무엇인지부터 시작하고, 그다음 AgentKit 리뷰 전체와 AI 개발 워크플로우 가이드를 읽고 이걸 반복 가능한 시스템으로 돌려보세요.