모바일 연동
이 페이지에서는 Social Archiver 모바일 앱에서 설정하는 외부 서비스 연동인 Immich·Raindrop·Notion·Reader·Karakeep을 설명합니다. Instagram 저장과 기기 로컬 로그인 세션은 Instagram 플랫폼 가이드를 참고하세요.
Instagram 가이드 이동
Instagram은 이제 별도 플랫폼 가이드에서 모바일·데스크톱 세션, Chrome 가져오기, 스토리, 구독, Immich 내보내기를 함께 설명합니다.
한눈에 보기
| 연동 | 상태 | 적합한 용도 | 연결 방식 |
|---|---|---|---|
| Immich | 사용 가능 | 아카이브된 사진·영상을 self-hosted 미디어 라이브러리로 보내기 | Immich 서버 URL, API key, 앨범 |
| Raindrop | 모바일 앱에 표시될 때 사용 가능 | 북마크 가져오기와 새 아카이브 링크 내보내기 | Raindrop OAuth |
| Notion | 사용 가능 | 아카이브된 포스트와 페이지를 Notion 데이터베이스로 모으기 | 모바일 앱의 Notion OAuth |
| Reader | 모바일 앱에 표시될 때 사용 가능 | Readwise Reader 읽기 목록으로 아카이브 보내기 | Readwise access token |
| Karakeep | Beta, 모바일 앱에 표시될 때 사용 가능 | self-hosted 북마크 매니저에 아카이브 저장 | Karakeep 서버 URL과 API key |
모바일 앱의 Reader는 Readwise Reader를 의미합니다. 필요한 연동이 설정에 보이지 않는다면 먼저 모바일 앱을 최신 버전으로 업데이트하세요. 일부 연동은 앱 빌드나 rollout 상태에 따라 표시될 수 있습니다.
연결 전 확인
- Social Archiver 모바일 앱을 설치하고 로그인합니다.
- Settings -> Integrations를 엽니다.
- 완료된 아카이브를 Notion 및 다른 연결된 client로 자동 동기화하려면 Auto-sync를 켜 둡니다.
- Immich, Raindrop, Reader, Karakeep은 각 연동의 자동 저장 설정을 사용합니다.
- client sync를 WiFi에서만 실행하려면 WiFi only를 켭니다.
각 서비스에는 별도의 승인, token 또는 API key가 필요합니다.
Immich
Immich 연동은 완료된 Social Archiver 아카이브의 미디어를 self-hosted Immich 서버의 앨범으로 보냅니다. 아카이브 하나를 수동으로 저장하거나, 새 모바일 아카이브의 미디어를 자동 업로드하거나, 서버 동기화 연결을 사용해 구독 미디어를 자동 내보낼 수 있습니다.
모바일에서 Immich 연결
- Immich의 Account Settings → API Keys에서 API key를 만듭니다.
- Social Archiver 모바일 앱에서 설정 → 연동 → Immich를 엽니다.
- Immich 서버 URL과 API key를 입력합니다.
- 앨범을 입력하거나 선택합니다. 없는 앨범은 Social Archiver가 만들 수 있습니다.
- 연결을 누릅니다. 앱은 저장 전에 credential을 검증합니다.
휴대폰에서 해당 주소에 접근할 수 있다면 사설망, Tailscale, http:// 주소도 수동 저장과 모바일 자동 업로드에 사용할 수 있습니다. scheme이 없는 hostname은 HTTPS로 처리되므로 필요한 경우 http://를 명시하세요.
미디어 저장
- 아카이브 action menu에서 Save to Immich를 눌러 하나를 저장합니다.
- 아카이브를 여러 개 선택해 Immich 일괄 내보내기를 실행합니다.
- 새 미디어 자동 업로드를 켜고 허용할 플랫폼을 선택해 새 모바일 아카이브의 미디어를 자동으로 보냅니다.
- 연결된 Immich 설정에서 기본 앨범을 선택하거나 새로 만듭니다.
아카이브에 내려받을 수 있는 미디어가 있어야 합니다. 같은 자산을 식별할 수 있는 경우 Immich 중복 검사를 거쳐 다시 업로드하지 않고 이미 저장됨으로 안내합니다.
모바일 전용과 서버 동기화
| 연결 상태 | 모바일 수동 저장 | 모바일 자동 업로드 | 구독 자동 내보내기 |
|---|---|---|---|
| 모바일 전용 | 휴대폰에서 Immich에 접근할 수 있을 때 가능 | 휴대폰에서 접근할 수 있을 때 가능 | 불가 |
| 서버 동기화 | 가능 | 가능 | 가능 |
구독 작업은 Social Archiver 서버에서 실행됩니다. 따라서 public HTTPS endpoint, Cloudflare Tunnel, Tailscale Funnel처럼 Social Archiver 서버가 접근할 수 있는 Immich URL이 필요합니다. 사설망·Tailscale 전용 URL이 휴대폰에서는 동작하지만 서버에서 접근할 수 없다면, 수동 내보내기를 막지 않고 연결을 모바일 전용으로 유지합니다.
로컬 전용 사용 시 API key는 모바일 보안 저장소에 보관됩니다. 서버 동기화에 성공하면 예약된 구독 내보내기를 위해 암호화된 사본을 서버에 저장합니다. API key는 분석 정보나 로그에 포함하지 않습니다.
Chrome에서 Immich 사용
Chrome 확장에는 Settings → Immich Direct Upload의 별도 직접 연결이 있습니다. 서버 URL과 API key를 입력하고 앨범을 선택하거나 만든 뒤, 지원되는 Instagram 가져오기 미디어나 키즈노트 백필을 Chrome에서 Immich로 직접 업로드할 수 있습니다. 확장은 API key를 해당 Chrome 프로필에 보관하며, 직접 업로드에는 Social Archiver 서버 연결이 필수가 아닙니다.
고화질 영상과 음성이 분리된 소스는 Local Media Helper로 합친 뒤 업로드할 수 있습니다.
Immich 연결 해제
연결을 해제하면 저장한 credential을 지우고 이후 내보내기를 중지합니다. Immich에 이미 올린 asset은 삭제되지 않습니다.
Raindrop
Raindrop 연동은 양방향으로 동작합니다. 선택한 Raindrop 북마크를 Social Archiver에 아카이브하고, 새 Social Archiver 아카이브 링크를 Raindrop으로 다시 보낼 수 있습니다.
연결과 설정
- 설정 → 연동 → Raindrop을 엽니다.
- 연결을 누르고 Raindrop OAuth 요청을 승인합니다.
- 새 북마크를 자동으로 확인할지 선택합니다.
- 구독 아카이브를 포함한 자동 내보내기가 필요하면 새 아카이브를 Raindrop에 저장을 켭니다.
- Social Archiver가 내보낸 링크를 다시 가져오지 않도록 내보낸 항목 제외를 켜 둡니다.
지금 가져오기에서는 북마크를 미리 보고, 검색하거나 collection별로 필터링한 뒤 지금 아카이브할 항목을 선택할 수 있습니다. 아카이브 action menu의 Save to Raindrop으로 하나를 보내거나 일괄 내보내기로 여러 개를 보낼 수도 있습니다. 내보낸 링크에는 Social Archiver와 플랫폼 tag가 붙습니다.
연결을 해제하면 이후 가져오기·내보내기를 중지하지만 기존 Raindrop 북마크나 Social Archiver 아카이브는 삭제하지 않습니다.
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는 삭제되지 않습니다.
자동 저장과 수동 저장
자동 내보내기는 아카이브 완료 후 실행됩니다. Immich, Raindrop, Reader, Karakeep의 수동 저장 action은 해당 연동에 필요한 데이터가 있는 경우 archive action menu에 표시됩니다.
Raindrop, Reader, Karakeep 같은 URL 기반 서비스는 다음 조건을 확인합니다.
- 연동이 연결되어 있고 enabled 상태임
- 아카이브에 original URL이 있음
- 해당 integration 설정에서 platform이 제외되어 있지 않음
- 모바일 기기가 online 상태임
Immich는 내려받을 수 있는 미디어와 접근 가능한 서버가 필요합니다. Raindrop, Reader, Karakeep은 이미 존재하는 item을 감지할 수 있으며, 이 경우 중복을 새로 만들지 않고 이미 저장됨으로 안내합니다.
문제 해결
| 문제 | 확인할 내용 |
|---|---|
| 연동 row가 보이지 않음 | 모바일 앱을 최신 버전으로 업데이트하세요. Reader와 Karakeep은 지원되는 build 또는 rollout group에서만 표시될 수 있습니다. |
| Immich가 연결을 거부함 | 전체 서버 URL을 확인하고 Immich Account Settings → API Keys에서 새 API key를 만드세요. 휴대폰에서 서버에 접근 가능한지도 확인하세요. |
| 모바일에서는 Immich가 되지만 구독에서 안 됨 | 모바일 전용 연결입니다. Social Archiver 서버가 접근할 수 있는 public HTTPS Immich URL로 바꾸고 서버 동기화를 다시 시도하세요. |
| Immich 업로드할 asset이 없음 | 아카이브에 사진·영상이 있는지, 원본 미디어 URL이 만료되지 않았는지 확인하세요. |
| Raindrop 연결이 만료됨 | 설정 → 연동 → Raindrop에서 OAuth로 다시 연결하세요. |
| 내보낸 Raindrop 링크가 다시 들어옴 | Raindrop 설정에서 내보낸 항목 제외를 켜세요. |
| 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에 연결되어 있는지 확인하세요. |