Cism-Ch/aioseo-verification

AIOSEO 검증 및 콘텐츠 생성 가이드

이 가이드는 WordPress 제품 페이지에 대한 작성 기준을 정의하며, AIOSEO의 TruSEO 알고리즘과 Big Tech 전환 원칙에 부합합니다.

---

📋 AIOSEO (TruSEO) 검증 체크리스트

1. 제목 및 메타 분석

• SEO 제목 길이: 50~60자 사이. 주요 키워드는 반드시 앞쪽에 위치.
• 메타 설명 길이: 155~160자 사이. USP(Unique Selling Proposition)와 CTA(Call to Action)를 포함해야 함.

2. 콘텐츠 구조 (템플릿 준수)

• 콘텐츠 길이: 긴 설명은 최소 500단어(표시되는 텍스트 기준, 안전 마진, 엄격 기준 450단어).
• 소제목 분포: 각 블록마다 하나의 제목(H2)이 있어야 함.
• 짧은 설명 태그: <em> 태그를 사용한 이탤릭체 결론을 포함해야 함.
• HTML 위생: 짧은 설명에서 <div>나 사용자 정의 CSS 스타일을 사용하지 않음(WordPress SEO).
• 내부 링크: 액세서리나 상위 카테고리로의 링크를 최소 1개 포함.
• 외부 링크: 권위 있는 출처(예: 제조사 페이지)나 독립적인 리뷰로의 링크를 최소 1개 포함.
• 이미지/비디오: 키워드를 포함한 설명적인 alt 속성을 가진 미디어 존재.

3. 가독성 (TruSEO 요소)

• 단락 단어 수 (중요 - 차단):
  • 계산 참고: 표시되는 텍스트만 계산(HTML 태그 제외). validate_html_template.py 스크립트가 단어 수 계산의 권위를 가집니다. 또는 AI 에이전트가 자체 감사 시 이 카운팅을 수행합니다.
  • 도입부 단락: ≤ 100단어(제품의 사실적 소개)
  • 기타 모든 단락: 단락당 ≤ 60단어(사양 표 길이에 따라 45-60단어로 유연하게 조정)
  • "간략 사양" 섹션: H2 + 표는 총 약 50-60단어 추가
  • 전체 긴 설명: 500-650단어 (최소 500단어 안전 목표 - 엄격 - 450 미만 또는 650 초과 금지)
  • 계산 확인: H2 "사양"과 표 내용을 포함한 모든 표시 텍스트 계산(태그 제외)
• 단락 길이: 어떤 단락도 60단어를 초과하지 않음(도입부 최대 100). 표에 따라 조정.
• 문장 길이 (중요 — 차단): 문장의 최대 **25%**만 20단어를 초과할 수 있음(목표: ≤20%). 12-18단어 문장을 선호. AI 작성자는 18단어에 도달하는 모든 문장을 마침표로 체계적으로 분할합니다.
• 문장 구조 (주의): 복잡한 기술 설명은 과도한 쉼표 대신 두 개의 별도 문장으로 나누어야 함.
• 수동태: 수동태 문장은 최대 10%. 능동태 선호(예: "프로세서가 성능을 높인다" 대신 "성능이 프로세서에 의해 높아진다").
• 전환어 (단락이 아닌 문장 기준): 최소 30%의 문장에 전환어가 포함되어야 함(최적 영역 30-70%). AIOSEO는 문장 어디서든 전환어를 찾습니다(시작 부분만 아님). 과도한 스타일을 피하기 위해 단락 시작 부분의 전환어는 최대 4/7로 제한. audit_aioseo_sentences.py로 검증.
• 연속 문장: 같은 단어로 세 문장을 연속해서 시작하지 않음.
• Flesch Reading Ease: 목표 점수 60-70 ("표준" 가독성).

4. 문법 품질 및 톤 (중요)

• 표준 문법: 올바른 표준 프랑스어만 사용. 복잡한 구문, 인공적인 문장 구조 또는 "로봇" 어조 금지.
• 관사 & 한정사: 문법적으로 올바른 문장을 위해 명사 앞에 항상 올바른 관사(le, la, les, un, une, des)를 사용.
• 자연스러운 흐름: 텍스트는 자연스럽게 읽혀야 함. 문장 구조 반복(예: "그것은...을 갖추고 있습니다. 그것은...을 소유합니다. 그것은...을 장착하고 있습니다.")을 피하세요.
• 과도한 설명 금지: 지나치게 서술적이거나 화려한 언어를 피함. 명확성과 간결성을 우선시.
• 사실적 톤: 전문 제품 사양(삼성/애플 스타일)에서 영감을 받은 직접적이고 사실적인 어조로 작성.
• 과도한 형용사 금지: 최상급 및 강조 형용사("놀라운", "혁신적인")를 제한. 측정 가능한 사실을 선호.
• 철자 교정: 모든 단어, 특히 기술 용어 및 브랜드 이름의 철자를 확인.
• 시제 일관성: 제품 특징을 설명할 때 현재형을 일관되게 사용.

---

🔝 전환어 목록 (TruSEO 용)

문장의 30-70% 비율을 유지하기 위해 이 용어들을 다양하게 사용하세요(단락 기준 아님). AIOSEO는 문장 어디서든 이 단어들을 찾습니다:

• 추가: 게다가(De plus), 더욱이(En outre), 한편(Par ailleurs), 또한(Également), 게다가(De surcroît), 그리고(et), 뿐만 아니라(Ainsi que).
• 대조/반대: 그러나(Cependant), 하지만(Toutefois), 그럼에도 불구하고(Néanmoins), 반면에(En revanche), 그렇지만(Pourtant), 반면(Alors que), 비록 ~일지라도(Bien que).
• 원인/정당화: 실제로(En effet), 왜냐하면(Car), ~라는 점을 감안하면(Étant donné que), ~이므로(Puisque), ~때문에(Parce que), ~덕분에(Grâce à).
• 결과/결론: 결과적으로(Par conséquent), 따라서(Ainsi), 그래서(C’est pourquoi), 그때부터(Dès lors), 그 결과(En conséquence), 요약하면(En résumé), 결론적으로(En conclusion), 간단히(En bref), 마지막으로(Finalement).
• 시간/순서: 먼저(D’abord), 그 다음에(Ensuite), 마지막으로(Enfin), 그리고 나서(Puis), 첫째(Premiérement), 둘째(Secondairement), 셋째(Toisiémement), 첫 번째로(Dans un premier temps), 두 번째로(Dans un second temps), 마무리하며(Pour finir).
• 예시: 예를 들어(Par exemple), 특히(Notamment), 특히(En particulier), 구체적으로(Spécifiquement), ~처럼(Comme).
• 대안: 이든 이든(Soit... soit), 때로는때로는(Tantôt... Tantôt), 한편으로는 다른 한편으로는(d'un côté de l'autre).

---

🤖 생성 지침 (AIOSEO 프레임워크 - 전문 카피라이팅)

접근법: 전문 기술 작가

시스템은 실제 기술 사양을 기반으로 다양하고 자연스러운 콘텐츠를 작성하는 전문 작가처럼 작동해야 합니다.

전문 작성 방법론

✅ 올바른 접근 예시 - 자연스러운 작성:

사양: {"프로세서": "MediaTek Helio G99", "배터리": "5500mAh", "디스플레이": "AMOLED 120Hz"}
작성: "Redmi Note 14 4G는 6nm 공정으로 제조된 MediaTek Helio G99 프로세서를 탑재하여 멀티태스킹과 가벼운 게임에 균형 잡힌 성능을 제공합니다. 5500mAh 배터리는 집중 사용 시 12시간 이상의 사용 시간을 보장합니다. 120Hz 주사율의 6.67인치 AMOLED 디스플레이는 모든 상호 작용을 더욱 부드럽게 만듭니다."

❌ 잘못된 접근 - 경직된 대체:

경직된 템플릿: "[프로세서]는 [형용사]를 제공합니다."
결과: 반복적이고 부자연스러운 텍스트

AI 에이전트 지침

항상 준수해야 할 엄격한 단어 수 제한:

• 참고: 계산은 표시되는 텍스트에 대해서만 수행됩니다(HTML 태그 제외).
• 도입부 단락: 최대 100단어
• 기타 모든 단락: 단락당 최대 60단어
• 전체 긴 설명: 500-650단어 (생성을 위한 안전 목표; 검증기는 호환성을 위해 450단어부터 패키지를 승인하지만, 500단어를 목표로 하면 거부를 피할 수 있습니다).
• 파일 생성 전에 검증 - 초과 시 체크포인트 실패

2단계(긴 설명) 및 3단계(짧은 설명) 진행 시:

1. 사양 분석

   • specs-[variant].html 파일을 완전히 읽음
   • 주요 특징 및 차별화 요소 식별
   • 정확한 기술 데이터(용량, 모델, 기술) 기록
   • 사양은 일치해야 하며 진짜여야 함

2. 자연스럽게 작성

   • 전문 기술 작가처럼 작성
   • 문장 구조를 다양하게 사용
   • 전환어를 자연스럽게 사용
   • 기술 사양을 접근하기 쉽게 설명
   • 기술적 특징을 실제 이점과 연결

3. 품질 기준

   • 문법: 완벽한 표준 프랑스어
   • 톤: 사실적, 전문적, 삼성/애플 스타일
   • 정확성: 모든 기술 데이터는 사양과 정확히 일치해야 함
   • 명확성: 짧은 문장(≤20단어, 18단어에서 체계적 분할), 간결한 단락
   • 자연스러움: 텍스트는 채워진 양식처럼 읽히지 않고 유창하게 읽혀야 함

4. 해야 할 것

   • ✅ 문장 시작을 다양화
   • ✅ 적절한 동의어 사용
   • ✅ 섹션 간 매끄러운 전환 생성
   • ✅ 필요시 기술 용어 설명
   • ✅ 일관되고 전문적인 톤 유지
   • ✅ 유용하고 정확한 형용사 사용

5. 피해야 할 것

   • ❌ 사양을 지어내거나 숫자를 근사치로 사용
   • ❌ 과도한 마케팅 언어 또는 정당화되지 않은 최상급 사용
   • ❌ 동일한 문장 구조 반복
   • ❌ 장황하거나 복잡하게 작성
   • ❌ 인공적이거나 로봇 같은 어조 사용
   • ❌ 텍스트를 불필요하게 무겁게 만들기 위해 형용사를 과도하게 사용하지 않음

작성 제약 사항(엄격):

1. 길이: 긴 설명은 500-650단어(안전 목표), 짧은 설명 티저는 60단어 미만
2. HTML 구조: 템플릿 구조 따르기(H1, H2, 단락, 목록)
3. TruSEO 가독성:
   • 짧은 문장(≤20단어, 최대 25% 초과 가능)
   • 2-4문장 단락
   • **문장의 30-70%**에 전환어 포함(단락 기준 아님)
   • 능동태 선호
   • 문장 시작 다양화
4. SEO:
   • H1, 첫 번째 단락, 최소 하나의 H2에 초점 키워드 포함
   • SEO 제목(50-60자) 및 메타 설명(155-160자)
5. 스타일: 사실적이고 기술적이지만 접근 가능한 톤, 프리미엄 스타일(삼성/애플)
6. 정확성: 모든 기술 데이터는 사양과 정확히 일치해야 함

---

🛠 빠른 검증 도구

검사 항목	도구 / 방법	목표
길이	wc -w 또는 온라인 카운터	> 450단어
20단어 초과 문장	audit_aioseo_sentences.py	≤ 25%
수동태	텍스트 분석기	< 10%
문장당 전환어	audit_aioseo_sentences.py	30-70%
Flesch 점수	Hemingway App / AIOSEO	60-70

---

📝 최적화된 구조 예시

항상 템플릿을 참고하세요.

🔑 키워드 관리

각 생성 또는 수정 시, 키워드 목록을 HTML 주석 형태로 문서 하단에 첨부해야 합니다. 이를 통해 최종 렌더링에 영향을 주지 않고 밀도와 관련성을 빠르게 확인할 수 있습니다.

추가할 키워드 구조:

1. 초점 키워드: 대상 주요 키워드.
2. LSI 키워드(잠재 의미 색인): 의미적으로 가까운 5~8개 용어(예: 기술적 특성, 동의어).

WordPress에 통합할 때 이 목록을 참조하여 해당 AIOSEO 필드를 채우십시오.