{
  "slug": "ref/manual/content-launcher-콘텐츠-런처-자사-위키-bizspring-wiki",
  "doc_type": "ref",
  "title": "자사 위키(BizSpring Wiki) — Content Launcher (콘텐츠 런처)",
  "title_en": null,
  "one_liner": "자사 위키(BizSpring Wiki) 개요 — 자사 위키 게시 자사 위키 사이트(예: wiki.bizspring.co.kr)에 콘텐츠를 게시합니다. 방식 : GitHub 저장소의 콘텐츠 디렉토리에 Markdown 파일을 commit → Cloudflare Pages가 자동 빌드·배포",
  "summary_bullets": [
    "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 오류, 페이지 미노출, 이미지 깨짐 등 자주 발생하는 오류와 원인이 정리되어 있습니다."
  ],
  "body_md": "# 자사 위키(BizSpring Wiki)\n\n**개요 — 자사 위키 게시**\n\n자사 위키 사이트(예: wiki.bizspring.co.kr)에 콘텐츠를 게시합니다.\n\n**방식**: GitHub 저장소의 콘텐츠 디렉토리에 Markdown 파일을 commit → Cloudflare Pages가 자동 빌드·배포.\n\n**장점**: 완전한 통제, B-TCR 측정 가능, Schema.org 마크업 자동 삽입, AI 청중(llms.txt, MCP)도 함께 발사.\n\n**필수 필드 — 필수 필드 안내**\n\n* **GitHub 저장소**: 콘텐츠가 저장될 repo (예: `bizspring-inc/wiki-content`).\n* **GitHub PAT**: 콘텐츠 push 권한 토큰. **권장 권한: `repo` 만 부여, 만료 90일**.\n* **콘텐츠 디렉토리**: repo 내부 경로. 예: `content/faq/` 또는 `content/articles/`.\n* **사이트 URL 베이스**: 게시된 페이지의 canonical URL 베이스.\n\n**토큰/인증 발급 — GitHub PAT 발급 방법**\n\n1. GitHub 우상단 프로필 → **Settings**.\n2. 좌측 하단 **Developer settings** 클릭.\n3. **Personal access tokens → Fine-grained tokens** 선택.\n4. **Generate new token** 클릭.\n5. 이름: `Content Launcher · Wiki`, 만료: 90 days.\n6. **Resource owner**: 본인 또는 조직.\n7. **Repository access**: Only select repositories → 콘텐츠 repo 선택.\n8. **Permissions → Repository permissions → Contents**: Read and write.\n9. **Generate token** → 발급된 `ghp_...` 토큰 복사하여 위 필드에 붙여넣기.\n\n> ⚠️ 토큰은 발급 직후 한 번만 보입니다. 즉시 저장하세요.\n\n**자주 발생하는 오류 — 자주 발생하는 오류**\n\n* **`403 Resource not accessible by personal access token`**: PAT 권한 부족 → Contents Read/Write 재확인.\n* **`404 Not Found`**: 저장소 경로 오타 또는 PAT가 해당 repo 접근 안 됨.\n* **빌드는 됐는데 페이지가 안 보임**: Cloudflare Pages 빌드 로그 확인. frontmatter 누락 가능.\n* **이미지가 깨짐**: 이미지 자산이 외부 URL인지 확인. repo 내부 이미지는 별도 commit 필요.\n\n**권장 사항 — 권장 사항**\n\n* **만료 90일** PAT을 사용하고 만료 14일 전 자동 알림.\n* 콘텐츠 디렉토리는 카테고리별로 나눠서: `content/faq/`, `content/articles/`, `content/case/`.\n* 페이지 파일명은 영문 슬러그 사용 (한글 URL은 SEO에 불리).\n* 최소 1개의 데이터 테이블 + 1개의 차트(SVG)를 포함하면 B-TCR 점수 상승.\n",
  "related_slugs": [],
  "keywords": [],
  "faq": [
    {
      "a": "GitHub 저장소의 콘텐츠 디렉토리에 Markdown 파일을 commit하면 Cloudflare Pages가 자동으로 빌드하고 배포합니다.",
      "q": "콘텐츠는 어떻게 위키 사이트에 반영되나요?"
    },
    {
      "a": "Fine-grained token을 발급할 때 Repository permissions의 Contents 항목을 Read and write로 설정하고, repo 권한만 부여하며 만료는 90일로 하는 것이 권장됩니다.",
      "q": "GitHub PAT은 어떤 권한으로 만들어야 하나요?"
    },
    {
      "a": "PAT 권한이 부족한 경우이므로 Contents 권한이 Read and write로 설정되어 있는지 다시 확인해야 합니다.",
      "q": "403 Resource not accessible by personal access token 오류가 나면 어떻게 하나요?"
    },
    {
      "a": "Cloudflare Pages의 빌드 로그를 확인해야 하며, frontmatter가 누락된 경우일 수 있습니다.",
      "q": "빌드는 완료됐는데 페이지가 안 보이면 어떻게 하나요?"
    },
    {
      "a": "content/faq/, content/articles/, content/case/처럼 카테고리별로 나누는 것이 권장되며, 파일명은 SEO를 위해 영문 슬러그를 사용하는 것이 좋습니다.",
      "q": "콘텐츠 디렉토리는 어떻게 구성하는 것이 좋나요?"
    }
  ],
  "jsonld": null,
  "image_url": null,
  "caption": null,
  "width": null,
  "height": null,
  "video_url": null,
  "duration_sec": null,
  "thumbnail_url": null,
  "solution_slug": null,
  "source_id": "gitbook:UzjWwGASsQFDcNaCAGUu:PiiEnF1OHeNMTQuRVe2a",
  "created_at": "2026-08-23T14:32:39.611542+00:00",
  "updated_at": "2026-09-03T08:08:21.466+00:00",
  "backlinks": [],
  "html_url": "https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-자사-위키-bizspring-wiki",
  "markdown_url": "https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-자사-위키-bizspring-wiki.md"
}