메타데이터 수정
정확하고 완전한 메타데이터를 제공합니다.
사용 방법
-
/fixing-metadata이 대화에서 모든 메타데이터 작업에 다음 제약 조건을 적용합니다. -
/fixing-metadata <파일>아래 모든 규칙에 따라 파일을 검토하고 다음을 보고합니다:- 위반 사항 (정확한 줄 또는 코드 조각 인용)
- 왜 중요한지 (짧은 문장 하나)
- 구체적인 수정 사항 (코드 수준 제안)
명시적으로 요청하지 않는 한 새로운 프레임워크나 SEO 라이브러리를 도입하지 마십시오. 최소한의 차이(diff)를 선호합니다.
적용 시점
다음 상황에서 이 지침을 참조하세요:
- 페이지 제목, 설명, 표준 URL, 로봇 태그를 추가하거나 변경할 때
- Open Graph 또는 Twitter 카드 메타데이터를 구현할 때
- 파비콘, 앱 아이콘, 매니페스트, 테마 색상을 설정할 때
- 공유 SEO 컴포넌트 또는 레이아웃 메타데이터 기본값을 구축할 때
- 구조화된 데이터(JSON-LD)를 추가할 때
- 로케일, 대체 언어 또는 표준 라우팅을 변경할 때
- 새 페이지, 마케팅 페이지 또는 공유 가능한 링크를 제공할 때
우선순위별 규칙 카테고리
| 우선순위 | 카테고리 | 영향 |
|---|---|---|
| 1 | 정확성 및 중복 | 치명적 |
| 2 | 제목 및 설명 | 높음 |
| 3 | 표준 URL 및 색인 생성 | 높음 |
| 4 | 소셜 카드 | 높음 |
| 5 | 아이콘 및 매니페스트 | 중간 |
| 6 | 구조화된 데이터 | 중간 |
| 7 | 로케일 및 대체 | 낮음-중간 |
| 8 | 도구 경계 | 치명적 |
빠른 참조
1. 정확성 및 중복 (치명적)
- 페이지당 하나의 위치에 메타데이터를 정의하고, 경쟁 시스템을 피하십시오.
- 중복된 title, description, canonical 또는 robots 태그를 내보내지 마십시오.
- 메타데이터는 결정적이어야 하며, 무작위 또는 불안정한 값을 사용하지 마십시오.
- 사용자 생성 또는 동적 문자열은 이스케이프 및 정화 처리하십시오.
- 모든 페이지는 제목과 설명에 안전한 기본값을 가져야 합니다.
2. 제목 및 설명 (높음)
- 모든 페이지에는 제목이 있어야 합니다.
- 사이트 전체에서 일관된 제목 형식을 사용하십시오.
- 제목을 짧고 읽기 쉽게 유지하고, 키워드를 채우지 마십시오.
- 공유 가능하거나 검색 가능한 페이지에는 메타 설명이 있어야 합니다.
- 설명은 일반 텍스트여야 하며, 마크다운이나 인용 spam을 사용하지 마십시오.
3. 표준 URL 및 색인 생성 (높음)
- 표준 URL은 페이지의 선호 URL을 가리켜야 합니다.
- 비공개, 중복 또는 공개되지 않은 페이지에만 noindex를 사용하십시오.
- robots 메타는 실제 접근 의도와 일치해야 합니다.
- 미리보기 또는 스테이징 페이지는 가능한 경우 기본적으로 noindex여야 합니다.
- 페이지 매김된 페이지는 올바른 표준 URL 동작을 가져야 합니다.
4. 소셜 카드 (높음)
- 공유 가능한 페이지는 Open Graph 제목, 설명 및 이미지를 설정해야 합니다.
- Open Graph 및 Twitter 이미지는 절대 URL을 사용해야 합니다.
- 올바른 이미지 크기와 안정적인 종횡비를 선호합니다.
- og:url은 표준 URL과 일치해야 합니다.
- 적절한 og:type을 사용하십시오. 일반적으로 website 또는 article입니다.
- twitter:card를 적절히 설정하고, 기본값은 summary_large_image입니다.
5. 아이콘 및 매니페스트 (중간)
- 브라우저 간 호환되는 파비콘을 하나 이상 포함하십시오.
- 관련이 있는 경우 apple-touch-icon을 포함하십시오.
- 매니페스트는 유효해야 하며, 사용 시 참조되어야 합니다.
- 의도적으로 theme-color를 설정하여 UI 크롬 불일치를 방지하십시오.
- 아이콘 경로는 안정적이고 캐시 가능해야 합니다.
6. 구조화된 데이터 (중간)
- 실제 페이지 콘텐츠에 명확하게 매핑되지 않으면 JSON-LD를 추가하지 마십시오.
- JSON-LD는 유효해야 하며 실제로 렌더링된 내용을 반영해야 합니다.
- 평점, 리뷰, 가격 또는 조직 세부 정보를 임의로 만들지 마십시오.
- 필수가 아닌 한 페이지당 하나의 구조화된 데이터 블록을 선호합니다.
7. 로케일 및 대체 (낮음-중간)
- html lang 속성을 올바르게 설정하십시오.
- 지역화가 존재하는 경우 og:locale을 설정하십시오.
- 페이지가 실제로 존재하는 경우에만 hreflang 대체를 추가하십시오.
- 지역화된 페이지는 로케일별로 올바르게 표준화되어야 합니다.
8. 도구 경계 (치명적)
- 최소한의 변경을 선호하고, 관련 없는 코드를 리팩터링하지 마십시오.
- 요청되지 않은 경우 프레임워크 또는 SEO 라이브러리를 마이그레이션하지 마십시오.
- 프로젝트의 기존 메타데이터 패턴(Next.js metadata API, react-helmet, 수동 head 등)을 따르십시오.
검토 지침
- 먼저 치명적인 문제(중복, 표준 URL, 색인 생성)를 수정하십시오.
- title, description, canonical 및 og:url이 일치하는지 확인하십시오.
- 로컬호스트가 아닌 실제 URL에서 소셜 카드를 확인하십시오.
- 영리하거나 동적인 메타데이터보다 안정적이고 지루한 메타데이터를 선호하십시오.
- 차이(diff)를 최소화하고 메타데이터로만 범위를 제한하십시오.