실측 · 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

한 번만 설정: 전역 설정을 AICodeWith로
한 번만 하면 모든 사례에서 재사용합니다. 다른 도구: 연동 가이드. 키 받는 곳: API 키 받기.
1. Claude Code 설치
Claude Code 공식 설치 문서를 따르세요.
claude --version이 버전 번호를 출력하면 끝입니다.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. seo-audit 스킬 설치
로컬에 Node.js가 필요합니다. 터미널에서 실행하세요:
bashnpx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit -g -a claude-code설치 후
~/.claude/skills/seo-audit/아래에 SKILL.md가 보여야 합니다. 스킬은 당신 권한으로 돌아갑니다. 원하면 먼저 SKILL.md를 훑어보세요.
실측 단계
1. 한 문장으로 감사 요청
확인할 페이지로
<url>을 바꾸고 아무 폴더에서나 실행하세요:textclaude -p 'seo-audit 스킬로 <url>을 확인해. title, meta description, 색인(robots, canonical, sitemap), 구조화 데이터, 성능을 봐. 한국어 감사 보고서와 우선순위 수정 목록을 seo-report.md에 써.'실측에서 한 페이지는 약 7.5분, 대부분 로컬 Lighthouse입니다. 기다리세요. 터미널에 auto 모드와 api.aicodewith.ai에 대한 영어 안내가 나올 수 있습니다. 무시해도 됩니다.
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 감사” 원클릭 도구를 검토 중이며 준비되면 메일로 알려 드립니다.