실측 · 2026-10-16

AI 웹사이트 SEO 감사: 프롬프트 하나, 우선순위 보고서

Claude Code에 seo-audit 스킬을 설치하고 URL을 주면 제목, 색인, 구조화 데이터, 성능을 확인한 뒤 수정 목록을 씁니다. seo-audit은 오픈소스 GitHub 스킬(coreyhaines31/marketingskills, MIT)입니다. 명령 하나로 설치됩니다. 이 사이트의 한 페이지에서 실측: 약 7.5분, 131줄 보고서.

  • ✓스킬 설치 6초. 한 페이지 감사는 약 7.5분(448초), 로컬 Lighthouse 실행 포함(2026-10-16)
  • ✓제목, 메타 설명, 색인, 구조화 데이터, 성능을 다루는 131줄 보고서. 수정 14건은 P0–P3 순
  • ✓우리 페이지에서 실제 이슈를 잡음: sitemap 404, 없는 영어 URL을 가리키는 hreflang, 공유 이미지 없음, 느린 모바일 LCP
AI 웹사이트 SEO 감사 터미널: seo-audit 설치와 보고서 작성
실측 터미널 출력: 먼저 고칠 것, 통과한 것, 확인하지 못한 것. 보고서는 131줄.

한 번만 설정: 전역 설정을 AICodeWith로

한 번만 하면 모든 사례에서 재사용합니다. 다른 도구: 연동 가이드. 키 받는 곳: API 키 받기.

  1. 1. Claude Code 설치

    Claude Code 공식 설치 문서를 따르세요. claude --version이 버전 번호를 출력하면 끝입니다.

  2. 2. 키를 만들고 전역 설정을 수정

    로그인한 뒤 대시보드 **API 키** 페이지를 열고 키를 만드세요. 어디인지 모르겠다면 API 키 받기를 보세요.

    전역 설정 ~/.claude/settings.json을 열고 env 아래에 Base URL과 키를 넣으세요:

    ~/.claude/settings.json
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
        "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_KEY"
      }
    }
    
    Base URL 끝에 /v1을 붙이지 마세요. 터미널을 다시 열고 claude를 실행해 정상 답변이 오면 연결된 것입니다.
  3. 3. seo-audit 스킬 설치

    로컬에 Node.js가 필요합니다. 터미널에서 실행하세요:

    bash
    npx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit -g -a claude-code
    
    설치 후 ~/.claude/skills/seo-audit/ 아래에 SKILL.md가 보여야 합니다. 스킬은 당신 권한으로 돌아갑니다. 원하면 먼저 SKILL.md를 훑어보세요.

실측 단계

  1. 1. 한 문장으로 감사 요청

    확인할 페이지로 <url>을 바꾸고 아무 폴더에서나 실행하세요:

    text
    claude -p 'seo-audit 스킬로 <url>을 확인해. title, meta description, 색인(robots, canonical, sitemap), 구조화 데이터, 성능을 봐. 한국어 감사 보고서와 우선순위 수정 목록을 seo-report.md에 써.'
    
    실측에서 한 페이지는 약 7.5분, 대부분 로컬 Lighthouse입니다. 기다리세요. 터미널에 auto 모드와 api.aicodewith.ai에 대한 영어 안내가 나올 수 있습니다. 무시해도 됩니다.
  2. 2. 항목을 순서대로 고치기

    seo-report.md를 여세요. P0(색인을 막음)부터, 그다음 P1(순위와 클릭), 그다음 P2와 P3. 고친 뒤 같은 명령을 다시 실행하세요.

    보고서는 확인하지 못한 항목도 적습니다. 실측에서 PageSpeed Insights 할당이 끝나 로컬 Lighthouse 데이터만 썼습니다. Search Console이 없으면 색인과 순위를 볼 수 없습니다.

    스킬은 HTML만 가져오면 JS로 주입된 구조화 데이터를 놓칠 수 있다고 적습니다. 그 항목은 Google 리치 결과 테스트로 확인하세요.

문제 해결

npx: command not found
Node.js(npm과 npx 포함)를 설치한 뒤 설치 명령을 다시 실행하세요.
401 또는 요청 실패
키가 완전한지, Base URL이 https://api.aicodewith.ai(/v1 없음)인지 확인하세요. 바꾼 뒤 터미널을 다시 여세요.

FAQ

Search Console 접근이 필요한가요?

아니요. 공개 페이지를 가져옵니다. Search Console 데이터가 없으면 색인과 순위를 볼 수 없고, 보고서가 그렇게 말합니다.

감사 하나에 얼마나 걸리나요?

실측에서 페이지당 약 7.5분, 대부분 로컬 Lighthouse입니다.

전문 SEO 도구를 대체하나요?

빠른 이슈 목록입니다. 순위와 백링크는 보이지 않는 서드파티 데이터가 필요합니다.

이 스킬은 누가 만들었나요?

seo-audit은 MIT GitHub 저장소 coreyhaines31/marketingskills에서 왔습니다. 우리가 만든 것이 아닙니다.

원클릭 버전이 필요하면 이메일을 남겨 주세요

직접 환경을 맞추고 싶지 않으신가요? “웹사이트 SEO 감사” 원클릭 도구를 검토 중이며 준비되면 메일로 알려 드립니다.