🌐 스벨트킷 블로그 허브(Hub) 연동 및 자동 발행 완벽 가이드
독립형 개인 블로그를 운영할 때 가장 큰 고민은 **"어떻게 새로운 독자에게 내 글을 알릴 것인가?"**입니다. 상용 플랫폼과 달리 독립 블로그는 데이터와 디자인의 완전한 자유를 누릴 수 있지만, 초기 유입과 검색 노출에는 많은 시간과 노력이 필요합니다.
**스벨트킷 블로그 통합 허브(hub.sveltekitblog.com)**는 이러한 독립 블로그들의 발견성(Discovery) 한계를 극복하고, 블로거들이 함께 트래픽과 통계를 나누며 성장할 수 있도록 설계된 분산 연합 피드 플랫폼입니다.
본 가이드에서는 API Key 발급부터 블로그 관리자 연동, 글 작성·수정·삭제 라이프사이클 및 애드센스 시너지까지 허브 연동의 모든 과정을 상세히 안내합니다.
1. 🎯 허브 연동의 핵심 특징 및 원리
- 데이터의 완전한 독립성 & 소유권:
- 글의 원본 본문과 모든 DB 데이터는 내 Cloudflare D1에 온전히 보관됩니다.
- 허브에는 카드 노출을 위한 **표준 HTML 서론(1,000~1,500자)**과 메타데이터(제목, 썸네일, 슬러그 등)만 안전하게 전송됩니다.
- 이미지 절대 경로 자동 변환:
- 마크다운이나 HTML에 포함된 상대 경로 이미지(
/images/...)는 내 블로그의 도메인을 포함한 절대 URL(https://...)로 자동 변환되어 허브 피드에 깨짐 없이 선명하게 표시됩니다.
- 마크다운이나 HTML에 포함된 상대 경로 이미지(
- 비동기 논블로킹(Non-blocking) 장애 격리:
- 허브 서버의 네트워크 지연이나 일시적 오류가 발생하더라도, 내 블로그의 글 저장 트랜잭션은 100% 정상 완료되도록 안전하게 보호됩니다.
2. 🔑 1단계: 허브 API Key 발급 및 블로그 설정
① 허브 플랫폼에서 API Key 발급
- **스벨트킷 블로그 허브의 '내 블로그 연동 (API 발급)'**에 접속합니다.
- 내 블로그 대표 URL(예:
https://myblog.com)을 등록하고, 고유 발급된 Site API Key(sk_board_...또는sk_hub_...)를 복사합니다.
② 블로그 관리자 페이지(⚙️ 설정) 등록
- 내 블로그 관리자 페이지 접속 후 [설정] 메뉴로 이동합니다.
- 스벨트킷블로그 허브(Hub) 연동 설정 섹션을 찾습니다.
[ 스벨트킷블로그 허브(Hub) 연동 설정 ]
* 허브 플랫폼 URL : https://hub.sveltekitblog.com (고정)
* 허브 발급 API Key : sk_hub_live_... (발급받은 키 입력)
* 🌐 글 작성 시 허브 동시 발행 기본 활성화 : [ON / OFF 토글]
글 작성 시 허브 동시 발행 기본 활성화를 켜두시면 새 글을 작성할 때마다 자동으로 연동 체크박스가 활성화됩니다.- 하단의 [설정 저장하기] 버튼을 눌러 설정을 완료합니다.
3. ✍️ 2단계: 포스트 에디터에서 허브 동시 발행하기
글 작성 및 수정 화면(새 글 작성 또는 글 수정)의 메타데이터 사이드바 하단에 허브 자동 제출 체크박스가 제공됩니다.
[☑️] 🌐 스벨트킷블로그 허브(hub.sveltekitblog.com)에 자동 제출
체크 시 글이 발행될 때 허브 피드로 요약 카드가 자동 전송됩니다.
체크를 해제하면 허브 피드에서 "숨김" 처리되어 추천(좋아요) 통계가 안전하게 보존되며,
허브에서 완전히 삭제하려면 블로그에서 포스트를 삭제해야 합니다.
- 공개 글 발행 (
Status: Published):- 체크박스가 켜진 상태로 글을 저장하면, D1 DB 저장과 동시에 허브로 표준 HTML 서론과 썸네일이 전송되어 허브 피드에 즉시 노출됩니다.
- 임시저장 (
Status: Draft):- 상태가 임시저장인 글은 체크박스를 켜두더라도 허브 피드에 공개되지 않습니다.
4. 🔄 3단계: 글 수정, URL 변경, 비공개, 삭제 라이프사이클
블로그를 운영하다 보면 글의 내용을 보강하거나, 카테고리를 변경하고, 글을 비공개하거나 삭제하는 상황이 발생합니다. 블로그 엔진은 이러한 상황을 자동으로 감지하여 허브와 완벽하게 동기화합니다.
| 상황 | 블로그 동작 | 허브(Hub) 동기화 동작 |
|---|---|---|
| 글 내용 단순 수정 | 본문 수정 후 저장 | 최초 발행일(published_at)을 보존한 상태로 카드 내용 및 썸네일만 최신화 (피드 상단으로 불필요하게 튀지 않음) |
| 슬러그 / 카테고리 변경 | URL 변경 후 저장 | 허브에 등록되어 있던 **이전 URL 카드를 자동 삭제(DELETE)**하고, 새 URL로 신규 등록(POST) (깨진 404 링크 방지) |
| 비공개 전환 / 체크 해제 | Draft 전환 또는 체크 해제 | 허브 피드에서 숨김(hidden) 처리 (독자들이 남긴 추천/좋아요 통계는 영구 보존) |
| 블로그에서 포스트 삭제 | 관리자에서 글 완전 삭제 | 허브에서도 해당 포스트 카드를 완전 삭제(DELETE) |
5. 💰 구글 애드센스 승인 준비 및 시너지 효과
허브 연동을 통해 유입되는 트래픽은 구글 애드센스 승인 심사 및 수익 창출에 매우 긍정적인 영향을 줍니다.
- 초기 유효 트래픽 확보:
- 구글 봇은 방문자가 전혀 없는 블로그보다 실제 활성 독자가 유입되는 사이트를 훨씬 빠르게 크롤링하고 높게 평가합니다.
ads.txt완벽 자동 서빙:- 관리자 설정의
ads_txt입력창에 애드센스 승인 코드(google.com, pub-..., DIRECT, f08c47fec0942fa0)를 넣어두면https://내도메인.com/ads.txt로 즉시 서빙됩니다.
- 관리자 설정의
- 콘텐츠 품질 가이드:
- 애드센스 1차 승인을 위해 1,500자 이상의 양질의 IT/기술/정보성 글을 15~20편 이상 꾸준히 허브와 함께 발행하시는 것을 권장합니다.
6. 🏁 마치며
스벨트킷 블로그 허브 연동을 통해 나만의 독립 블로그가 가진 데이터 통제권을 온전히 지키면서, 더 많은 독자들과 연결되는 강력한 시너지를 경험해 보세요!
댓글 0개
댓글을 작성하려면 로그인이 필요합니다.