Notion — Content Launcher (콘텐츠 런처)
핵심 요약
- Notion 데이터베이스에 위키 글을 페이지(행)로 자동 발행하는 기능에 대한 안내 문서입니다.
- 본문은 Markdown이 Notion 블록으로 자동 변환되며 차트·표·다이어그램은 이미지로 삽입됩니다.
- 발행을 위해서는 통합 토큰(notion_token), 대상 DB에 통합 연결, database_id 세 가지가 필요합니다.
- 통합 토큰 발급, DB에 통합 연결(공유), URL에서 database_id 확인하는 절차를 단계별로 설명합니다.
- 404·401 오류 등 자주 발생하는 문제와 원인, 그리고 설정 시 권장 사항을 안내합니다.
# Notion
개요 — Notion 위키 발행
노션 \*\*데이터베이스(DB)\*\*에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다.
발행하려면 세 가지가 필요합니다: ① 통합 토큰 ② 대상 DB를 통합에 연결(공유) ③ database\_id. 아래 \[토큰 발급 · DB 연결 · DB ID 확인]을 따라 설정하세요.
필수 필드 — 필수 필드
- notion\_token — 통합 시크릿.
ntn_또는secret_로 시작합니다. - database\_id — 발행 대상 노션 데이터베이스 ID(32자리).
- category\_prop (선택) — 카테고리를 기록할 DB 속성명(예:
분류,태그).
토큰/인증 발급 — 토큰 발급 · DB 연결 · DB ID 확인
1) 통합 토큰 발급
- https://www.notion.so/my-integrations 접속 (또는 노션 좌하단 설정 → Connections → 통합 개발/관리)
- 기존 통합 선택, 또는 + New integration으로 생성(워크스페이스 선택, Capabilities에 Read content + Insert content 체크)
- Configuration 탭 → Internal Integration Secret → Show → Copy →
notion_token에 입력 (ntn_…)
2) 통합을 대상 DB에 연결(공유) — 필수
> 통합이 그 DB에 접근 권한이 없으면 토큰이 맞아도 404가 납니다.
- 발행할 데이터베이스를 full page로 열기
- 우측 상단 ···(More) → Connections(연결) → 위에서 만든 통합 선택해 추가
3) database\_id 확인 (URL에서)
- 데이터베이스를 full page로 연 상태의 주소창 URL:
https://www.notion.so/{워크스페이스}/{32자리DB ID}?v={뷰ID} ?v=바로 앞 32자리가 database\_id 입니다(대시 없어도 됨).- ⚠️ URL에
?v=가 있어야 데이터베이스입니다. 없으면 _페이지_ ID라 발행이 안 됩니다. - 인라인 데이터베이스는 제목 옆 ⤢(open as full page) 로 펼친 뒤 URL을 확인하세요.
4) 입력 · 확인
- 연결 정보 탭에
notion_token·database_id· (선택)category_prop입력 → 저장. - 통합이 보는 DB가 맞는지 확실치 않으면, 대상 DB를 2)처럼 연결했는지 다시 확인하세요.
자주 발생하는 오류 — 자주 발생하는 오류
- 404 object\_not\_found / Could not find database — 통합이 그 DB에 공유되지 않음(2단계 누락), 또는 _페이지_ ID를 넣음(데이터베이스 ID 필요 — URL의
?v=확인). - 401 unauthorized / API token is invalid — 토큰 오류·만료. my-integrations에서 시크릿 재확인.
- category\_prop이 반영 안 됨 — DB에 그 속성명이 없거나 타입 불일치. DB 속성명을 정확히(대소문자) 입력.
권장 사항 — 권장 사항
- 데이터베이스 ID를 사용하세요(페이지 ID 아님) — URL의
?v=앞 32자리. - 통합 Capabilities에 Insert content 포함.
- 노션 위키는 대표(특성)이미지·CTA를 사용하지 않고, 3줄 요약·FAQ·도입부 인포그래픽은 본문에 포함됩니다.
자주 묻는 질문
notion_token은 어디서 발급받나요?
https://www.notion.so/my-integrations 에 접속하거나 노션 좌하단 설정 → Connections → 통합 개발/관리에서 발급받을 수 있습니다. 기존 통합을 선택하거나 New integration으로 새로 생성한 뒤, Configuration 탭의 Internal Integration Secret을 복사해 입력하면 됩니다. 토큰은 ntn_ 또는 secret_ 로 시작합니다.
database_id는 어떻게 확인하나요?
데이터베이스를 full page로 연 상태의 주소창 URL에서 ?v= 바로 앞 32자리가 database_id입니다. URL에 ?v=가 없으면 페이지 ID이므로 발행이 되지 않으니, 인라인 데이터베이스라면 제목 옆 ⤢ 아이콘으로 full page로 펼친 뒤 확인해야 합니다.
토큰과 database_id를 맞게 넣었는데 404 오류가 나요. 왜 그런가요?
통합이 해당 데이터베이스에 공유(연결)되지 않았을 가능성이 큽니다. 데이터베이스를 full page로 열고 우측 상단 ···(More) → Connections에서 만든 통합을 추가로 연결해야 합니다. 또한 페이지 ID를 database_id로 잘못 입력한 경우에도 발생하니 URL의 ?v= 여부를 확인하세요.
401 unauthorized 오류가 뜨는 경우는 어떻게 해결하나요?
토큰이 잘못됐거나 만료된 경우입니다. my-integrations 페이지에서 시크릿을 다시 확인하고 재발급받아 입력하세요.
category_prop 값이 DB에 반영되지 않아요.
DB에 해당 속성명이 없거나 속성 타입이 맞지 않는 경우입니다. DB에 설정된 속성명을 대소문자까지 정확히 입력해야 합니다.