모바일 연동
모바일 연동은 Social Archiver 모바일 앱에서 완료된 아카이브를 외부 지식 관리 및 읽기 도구로 보내는 기능입니다. 이 연동은 Obsidian 플러그인이 아니라 모바일 앱에서 설정합니다.
현재 모바일 앱에서 제공하는 연동은 Notion, Reader, Karakeep입니다.
한눈에 보기
| 연동 | 상태 | 적합한 용도 | 연결 방식 |
|---|---|---|---|
| Notion | 사용 가능 | 아카이브된 포스트와 페이지를 Notion 데이터베이스로 모으기 | 모바일 앱의 Notion OAuth |
| Reader | 모바일 앱에 표시될 때 사용 가능 | Readwise Reader 읽기 목록으로 아카이브 보내기 | Readwise access token |
| Karakeep | Beta, 모바일 앱에 표시될 때 사용 가능 | self-hosted 북마크 매니저에 아카이브 저장 | Karakeep 서버 URL과 API key |
모바일 앱의 Reader는 Readwise Reader를 의미합니다. Reader 또는 Karakeep이 설정에 보이지 않는다면 먼저 모바일 앱을 최신 버전으로 업데이트하세요. 일부 연동은 앱 빌드나 rollout 상태에 따라 표시될 수 있습니다.
연결 전 확인
- Social Archiver 모바일 앱을 설치하고 로그인합니다.
- Settings -> Integrations를 엽니다.
- 완료된 아카이브를 Notion 및 다른 연결된 client로 자동 동기화하려면 Auto-sync를 켜 둡니다.
- Reader와 Karakeep은 각 연동의 Auto-save 설정을 사용합니다.
- client sync를 WiFi에서만 실행하려면 WiFi only를 켭니다.
각 연동은 같은 Social Archiver 계정을 사용하지만, 외부 서비스는 별도의 승인, token, API key가 필요합니다.
Notion
Notion 연동은 모바일 앱에서 완료된 아카이브를 Notion workspace로 동기화합니다. Social Archiver는 Social Archives 데이터베이스를 만들거나 재사용하고, 각 아카이브를 Notion 페이지로 작성할 수 있습니다.
전송되는 내용
- 아카이브 제목, 플랫폼, 원본 URL, archive ID, 아카이브 날짜
- 작성자, handle, 게시일, 좋아요, 댓글, 공유, 조회수 등 가능한 metadata
- 아카이브 콘텐츠 block과 사용 가능한 media reference
- backend와 Notion file 제한에서 지원되는 경우 video upgrade 처리
Notion 연결
- 모바일 앱을 엽니다.
- Settings -> Integrations로 이동합니다.
- Notion row에서 Connect를 누릅니다.
- Notion 브라우저 인증 흐름에서 Social Archiver를 승인합니다.
- 데이터베이스를 만들 수 있는 workspace 또는 page 접근 권한을 부여합니다.
- 승인이 완료되면 Social Archiver로 돌아옵니다.
연결 후 Notion row에는 연결된 workspace가 표시됩니다. Auto-sync가 켜져 있으면 새로 완료된 아카이브가 자동으로 동기화될 수 있습니다.
Notion 연결 해제
Settings -> Integrations에서 연결된 Notion row를 누르고 연결 해제를 확인합니다. 해당 workspace로의 동기화는 중지되지만, 이미 만들어진 Notion 페이지는 삭제되지 않습니다.
Reader
Reader 연동은 완료된 아카이브를 Readwise Reader에 저장합니다. Social Archiver로 저장한 콘텐츠를 article, newsletter, saved web page와 같은 읽기 queue에서 함께 관리하고 싶을 때 유용합니다.
전송되는 내용
- 원본 URL과 아카이브 제목
- 가능한 경우 작성자, 요약, content 또는 HTML, image URL, notes
- 기본 tag와 선택적인 platform tag
- source에 따라 article, social post, video 등으로 분류되는 Reader category
Reader 연결
- readwise.io/access_token을 열고 access token을 복사합니다.
- Social Archiver 모바일 앱을 엽니다.
- Settings -> Integrations로 이동합니다.
- Reader row에서 Connect를 누릅니다.
- token을 붙여넣고 연결합니다.
Reader 설정
연결된 Reader row를 누르면 다음을 설정할 수 있습니다.
- Auto-save: 아카이브 완료 시 Reader에 저장
- Save Location: Later 또는 New로 저장 위치 선택
- Default Tags: Reader save에 추가할 tag
- Include platform tag: source platform 이름 같은 tag 추가
- Platforms: Reader로 보낼 모바일 archive source 선택
아카이브에 원본 URL이 있고 해당 platform이 허용되어 있으면 archive action menu에서 Save to Readwise를 실행할 수도 있습니다.
Reader 연결을 해제하면 모바일 앱에 저장된 token이 제거됩니다. 기존 Reader item은 삭제되지 않습니다.
Karakeep
Karakeep 연동은 완료된 아카이브를 Karakeep 서버의 bookmark로 저장합니다. self-hosted 읽기 도구나 bookmark workflow를 운영할 때 유용합니다.
전송되는 내용
- 원본 URL과 아카이브 제목
- 가능한 경우 summary 또는 note content
- 기본 tag와 선택적인 platform tag
- Karakeep bookmark로 표현 가능한 archive metadata
Karakeep 연결
- Karakeep에서 Settings -> API Keys로 이동해 API key를 만듭니다.
- Social Archiver 모바일 앱을 엽니다.
- Settings -> Integrations로 이동합니다.
- Karakeep row에서 Connect를 누릅니다.
https://bookmarks.example.com같은 Karakeep 서버 주소를 입력합니다.- API key를 붙여넣고 연결합니다.
모바일 앱은 기본 서버 URL을 받아 Karakeep API 주소로 정규화합니다. /api/v1을 직접 붙일 필요는 없습니다.
Karakeep 설정
연결된 Karakeep row를 누르면 다음을 설정할 수 있습니다.
- Auto-save: 아카이브 완료 시 Karakeep에 저장
- Default Tags: Karakeep bookmark에 추가할 tag
- Include platform tag: source platform 이름 같은 tag 추가
- Platforms: Karakeep으로 보낼 모바일 archive source 선택
아카이브에 원본 URL이 있고 해당 platform이 허용되어 있으면 archive action menu에서 Save to Karakeep을 실행할 수도 있습니다.
Karakeep 연결을 해제하면 모바일 앱에 저장된 credential이 제거됩니다. 기존 Karakeep bookmark는 삭제되지 않습니다.
자동 저장과 수동 저장
Auto-save는 아카이브 완료 후 실행됩니다. Reader와 Karakeep의 수동 저장 action은 다음 조건을 만족할 때 archive action menu에 표시됩니다.
- 연동이 연결되어 있고 enabled 상태임
- 아카이브에 original URL이 있음
- 해당 integration 설정에서 platform이 제외되어 있지 않음
- 모바일 기기가 online 상태임
Reader와 Karakeep은 이미 존재하는 item을 감지할 수 있습니다. 이 경우 모바일 앱은 중복을 새로 만들지 않고 "Already in Reader" 또는 "Already in Karakeep" 메시지를 표시합니다.
문제 해결
| 문제 | 확인할 내용 |
|---|---|
| 연동 row가 보이지 않음 | 모바일 앱을 최신 버전으로 업데이트하세요. Reader와 Karakeep은 지원되는 build 또는 rollout group에서만 표시될 수 있습니다. |
| Notion 연결 실패 | 브라우저 인증이 완료되었는지, Social Archiver가 데이터베이스를 만들 수 있는 Notion page에 접근 권한을 받았는지 확인하세요. |
| Reader token 실패 | readwise.io/access_token에서 새 token을 만든 뒤 다시 붙여넣으세요. |
| Karakeep 연결 실패 | 서버 URL, API key, HTTPS 접근, 휴대폰에서 Karakeep 서버에 접근 가능한지 확인하세요. |
| Notion sync가 실행되지 않음 | Auto-sync가 켜져 있고 Notion 연결이 active 상태인지 확인하세요. |
| Reader 또는 Karakeep auto-save가 실행되지 않음 | 해당 integration의 Auto-save가 켜져 있는지, platform이 허용되어 있는지, 아카이브에 original URL이 있는지, 휴대폰이 online인지 확인하세요. |
| 동기화가 너무 오래 기다림 | WiFi-only sync가 켜져 있는지, 현재 휴대폰이 WiFi에 연결되어 있는지 확인하세요. |