Karakeep 0.33.1 공개…시맨틱 검색·모바일 오프라인 읽기 도입

Karakeep 공식 GitHub 릴리스에 따르면 오픈소스 북마크 관리 도구 Karakeep 0.33.1이 2일 공개됐다. 이번 버전은 임베딩 기반 시맨틱 검색과 모바일 오프라인 읽기를 도입하고, AI 에이전트가 저장 콘텐츠를 다룰 수 있는 인터페이스를 넓혔다.

검색 방식은 기존 전문 검색과 새 시맨틱 검색, 두 결과를 결합하는 하이브리드 검색으로 나뉜다. 시맨틱·하이브리드 검색은 아직 실험 기능이다. 임베딩을 사용하려면 Meilisearch 1.13 이상이 필요하며, 기존 북마크에는 관리 화면에서 임베딩을 다시 생성해야 한다. 모델이나 임베딩 차원을 바꾸는 경우에도 전체 재생성이 필요하다.

자동 태깅도 임베딩을 활용한다. 새 북마크와 의미가 비슷한 기존 자료를 찾아 이미 사용한 태그를 대규모 언어모델 프롬프트에 제안하는 방식이다. 같은 개념이 서로 다른 표기의 태그로 흩어지는 문제를 줄이려는 변화다.

에이전트 연동 범위는 더 넓어졌다. Karakeep의 MCP 서버 도구는 8개에서 29개로 늘었고 목록·태그 생성, 조회, 수정, 삭제와 하이라이트, 북마크 삭제, 자산 조회 기능이 추가됐다. 새 콘텐츠 API는 저장한 기사의 본문을 마크다운이나 일반 텍스트로 반환하며, 문단 경계를 기준으로 나눈 커서 페이지네이션을 지원한다. 시맨틱 검색은 API와 MCP, 명령줄 인터페이스에서도 사용할 수 있다.

모바일 앱에는 저장한 기사 전체를 기기에 내려받는 오프라인 읽기가 들어갔다. 최근 방문한 북마크 목록과 태그, 하이라이트 등은 7일 동안 기기에 보관된다. 다만 프로젝트 측은 모바일 앱과 브라우저 확장 프로그램 변경이 각 스토어 심사를 거쳐야 하므로 실제 제공 시점이 며칠 늦어질 수 있다고 밝혔다.

보안 수정도 함께 포함됐다. 크롤러의 SSRF 방어에서 DNS 리바인딩과 검사·사용 시점 차이를 악용할 수 있는 문제를 고쳤고, API 키와 서명 자산 토큰 비교에는 타이밍 안전 비교를 적용했다. 북마크 URL 스킴 제한, 내보내기와 이메일의 HTML 이스케이프, 로그인 시도 제한과 계정 존재 여부 노출 차단도 반영됐다. 로그인 제한은 RATE_LIMITING_ENABLED 설정을 켜야 작동한다.

이번 릴리스는 Karakeep를 단순 저장 도구에서 임베딩 검색과 에이전트 연동을 갖춘 개인 지식 저장소로 확장하는 업데이트다. 다만 의미 기반 검색의 정확도와 기존 자료 임베딩에 드는 시간·비용은 사용 환경에 따라 달라질 수 있다.

출처: Karakeep 공식 GitHub 릴리스 https://github.com/karakeep-app/karakeep/releases/tag/v0.33.1