Yadorigi(宿り木) — X 북마크를 AI로 정리하는 로컬 OSS를 공개했습니다

Yadorigi란

X(구 Twitter)에서 북마크하거나 '좋아요'를 누른 트윗을 로컬에서 관리 및 정리하는 OSS(Open Source Software) 도구입니다.

모든 데이터는 사용자의 머신에 있는 SQLite 데이터베이스에 저장됩니다. 클라우드 없음, 외부 서버 없음.

만든 이유

X에서 북마크나 '좋아요'를 해도 나중에 활용하지 못하는 경우가 많다고 느꼈습니다.

• 검색하려고 해도 묻혀버림
• "그 트윗 어디 갔지?"라는 상황이 일상적으로 발생
• 읽음·읽지 않음·나중에 읽기 등의 관리가 불가능
• 재미있다고 생각했는데, 어떤 행동으로 이어지지 못한 채 잊어버림

이를 해결하기 위해 만들었습니다.

주요 기능

🤖 4단계 AI 파이프라인 (AI Pipeline)

임포트(Import)한 트윗을 자동으로 분석 및 정리합니다.

이미지 분석 (Vision) — 첨부 이미지·GIF·동영상에서 텍스트나 컨텍스트(Context)를 추출 -
엔티티 추출 (Entity Extraction) — 해시태그·URL·도구 이름을 무료로 추출 (API 불필요) -
시맨틱 태그 생성 (Semantic Tag Generation) — 검색용 태그를 30~50개 자동 생성 -
카테고리 자동 분류 (Automatic Categorization) — 내용에 기반하여 적절한 카테고리로 할당

Anthropic Claude API 또는 OpenAI API를 지원합니다.

📋 칸반 뷰 (Kanban View)

TO_READ / IN_PROGRESS / DONE / EVERGREEN 의 4가지 상태로 트윗을 관리합니다.

드래그 앤 드롭으로 한 건씩 이동할 수 있을 뿐만 아니라, 체크박스로 여러 개를 선택하여 일괄 이동도 가능합니다. 카드에 커서를 올리면 왼쪽 상단에 체크박스가 표시되며, 선택하면 플로팅 바(Floating bar)를 통해 이동할 곳을 원클릭으로 지정할 수 있습니다.

⚡ ActionLink

북마크에 '액션(Action)'을 연결할 수 있습니다. "이 도구를 시도해 보기", "이 트윗을 참고하여 블로그 쓰기"와 같은 다음 단계(Next step)를 트윗에 직접 연결하여 관리할 수 있습니다.

🔍 AI 검색

시맨틱 태그(Semantic tag)를 사용한 의미론적 검색이 가능합니다. "TypeScript 테크닉"과 같이 자연어로 검색할 수 있습니다.

🗺️ 마인드맵 (Mind Map)

카테고리와 태그의 관계를 마인드맵으로 시각화할 수 있습니다.

🔐 DB 암호화

SQLCipher를 통해 데이터베이스를 기본적으로 암호화합니다.

🇯🇵 일본어 퍼스트 UI

대시보드·칸반·목록·카테고리·AI 검색·임포트 등 모든 화면이 일본어에 대응하고 있습니다. 영어로의 전환도 가능합니다.

임포트 방법

X API는 유료 플랜($200/월~)이 필요하기 때문에, 북마크릿(Bookmarklet) 방식을 권장합니다.

임포트 페이지에서 북마크릿을 가져와 북마크 바에 추가합니다. x.com/i/bookmarks에서 클릭하면 X의 내부 API를 인터셉트(Intercept)하여 작성자 정보가 포함된 모든 트윗을 자동으로 캡처하고 JSON 파일을 다운로드합니다. 그 파일을 업로드하기만 하면 됩니다.

기술 스택 (Tech Stack)

용도	채택 기술
프레임워크	Next.js 16 + TypeScript
...

Siftly로부터의 포크 (Fork)

본 프로젝트는 @viperrcrypto 님의 Siftly를 기반으로 구축되었습니다. Vision 분석·마인드맵·AI 검색 등의 핵심 기능은 Siftly로부터 계승했습니다. MIT 라이선스에 따라 귀속을 명시합니다.

셋업 (Setup)

git clone https://github.com/kake-nami/yadorigi.git
cd yadorigi
npm install
...

http://localhost:3000에서 실행합니다.

이런 분들에게 적합합니다

• 일본어 X를 매일 사용하는 지식 노동자 (엔지니어·라이터·연구자·PM)
• 저장한 트윗을 나중에 활용하고 싶은 분
• 데이터를 로컬에 두고 싶은 분 (클라우드 SaaS 불필요)
• 셀프 호스팅(Self-hosting) 경험이 있는 분

그 외에는 뭐, 규칙에 따라 자유롭게 사용하세요.

Discussion