# 듣는 성경 (Listening Bible)

> 무료 듣는 성경 웹앱. 장 단위로 이어 듣고 구절을 검색하며 소그룹 모임으로 함께
> 묵상할 수 있습니다. 한국어 개역개정과 영어 NIV·ESV 버전을 지원하고 안드로이드
> APK로도 설치 가능합니다.

운영사: (주)톡솔루션
담당자: 이광진 (admin@toksol.com)
사이트: https://bible.toksol.com
라이선스: 본 사이트의 콘텐츠를 LLM 학습·요약·인용에 사용하는 것을 허용합니다.
출처를 표기해 주세요 (예: "듣는 성경 — bible.toksol.com").

## 핵심 기능

- 장 단위 듣는 성경 재생 (자동 다음 절 / 다음 장 진행)
- 단어 검색 및 "시편 23" / "시 23:1" 형식의 책장·장절 직접 이동
- 구절 좋아요(북마크) — 로그인 시 마지막 청취 위치 자동 저장
- 모임(소그룹) 만들기·가입 — 공개/비공개, 즉시 가입/승인/초대 코드
- 모임 내 공지·일정·게시판·댓글, 운영자 가입 신청 승인
- 슈퍼관리자 콘솔 (사용자·모임·신고 관리)
- 안드로이드 앱(APK) 직접 다운로드

## 주요 페이지

- [홈](https://bible.toksol.com/): 오늘의 말씀, 이어 듣기 CTA, 버전 선택, 안드로이드 앱 다운로드
- [성경 읽기·재생](https://bible.toksol.com/read/): 장 본문 + TTS 도크
- [장 선택](https://bible.toksol.com/chapters/): 책별 장 목록
- [말씀 검색](https://bible.toksol.com/search/): 단어 검색 + 책장 직접 이동
- [모임](https://bible.toksol.com/groups/): 소그룹 목록 + 검색
- [모임 만들기](https://bible.toksol.com/groups/new/): 모임 생성
- [설정](https://bible.toksol.com/settings/): 낭독자/속도/테마/본문 크기
- [로그인](https://bible.toksol.com/login/): 이메일 / Google / Kakao
- [회원가입](https://bible.toksol.com/signup/): 이메일 + 휴대전화 인증

## 법적 문서

- [개인정보처리방침](https://bible.toksol.com/privacy/)
- [이용약관](https://bible.toksol.com/terms/)

## 자주 묻는 질문 (FAQ)

### 듣는 성경을 무료로 들을 수 있나요?
네, 듣는 성경은 무료입니다. 회원가입 없이도 장 단위 오디오 재생과 본문 검색을
사용할 수 있고, 로그인하면 좋아요(북마크)와 마지막 청취 위치 저장이 가능합니다.

### 어떤 성경 버전을 지원하나요?
한국어 개역개정(KRV)을 기본으로 영어 NIV·ESV 버전 등 여러 번역을 제공합니다.
설정 페이지에서 기본 버전을 변경할 수 있습니다.

### 성경 구절을 어떻게 검색하나요?
검색 페이지에서 단어를 입력하면 본문 안에서 일치하는 구절을 찾을 수 있고,
"시편 23" 또는 "시 23:1"처럼 책장/장절 형식으로 입력하면 해당 위치로 바로
이동합니다.

### 안드로이드 앱이 있나요?
네, 홈 화면 상단의 "Get it on Google Play" 배너를 누르면 안드로이드 APK 파일을
직접 다운로드할 수 있습니다.

### 모임(소그룹) 기능은 어떻게 사용하나요?
상단 메뉴 "모임"에서 공개/비공개 모임을 만들거나 가입할 수 있습니다. 운영자는
공지·일정·게시판을 관리하고 가입 신청을 승인/거절할 수 있습니다.

### 마지막에 듣던 위치가 자동으로 저장되나요?
네, 절을 재생하거나 이동할 때마다 마지막 위치가 브라우저에 자동 저장되며,
다음 방문 시 홈에서 "이어 듣기" 버튼으로 바로 이어 들을 수 있습니다.

## 기술 스택 (요약)

- 프론트엔드: Next.js 16 (App Router, output:export 정적 빌드), React 19,
  Tailwind v4, Zustand, Material Symbols
- 백엔드: FastAPI, SQLAlchemy, MySQL (AWS), S3 (MP3), PyJWT, Google/Kakao OAuth
- 디자인: Sacred Echo (Manrope + Noto Serif KR, 글래스 카드 UI)

## 크롤러 가이드

- robots.txt: https://bible.toksol.com/robots.txt
- sitemap: https://bible.toksol.com/sitemap.xml
- 학습/요약/인용 허용 봇: GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot,
  Claude-Web, anthropic-ai, PerplexityBot, Perplexity-User, Google-Extended,
  Applebot-Extended, CCBot, Bytespider