BLOG OS 사용설명서

BLOG OS 사용설명서 v1.0 마지막 수정: 2026-06-28 대응 기능: 대시보드, 글 관리, AI 작업, 기업링크, 작업 로그, 내부링크 API

1. BLOG OS란?

BLOG OS는 WordPress 블로그 운영을 한곳에서 관리하기 위한 SEO Control Tower입니다.

글을 직접 작성하는 도구라기보다는, WordPress에 발행된 글을 동기화하고 SEO 상태, 내부링크, 기업 주가 링크, AI 추천 작업을 관리하는 운영센터입니다.

핵심 역할

새 글 생성은 n8n의 SMART_POST_GENERATOR가 담당하고, BLOG OS는 발행된 글의 상태 확인과 보강 작업을 담당합니다.

2. 왼쪽 메뉴

메뉴	역할	언제 사용하나
📊 대시보드	블로그 전체 상태 요약	현재 SEO 상태를 빠르게 확인할 때
📝 글 관리	WordPress 글 목록, 검색, 필터, 상세 확인	새 글 동기화와 개별 글 점검 시
🤖 AI 작업	기존 글 내부링크 추천 작업 확인	기존 글에 함께 읽으면 좋은 글을 붙일 때
🏢 기업링크	기업명과 주가 링크 관리	투자 글에 기업 주가 링크를 붙일 때
📋 작업 로그	실행 기록 확인	작업 성공/실패 원인 확인 시
📚 문서	변경 기록 등 문서 확인	업데이트 내역을 볼 때
❓ 사용설명서	현재 보고 있는 도움말	BLOG OS 사용법을 확인할 때

3. 대시보드

대시보드는 BLOG OS에 접속했을 때 전체 상태를 한눈에 보는 화면입니다.

총 글 수, SEO 점수 상태, 내부링크 부족 글, 외부링크 부족 글, ALT 누락 글, 최근 작업 상태 등을 확인하는 용도입니다.

운영 팁

대시보드는 매일 오래 볼 필요는 없습니다. 새 글을 동기화한 뒤 전체 상태가 크게 나빠졌는지만 확인하면 됩니다.

4. 글 관리

글 관리는 BLOG OS에서 가장 자주 사용하는 화면입니다.

WordPress 동기화

WordPress에 새 글이 발행되었는데 BLOG OS에 보이지 않는다면 먼저 WordPress 동기화 버튼을 누릅니다.

동기화가 완료되면 최종 동기화 시간이 표시됩니다.

검색과 필터

검색: 제목 또는 Post ID로 글을 찾습니다.
카테고리: INVEST, IT-AI, Life, ISSUE-TREND 등 카테고리별로 봅니다.
우선순위: HIGH, MEDIUM, LOW 상태를 기준으로 봅니다.
이슈: 내부링크 없음, 외부링크 없음, ALT 누락, 자동영역 없음 등을 확인합니다.
개수 선택: 20, 30, 40, 50개씩 목록을 볼 수 있습니다.

글 상세 화면

글 제목을 누르면 상세 화면으로 이동합니다. 여기서 SEO 점수, 감점 이유, 내부링크/외부링크 상태, 이미지 ALT 상태, 기업 링크 매칭 여부를 확인합니다.

5. AI 작업

AI 작업은 기존에 발행된 글에 내부링크가 부족할 때 사용하는 기능입니다.

AI 추천 실행을 누르면 n8n의 BLOG_OS_INTERNAL_LINK_RECOMMEND_V2 워크플로우가 실행되고, 기존 글 중 함께 읽으면 좋은 글을 추천합니다.

상태	의미
PENDING	아직 실행 전입니다.
RUNNING	AI 추천 실행 중입니다.
SUCCESS	추천 결과가 정상 저장되었습니다.
FAILED	n8n Webhook, DNS, API 오류 등으로 실패했습니다.

주의

AI 작업은 새 글 생성용이 아닙니다. 새 글은 SMART_POST_GENERATOR가 발행 전에 BLOG OS API를 호출해서 내부링크를 자동 삽입합니다.

6. 기업링크

기업링크는 투자 글에서 기업명이 발견되었을 때 Investing.com 주가 링크를 자동으로 붙이기 위한 기능입니다.

company_name: 표시할 기업명입니다.
ticker: 티커입니다.
aliases: 본문에서 찾을 다른 이름입니다.
investing_url: 연결할 Investing.com URL입니다.
enabled: 사용 여부입니다.

7. 작업 로그

작업 로그에서는 동기화, 기업링크 적용, 내부링크 추천, 번들 적용 등의 성공과 실패 기록을 확인합니다.

문제가 발생했을 때는 먼저 작업 로그를 확인하면 어느 단계에서 실패했는지 빠르게 파악할 수 있습니다.

8. 문서

문서 메뉴에는 BLOG OS 변경 기록과 운영 관련 문서를 보관합니다.

새 기능이 추가되거나 구조가 바뀌면 문서 메뉴와 이 사용설명서를 함께 업데이트하는 것이 좋습니다.

9. 내부링크 운영

기존 글

기존 130여 개 글에 내부링크가 없는 문제를 해결하기 위해 INTERNAL_LINK_BACKFILL과 BLOG OS AI 작업 기능을 사용합니다.

새 글

새 글은 n8n의 SMART_POST_GENERATOR에서 발행 직전 BLOG OS의 내부링크 추천 API를 호출합니다. 추천 결과 HTML이 본문 하단에 붙은 뒤 WordPress에 발행됩니다.

그룹	포함 카테고리	설명
TECH	INVEST, IT, AI, AI-TECH, TECH	투자와 기술 글은 서로 추천할 수 있습니다.
LIFE	Life, ISSUE, TREND, ISSUE-TREND	생활과 이슈 글은 서로 추천할 수 있습니다.

10. 매일 운영 순서

n8n에서 새 글이 생성되었는지 확인합니다.
BLOG OS의 글 관리에서 WordPress 동기화를 실행합니다.
오늘 생성된 글이 목록에 보이는지 확인합니다.
글 상세에서 SEO 점수와 감점 이유를 확인합니다.
필요하면 AI 작업에서 기존 글 내부링크 추천을 실행합니다.
투자 글은 기업링크 매칭 여부를 확인합니다.
작업 로그에서 실패 기록이 없는지 확인합니다.

11. 문제 해결

새 글이 BLOG OS에 안 보입니다.

글 관리에서 WordPress 동기화를 먼저 실행하세요. 그래도 보이지 않으면 WordPress 발행 상태가 draft인지 publish인지 확인합니다.

AI 추천 결과가 비어 있습니다.

같은 추천 그룹 안에 적절한 후보 글이 부족할 수 있습니다. TECH 그룹은 투자와 IT/AI가 함께 묶이고, LIFE 그룹은 생활과 이슈/트렌드가 함께 묶입니다.

DNS 오류가 발생합니다.

“The DNS server returned an error”는 대부분 일시적인 네트워크 문제입니다. n8n의 WordPress 관련 노드에는 Retry On Fail 3회, 2000ms 설정을 권장합니다.

기업링크가 붙지 않습니다.

기업링크 메뉴에서 해당 기업의 이름, 티커, 별칭, Investing URL이 등록되어 있고 enabled 상태인지 확인합니다.

12. 설명서 변경 이력

버전	날짜	내용
v1.0	2026-06-28	BLOG OS 사용설명서 최초 생성. 대시보드, 글 관리, AI 작업, 기업링크, 작업 로그, 내부링크 운영, 문제 해결 항목을 추가했습니다.
v1.1	2026-06-28	사용설명서를 섹션별 파일로 분리했습니다. 앞으로는 전체 파일을 덮어쓰지 않고 필요한 섹션만 수정할 수 있습니다.

운영 원칙

앞으로 BLOG OS 기능이 추가되면 기능 구현, 사용설명서 수정, 변경 이력 기록을 함께 진행합니다.