SEO 스킬 — 정적 사이트 최적화
정적 HTML 사이트(GitHub Pages, Netlify, Vercel 등)를 위한 간단한 SEO 감사 및 수정 도구입니다. 빌드 도구가 필요하지 않습니다. HTML을 읽고, 누락된 부분을 보고한 후 추가합니다.
설정
처음 사용하기 전에 Claude에게 사이트 정보를 알려주어 올바른 값을 입력할 수 있도록 합니다:
- 도메인 (예:
https://yourname.com) - 페이지 (예: index, about, resume, projects/foo)
- 소셜 프로필 (LinkedIn, GitHub, Twitter 등)
- 순위를 원하는 검색어 (예: "jane doe software engineer", "jane doe portfolio")
Claude는 이 컨텍스트를 세션 동안 저장합니다. 한 번만 말하면 됩니다.
호출 시 수행할 작업
사이트 소스 디렉터리의 모든 HTML 파일을 읽습니다. 아래 각 항목을 확인합니다. 통과/실패 테이블을 보고한 후, 누락된 항목을 수정하겠다고 제안합니다.
1. 페이지별 <head> 필수 요소
모든 HTML 페이지는 <head> 안에 다음을 포함해야 합니다:
<title>[페이지 제목] — [이름]</title>
<meta name="description" content="[고유한 150-160자, 타겟 키워드 포함]">
<link rel="canonical" href="https://yourdomain.com/[경로]/">
<!-- Open Graph -->
<meta property="og:title" content="[제목과 동일하거나 더 짧게]">
<meta property="og:description" content="[메타 설명과 동일]">
<meta property="og:image" content="https://yourdomain.com/[이미지 경로]">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:url" content="https://yourdomain.com/[경로]/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="[이름]">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="[og:title과 동일]">
<meta name="twitter:description" content="[og:description과 동일]">
<meta name="twitter:image" content="https://yourdomain.com/[이미지 경로]">
가이드라인:
- 제목: 50-60자. 이름 + 차별화 요소.
- 메타 설명: 150-160자, 페이지마다 고유, 이름과 관련 키워드 포함.
- OG 이미지: 1200x630px 권장. 페이지마다 맞춤 이미지가 없으면 공유 이미지를 사용하세요. 사이트의 실제 이미지를 사용하고, 플레이스홀더는 사용하지 마세요.
- 표준 URL: 실제 배포된 URL과 정확히 일치해야 합니다 (트레일링 슬래시 일관성).
2. 구조화된 데이터 (JSON-LD)
홈페이지에 Person + WebSite 스키마를 추가하세요:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Person",
"name": "[이름]",
"url": "https://yourdomain.com",
"jobTitle": "[직함/역할]",
"affiliation": {
"@type": "Organization",
"name": "[학교 또는 회사]"
},
"sameAs": [
"[GitHub URL]",
"[LinkedIn URL]"
],
"knowsAbout": ["[기술1]", "[기술2]", "[기술3]"]
}
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "[이름] — [포트폴리오 태그라인]",
"url": "https://yourdomain.com"
}
</script>
프로젝트 페이지의 경우 CreativeWork를 사용하세요:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "CreativeWork",
"name": "[프로젝트 이름]",
"author": { "@type": "Person", "name": "[이름]" },
"description": "[간단한 프로젝트 설명]",
"url": "https://yourdomain.com/[프로젝트]/"
}
</script>
규칙: JSON-LD만 사용 (Microdata/RDFa는 사용하지 않음). FAQPage는 사용하지 않음 (정부/의료 분야로 제한됨). HowTo는 사용하지 않음 (비권장됨). 스키마 필드에 플레이스홀더 텍스트를 사용하지 않음.
3. robots.txt
사이트 루트에 생성:
User-agent: *
Allow: /
Sitemap: https://yourdomain.com/sitemap.xml
4. sitemap.xml
사이트 루트에 생성:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://yourdomain.com/</loc>
<lastmod>[YYYY-MM-DD]</lastmod>
<priority>1.0</priority>
</url>
<!-- 각 페이지에 대해 반복 -->
</urlset>
lastmod는 실제 마지막 수정 날짜로 설정합니다. 페이지가 변경되면 사이트맵을 업데이트합니다.
5. 이미지 SEO
- 모든
<img>태그에는 설명적인alt텍스트가 필요합니다 ("image1" 또는 "screenshot"이 아닌) - 가능하면 WebP를 사용하고, 이미지 크기는 200KB 미만으로 유지합니다
- 화면 하단 이미지에
loading="lazy"를 추가합니다 - OG 이미지는 실제 파일이어야 하며, 플레이스홀더가 아니어야 합니다
6. 콘텐츠 및 키워드 신호
- H1 태그: 페이지당 하나, 이름 또는 프로젝트 이름 + 키워드 포함
- 제목 계층 구조: h1 > h2 > h3 순서, 단계 생략 금지
- 본문 내 이름: 모든 페이지에 이름이 자연스럽게 나타나야 함
- 내부 링크: 페이지들이 서로 연결되어야 함 (홈페이지 → 프로젝트, 소개 → 프로젝트 등)
- 외부 링크: 소개/홈페이지에서 소셜 프로필 연결
7. 기술적 확인 사항
- HTTPS: 모든 내부 링크와 리소스가
https://를 사용하는지 확인 - 트레일링 슬래시 일관성: 하나의 패턴을 선택하고 모든 링크, 표준 URL, 사이트맵에서 일관되게 유지
- 깨진 링크 없음: 모든
href및src속성이 제대로 연결되는지 확인 - 모바일 반응형: 모든 페이지에 뷰포트 메타 태그가 있는지 확인
- 페이지 속도: 중요하지 않은 스크립트는 지연 로드. 정적 사이트의 경우 최소한의 JS가 좋은 기준입니다.
8. 배포 후 확인
배포 후:
/robots.txt및/sitemap.xml에 직접 접속하여 접근 가능한지 확인- Discord/Slack/Twitter에서 링크를 공유하여 미리보기 카드로 OG 태그 테스트
- Google Search Console에 사이트맵 제출
- 며칠 후
site:yourdomain.com검색으로 색인 확인 - 타겟 검색어로 검색하고 시간에 따른 순위 추적
9. Google Search Console 설정
- Google Search Console로 이동, 도메인에 대한 속성 추가
- DNS TXT 레코드 또는 HTML 파일 방식으로 확인
- 사이트맵 URL 제출
- Coverage 보고서에서 색인 문제 모니터링
빠른 감사 출력
감사를 실행할 때 모든 HTML 파일을 읽고 다음을 출력합니다:
| 확인 항목 | 상태 | 비고 |
|---|---|---|
| 메타 설명 | ... | ... |
| OG 태그 | ... | ... |
| JSON-LD 스키마 | ... | ... |
| robots.txt | ... | ... |
| sitemap.xml | ... | ... |
| 이미지 alt 텍스트 | ... | ... |
| H1 태그 | ... | ... |
| 내부 링크 | ... | ... |
| 표준 URL | ... | ... |
그런 다음 누락된 항목을 수정하겠다고 제안합니다.