자사 위키(BizSpring Wiki) — Content Launcher (콘텐츠 런처)
핵심 요약
- GitHub 저장소에 Markdown 파일을 commit하면 Cloudflare Pages가 자동으로 빌드·배포해 자사 위키에 콘텐츠를 게시하는 방식입니다.
- 완전한 통제권, B-TCR 측정, Schema.org 마크업 자동 삽입, llms.txt·MCP를 통한 AI 청중 노출이 장점입니다.
- GitHub 저장소, GitHub PAT(권장: repo 권한만, 90일 만료), 콘텐츠 디렉토리, 사이트 URL 베이스가 필수 입력 필드입니다.
- GitHub Fine-grained token 발급 절차와 Contents Read/Write 권한 설정 방법이 안내되어 있습니다.
- 403/404 오류, 페이지 미노출, 이미지 깨짐 등 자주 발생하는 오류와 원인이 정리되어 있습니다.
# 자사 위키(BizSpring Wiki)
개요 — 자사 위키 게시
자사 위키 사이트(예: wiki.bizspring.co.kr)에 콘텐츠를 게시합니다.
방식: GitHub 저장소의 콘텐츠 디렉토리에 Markdown 파일을 commit → Cloudflare Pages가 자동 빌드·배포.
장점: 완전한 통제, B-TCR 측정 가능, Schema.org 마크업 자동 삽입, AI 청중(llms.txt, MCP)도 함께 발사.
필수 필드 — 필수 필드 안내
- GitHub 저장소: 콘텐츠가 저장될 repo (예:
bizspring-inc/wiki-content). - GitHub PAT: 콘텐츠 push 권한 토큰. 권장 권한:
repo만 부여, 만료 90일. - 콘텐츠 디렉토리: repo 내부 경로. 예:
content/faq/또는content/articles/. - 사이트 URL 베이스: 게시된 페이지의 canonical URL 베이스.
토큰/인증 발급 — GitHub PAT 발급 방법
- GitHub 우상단 프로필 → Settings.
- 좌측 하단 Developer settings 클릭.
- Personal access tokens → Fine-grained tokens 선택.
- Generate new token 클릭.
- 이름:
Content Launcher · Wiki, 만료: 90 days. - Resource owner: 본인 또는 조직.
- Repository access: Only select repositories → 콘텐츠 repo 선택.
- Permissions → Repository permissions → Contents: Read and write.
- Generate token → 발급된
ghp_...토큰 복사하여 위 필드에 붙여넣기.
> ⚠️ 토큰은 발급 직후 한 번만 보입니다. 즉시 저장하세요.
자주 발생하는 오류 — 자주 발생하는 오류
403 Resource not accessible by personal access token: PAT 권한 부족 → Contents Read/Write 재확인.404 Not Found: 저장소 경로 오타 또는 PAT가 해당 repo 접근 안 됨.- 빌드는 됐는데 페이지가 안 보임: Cloudflare Pages 빌드 로그 확인. frontmatter 누락 가능.
- 이미지가 깨짐: 이미지 자산이 외부 URL인지 확인. repo 내부 이미지는 별도 commit 필요.
권장 사항 — 권장 사항
- 만료 90일 PAT을 사용하고 만료 14일 전 자동 알림.
- 콘텐츠 디렉토리는 카테고리별로 나눠서:
content/faq/,content/articles/,content/case/. - 페이지 파일명은 영문 슬러그 사용 (한글 URL은 SEO에 불리).
- 최소 1개의 데이터 테이블 + 1개의 차트(SVG)를 포함하면 B-TCR 점수 상승.
자주 묻는 질문
콘텐츠는 어떻게 위키 사이트에 반영되나요?
GitHub 저장소의 콘텐츠 디렉토리에 Markdown 파일을 commit하면 Cloudflare Pages가 자동으로 빌드하고 배포합니다.
GitHub PAT은 어떤 권한으로 만들어야 하나요?
Fine-grained token을 발급할 때 Repository permissions의 Contents 항목을 Read and write로 설정하고, repo 권한만 부여하며 만료는 90일로 하는 것이 권장됩니다.
403 Resource not accessible by personal access token 오류가 나면 어떻게 하나요?
PAT 권한이 부족한 경우이므로 Contents 권한이 Read and write로 설정되어 있는지 다시 확인해야 합니다.
빌드는 완료됐는데 페이지가 안 보이면 어떻게 하나요?
Cloudflare Pages의 빌드 로그를 확인해야 하며, frontmatter가 누락된 경우일 수 있습니다.
콘텐츠 디렉토리는 어떻게 구성하는 것이 좋나요?
content/faq/, content/articles/, content/case/처럼 카테고리별로 나누는 것이 권장되며, 파일명은 SEO를 위해 영문 슬러그를 사용하는 것이 좋습니다.