Communitygithub.com

개인 웹사이트: 이름 검색으로 찾게 만드는 SEO

정적 포트폴리오와 개인 사이트를 위한 가벼운 Claude Code SEO 스킬. meta 태그, Open Graph, Twitter 카드, JSON-LD, robots.txt, sitemap, 이미지, 제목 구조, 링크를 9개 항목으로 감사하고 모든 수정을 HTML에 직접 반영합니다.

개인 웹사이트: 이름 검색으로 찾게 만드는 SEO란 무엇인가요?

'개인 웹사이트' 레시피 3단계(검색되게), 출처는 aevans-eng/seo-skill. /seo를 입력하거나 '내 이름을 검색해도 사이트가 안 나오는 이유'를 묻기만 하면 됩니다. 에이전트는 GitHub Pages, Netlify, Vercel에 올린 HTML을 읽고 9개 항목을 감사합니다: title·description·canonical, Open Graph와 Twitter Card, 홈의 Person·WebSite JSON-LD와 프로젝트 페이지의 CreativeWork, robots.txt와 sitemap.xml, 이미지 alt·지연 로딩·용량, 페이지당 H1 하나·제목 계층·내부 링크, HTTPS와 깨진 링크, 배포 후 Search Console 절차. 통과/실패 표를 보여주고 전부 추가해 주겠다고 제안하며, 공유 카드에는 사이트에 있는 이미지를 그대로 씁니다. 빌드 도구도 API 호출도 없습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add aevans-eng/seo-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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. 배포 후 확인

배포 후:

  1. /robots.txt 및 /sitemap.xml에 직접 접속하여 접근 가능한지 확인
  2. Discord/Slack/Twitter에서 링크를 공유하여 미리보기 카드로 OG 태그 테스트
  3. Google Search Console에 사이트맵 제출
  4. 며칠 후 site:yourdomain.com 검색으로 색인 확인
  5. 타겟 검색어로 검색하고 시간에 따른 순위 추적

9. Google Search Console 설정

  1. Google Search Console로 이동, 도메인에 대한 속성 추가
  2. DNS TXT 레코드 또는 HTML 파일 방식으로 확인
  3. 사이트맵 URL 제출
  4. Coverage 보고서에서 색인 문제 모니터링

빠른 감사 출력

감사를 실행할 때 모든 HTML 파일을 읽고 다음을 출력합니다:

확인 항목상태비고
메타 설명......
OG 태그......
JSON-LD 스키마......
robots.txt......
sitemap.xml......
이미지 alt 텍스트......
H1 태그......
내부 링크......
표준 URL......

그런 다음 누락된 항목을 수정하겠다고 제안합니다.

관련 스킬