NiVoca

NiVoca 사용법

웹에서 만난 일본어를, 내 단어장으로.

읽던 페이지에서 일본어를 선택하면 뜻과 요미가나를 확인할 수 있어요. 설치부터 계정 연결, 단어 저장까지 차근차근 시작해 보세요.

iPhone·iPad의 Safari에서 시작하기

Safari 확장은 NiVoca 앱에 포함돼요. 공유 메뉴의 기존 Share/Action 확장과는 별개예요.

  1. Safari 확장이 포함된 NiVoca 앱을 설치하거나 업데이트해요.
  2. 기기의 설정에서 Safari → 확장 프로그램 → NiVoca를 찾아 확장을 켜요. iOS 버전에 따라 Safari 설정이 「앱」 아래에 있을 수 있어요.
  3. Safari에서 일반 웹페이지를 열고 확장 프로그램 메뉴의 NiVoca를 눌러요. 요청받은 웹사이트 접근 범위를 확인하고 허용해 주세요.
  4. 먼저 「이 페이지에서 켜기」로 사용해 보세요. 전체 자동 사용은 아래의 웹사이트 설정 안내를 확인한 뒤 선택할 수 있어요.

확장 목록에 NiVoca가 없다면 설치한 앱 빌드에 Safari 확장이 포함돼 있는지 확인해 주세요. 기기 정책이나 브라우저 자체 화면에서는 사용이 제한될 수 있어요.

데스크톱 Chrome·Aside에서 시작하기

Chrome 계열용 패키지를 받은 경우 압축을 푼 폴더에서 직접 로드할 수 있어요. 브라우저가 Chrome 확장과 Manifest V3를 지원해야 해요.

  1. 설치 ZIP을 압축 해제하고 manifest.json이 바로 들어 있는 폴더를 찾아요. 설치한 뒤에도 이 폴더를 유지해 주세요.
  2. Chrome의 확장 프로그램 관리 화면(chrome://extensions)이나 Aside의 대응 설정을 열어요.
  3. 브라우저가 허용하는 경우 개발자 모드를 켜고 「압축해제된 확장 프로그램 로드」로 해당 폴더를 선택해요.
  4. NiVoca가 활성화됐는지 확인하고 팝업을 열어요. 같은 폴더의 파일을 업데이트했다면 확장 관리 화면에서 새로고침하고 기존 웹페이지도 다시 열거나 새로고침해 주세요.

현재 패키지는 Chrome 116 이상을 대상으로 해요. Aside의 지원 범위와 권한 화면은 버전에 따라 다를 수 있고, Android 확장 브라우저의 호환성·실기기 동작은 아직 확인하지 않았어요. 모바일 Chrome에서 데스크톱 확장을 설치할 수 있다고 가정하지 마세요.

내 NiVoca 계정 연결하기

Google·Apple로 가입했어도 새 비밀번호를 만들 필요 없어요. 휴대폰 NiVoca 앱에서 사용 중인 계정을 직접 승인해 연결할 수 있어요.

  1. 확장의 계정 설정에서 「NiVoca 앱으로 연결」 또는 「NiVoca 앱 계정으로 연결」을 눌러요.
  2. Safari에서는 앱으로 이동해요. 데스크톱에서는 표시된 연결 링크를 복사해 NiVoca 앱이 설치된 휴대폰에서 열어요.
  3. 앱에 표시된 코드와 계정이 의도한 것인지 확인하고 직접 승인해요. 링크를 여는 것만으로 연결되지는 않아요.
  4. 브라우저로 돌아와 「연결 상태 확인」을 누르거나 확장 팝업을 다시 열어요. 연결된 이름·이메일이 맞는지 확인해 주세요.
  5. 이미 연결돼 있으면 이메일·비밀번호 입력 대신 계정 정보와 로그아웃이 보여요. 비밀번호가 있는 계정은 이메일 로그인도 사용할 수 있어요.

연결 링크는 5분 뒤 만료돼요. 만료되거나 계정이 다르면 연결 시도를 취소하고 다시 시작해 주세요. 앱·Safari·데스크톱 브라우저의 로그인 상태는 자동으로 같아지지 않으며, 브라우저 쿠키 정책에 따라 데스크톱 연결이 제한될 수 있어요.

단어와 텍스트 검색

읽기 기능을 켠 페이지에서 일본어를 선택해요. 선택한 길이와 문장 구분에 따라 단어 검색 또는 텍스트 분석으로 이어져요.

  1. 단어 검색: 정규화한 글자 수에서 공백을 빼고 15자까지는 단어로 찾아요. 실제 검색에는 선택한 원래 표기를 유지해요.
  2. 텍스트 분석: 16자 이상이거나 줄바꿈·문장 구분 기호가 있으면 텍스트에서 일본어 단어를 추출해요. 최대 5,000 UTF-16 단위의 선택과 200개 단어를 처리해요.
  3. 단어를 20개씩 묶어 서버에서 DB → Jisho → AI 순서로 찾아요. DB에 있는 단어는 외부 조회 없이 반환하고, 필요한 뜻 보강과 AI 검색은 모아서 처리해요. Safari와 Chrome이 같은 검색 경로를 사용하며, 호출 제한이나 시간 제한에 도달하면 찾은 결과를 유지하고 멈춰요.
  4. 여러 결과는 처음 10개를 보여요. 더 보기로 나머지 결과를 확인할 수 있어요. 검색 실패와 사전에서 찾지 못한 단어는 구분해서 표시해요.
  5. 선택을 해제하거나 다른 단어를 선택하면 이전 카드를 닫고 늦게 도착한 결과를 버려요. 취소·인증 만료·호출 제한이 발생하면 새 조회를 시작하지 않아요.

짧은 일본어 문장도 문장 구분 기호가 있으면 텍스트로 처리할 수 있어요. 글자 수와 UTF-16 길이는 일부 문자에서 다를 수 있어요. 외부 사전이나 AI가 필요한 결과는 DB 결과보다 오래 걸릴 수 있어요.

단어 저장과 「고급」

뜻을 확인한 뒤 같은 카드에서 바로 내 단어로 모을 수 있어요. 저장 여부와 고급 정보는 결과가 도착하면 미리 확인해요.

  1. 첫 줄의 「추가」는 단어장 선택 없이 내 단어로 저장해요. 이미 내 단어인 항목은 추가 버튼 대신 「저장됨」으로 표시해요.
  2. 「고급」에서는 소속 단어장, 단어장 선택·추가, JLPT 레벨·태그와 저장된 예문을 확인해요. 단어 저장과 단어장에 넣기는 별도 동작이에요.
  3. 단어장을 선택한 뒤 그 옆의 「추가」를 누르면 해당 단어장에도 넣어요. 단어는 저장됐지만 단어장 추가가 실패했다면 단어장 추가를 다시 시도할 수 있어요.
  4. 말줄임된 단어는 눌러 전체 표기를 볼 수 있어요. 긴 뜻·태그·예문은 카드 안에서 줄바꿈하거나 스크롤해 확인해요.

저장 버튼을 여러 번 눌러도 같은 진행 중 작업을 공유해요. 카드나 팝업을 닫는 것은 이미 서버에 보낸 저장을 되돌리지 않아요. 결과가 불확실하면 다시 시도하기 전에 라이브러리에서 저장 여부를 확인해요.

이 페이지에서 사용 / 모든 웹사이트에서 자동 사용

자동 사용은 기본으로 꺼져 있어요. 필요한 페이지에서만 켜거나, 브라우저 권한을 확인한 뒤 전체 자동 사용을 선택할 수 있어요.

  1. 수동 모드에서는 「이 페이지에서 켜기/끄기」가 현재 페이지의 실제 상태를 바꿔요.
  2. 「모든 웹사이트에서 자동으로 사용」을 켜면 브라우저가 접근을 허용한 웹페이지에서 선택 읽기를 자동으로 사용할 수 있어요. 중복되는 페이지 켜기 버튼은 숨겨져요.
  3. Safari의 웹사이트 접근 권한과 NiVoca 안의 자동 사용 설정은 별개예요. 필요한 경우 Safari에서 「모든 웹사이트」 접근도 허용해 주세요.
  4. Chrome 계열은 자동 사용을 켤 때 별도 웹사이트 접근을 요청해요. 거절하면 자동 사용을 켜지 않고, 권한을 취소하면 자동 사용도 꺼져요.
  5. 자동 사용을 꺼도 예전에 수동으로 켠 상태가 숨어서 남지 않아요. 필요한 페이지에서 다시 수동으로 켜 주세요.

웹사이트 전체를 자동으로 분석하는 설정은 아니에요. 일반 웹페이지의 실제 사용자 선택에 반응하며, 브라우저 설정·스토어 등 보호된 페이지나 기기 정책으로 막힌 페이지에서는 동작하지 않을 수 있어요.

본문에 요미가나 표시하기

「요미가나 표시」를 켠 뒤 난도를 고르고 「현재 화면에 적용」을 누르면 현재 보이는 일본어 본문에 읽기를 붙여요.

  1. N1이 가장 어려운 수준이고 N5가 가장 쉬워요. 선택한 레벨과 그보다 어려운 단어, 레벨 미확인 단어가 포함돼요.
  2. 적용 버튼을 눌렀을 때만 현재 보이는 본문을 최대 100줄, 줄당 200 UTF-16 단위, 합계 5,000 UTF-16 단위까지 보내요. 너무 긴 개별 본문 노드는 건너뛸 수 있어요.
  3. 입력창·편집 중인 글·코드·기존 요미가나 등은 제외해요. 스크롤한 다른 영역에 적용하려면 다시 버튼을 눌러 주세요.
  4. 요미가나를 끄면 NiVoca가 붙인 표시를 되돌려요. 요미가나 조회는 캐시 전용이며, 없는 단어를 외부 사전·AI로 자동 생성하지 않아요.

레벨이나 읽기를 확인하지 못한 모든 단어에 표시가 붙는 것은 아니에요. 페이지 구조에 따라 일부 본문은 대상에서 제외될 수 있어요.

대기 단어 다시 찾기

찾지 못한 단어는 필요할 때 로컬 대기 목록에 보관할 수 있어요. 최대 200개를 중복 없이 보관하며, 페이지 주소나 주변 문장을 함께 보관하지 않아요.

  1. 대기 단어의 검색·생성 버튼을 직접 누르면 기존 단어 검색 경로로 하나씩 다시 찾아요. 이 동작에는 Jisho·AI 조회와 사전 저장이 포함될 수 있어요.
  2. 같은 단어·읽기로 저장된 사전 항목이 확인된 단어만 대기 목록에서 지워요. 미발견·실패한 단어는 남겨 둬요.
  3. 중단 버튼을 누르거나 팝업을 닫거나 계정을 바꾸면 다음 단어의 조회를 멈춰요. 진행 중인 요청의 결과가 늦게 와도 닫은 화면을 다시 열지 않아요.

이미 서버에서 시작한 AI 요청은 중단 후에도 끝나서 사전에 저장되거나 비용이 발생할 수 있어요. 대기 단어를 해결하는 것과 내 단어장에 저장하는 것은 별개예요.

전송되는 내용과 문제 해결

선택 읽기는 선택한 단어·텍스트를 NiVoca 서버에 보내요. 서버는 필요한 경우 외부 사전과 AI를 이용하며, 결과를 공용 사전 DB에 저장할 수 있어요. 확장 사전 검색은 앱의 개인 API 키를 쓰는 AI 어시스턴트와 별개이고, 확장에서 API 키를 입력하지 않아요.

  1. 페이지 본문 전체를 자동으로 보내지 않아요. 본문 요미가나는 위에 설명한 적용 버튼을 눌렀을 때만 제한된 화면 본문을 보내요.
  2. 로그인 필요: 계정 설정의 실제 연결 상태를 확인하고, 만료됐다면 다시 연결해 주세요.
  3. 카드가 안 보임: 페이지 켜기 상태와 웹사이트 접근 권한을 확인하고, 업데이트 전에 열어 둔 페이지라면 새로고침해 주세요.
  4. 검색 지연·실패·호출 제한: 결과나 오류를 확인한 뒤 필요한 조회만 다시 시도해 주세요. AI 결과는 틀릴 수 있으므로 중요한 표현은 다시 확인해 주세요.
  5. 공유하거나 보내고 싶지 않은 글은 선택 검색·요미가나 적용을 실행하지 마세요. AI 사용은 무료·무제한이라고 가정하지 말고 서비스의 현재 제한과 안내를 확인해 주세요.

확장 계정은 앱의 로그인 쿠키를 자동으로 가져오지 않아요. 브라우저 프로필이나 개인정보 보호 설정에 따라 연결 상태가 달라질 수 있어요.

개인정보 처리방침 문의하기

안내 확인일: 2026년 10월 26일. 브라우저와 운영체제 버전에 따라 설정 이름이 다를 수 있어요.