🔗 inbound-links.yml 기본 브랜치 등록 (역방향 내부 링크)

[Kevinlee7250]

무엇을 추가하나

inbound-links.yml 신규 워크플로. 고아 페이지(들어오는 내부 링크가 0개인 글)에 관련 기존 글로부터 링크를 만들어 줍니다.

신규 워크플로는 기본 브랜치에 있어야 schedule·workflow_dispatch가 인식됩니다. 없으면 Actions 목록에 뜨지도 않고 대시보드 버튼은 404가 납니다.

측정 근거

internal_link_audit 첫 실행 결과 (2026-08-21):

발행 글	431건
고아 페이지	175건 (40.6%)
인바운드 평균	2.44 (최대 17)

블로그별 34~44%로 고르고, 최근 고아 50건이 전부 8월 발행분입니다. internal_linker가 새 글 → 기존 글 방향으로만 동작해, 오래된 글은 인바운드가 쌓이지만 새 글은 아무도 가리키지 않는 구조입니다.

⚠️ 기대치를 분명히 해둡니다

같은 측정의 색인 교차표:

고아    / 미색인 : 10건
링크있음 / 미색인 : 10건

인바운드 링크가 있는 글도 똑같이 미색인이었습니다. 다만 표본 20건이 전부 미색인이라 대조군이 없어 인과를 판정할 수 없습니다.

따라서 이 작업은 "색인 해결책"이 아니라 사이트 구조상 정당한 개선으로 진행합니다. 이걸 고치면 색인이 풀린다고 주장하지 않습니다.

안전장치

발행된 글의 본문을 수정하는 작업이라 보수적으로 설계했습니다.

• 수동 실행 기본값은 미리보기 — apply를 명시적으로 켤 때만 반영 (스케줄 실행은 반영)
• 링크 생성 전에 internal_link_audit로 고아 목록을 먼저 갱신
• 고아당 링크 2개, 출처 글당 최대 3개 — 본문이 링크 목록이 되는 것 방지
• 관련성 점수 임계값 미만이면 링크하지 않음 (억지 링크 금지)
• 본문에 자연스럽게 쓸 표현이 없으면 문장을 지어내지 않고 건너뜀
• 고아보다 먼저 발행된 글만 출처로 사용
• 제목·기존 앵커·script/style 안에는 삽입하지 않음 — internal_linker의 검증된 로직 재사용
• 이미 링크하고 있으면 건너뜀 (멱등)

스케줄

매주 토요일 08:00 KST (다른 주간 작업과 분산). 실행 본체는 claude/blog-automation-system-KAbtE를 체크아웃하므로 기본 브랜치에는 트리거 정의만 올라갑니다.

테스트 13건 추가 (전체 434건 통과).

🤖 Generated with Claude Code

https://claude.ai/code/session_01RgLYqM9puPW1aqHTccbX69

---

Generated by Claude Code