notion-widget

📚 Notion Book Search Widget (사용자 가이드)

Notion 독서 노트에 사용할 수 있는 간편한 도서 검색 위젯입니다. 책 제목을 검색하고 버튼 하나만 누르면 내 Notion 페이지에 책 정보가 깔끔하게 정리되어 들어갑니다.

✨ 주요 기능

• 🔍 간편 검색: 책 제목이나 저자로 빠르게 검색
• 📑 자동 저장: 제목, 저자, 출판사, 표지 이미지까지 한 번에 저장
• 🎨 테마 지원: 내 Notion 페이지 분위기에 맞춰 색상 변경 (Mint, Pink, Blue, Purple, Gray)

� 사용 방법

운영자가 제공한 위젯 주소(URL)를 준비하세요.

1. Notion API 설정

내 Notion에 글을 쓸 수 있는 권한을 얻기 위해 ‘토큰’이 필요합니다.

⚠️ 안심하세요! 입력하신 토큰은 서버에 전송되지 않고, 오직 사용자의 브라우저에만 저장되어 Notion과 직접 통신하는 데에만 사용됩니다.

1. Notion 내 통합 만들기 페이지로 접속합니다.
2. + 새 통합 버튼을 클릭합니다.
3. 이름을 입력하고(예: 내 독서기록장) 제출합니다.
4. 시크릿 토큰(Internal Integration Token)을 복사해둡니다. (secret_... 으로 시작)

2. Notion 페이지 연결

책을 저장할 데이터베이스 페이지에 권한을 부여해야 합니다.

1. Notion에서 책을 저장할 데이터베이스 페이지를 엽니다.
2. 우측 상단 ... 메뉴 클릭 → 연결(Connect) → 검색창에 방금 만든 통합 이름 입력 후 선택.
3. 확인을 눌러 연결합니다.

3. 위젯 설정하기

1. 위젯 주소로 접속합니다.
2. 우측 상단 톱니바퀴(⚙️) 아이콘을 눌러 설정으로 들어갑니다.
3. Notion Token: 아까 복사한 시크릿 토큰을 붙여넣습니다.
4. Database ID: Notion 데이터베이스의 URL에서 ID 부분을 복사해 넣습니다.
   • 예: https://www.notion.so/my-page/a1b2c3d4e5...?v=... (굵은 부분)
5. 속성 매핑: 내 데이터베이스의 항목 이름과 똑같이 적어줍니다.
   • 예: 제목 → 이름, 저자 → 지은이, 표지 → 이미지 등
6. Save Configuration 버튼을 누릅니다.

4. Notion에 넣기

이제 설정이 끝났습니다! Notion 페이지에서 /embed 또는 /임베드를 치고 위젯 주소를 입력하면, 내 페이지 안에서 바로 책을 검색하고 추가할 수 있습니다.