Skip to content

Chrome 확장

Social Archiver Chrome 확장은 데스크톱 브라우징 중 빠르게 캡처하기 위한 클라이언트입니다. Obsidian 플러그인, 모바일 앱, 웹 앱과 같은 Social Archiver 계정을 사용합니다.

설치

  1. Chrome Web Store에서 Social Archiver 설치
  2. 확장 팝업 열기
  3. 이메일 주소로 로그인
  4. Obsidian 플러그인이나 모바일 앱과 같은 아카이브 라이브러리를 쓰려면 동일한 이메일로 로그인

지원 URL 아카이브

현재 탭이 지원되는 소셜 포스트나 소스 페이지라면 Archive Current Page를 사용하세요. 확장은 URL을 Social Archiver에 제출하고, 백그라운드 작업을 추적하며, 결과를 팝업 기록에 표시합니다.

더 빠르게 저장하려면 다음 방법을 사용할 수 있습니다:

  • 키보드 단축키: Ctrl+Shift+S(Mac은 Cmd+Shift+S)
  • 우클릭 메뉴: 현재 페이지 또는 링크에서 Archive to Social Archiver
  • 활성 아이콘 상태: 현재 페이지가 아카이브 가능하면 확장 아이콘이 바뀝니다

웹 클리핑

일반 웹 페이지는 Archive 대신 Clip을 사용하세요. 클리핑은 읽기 좋은 본문을 추출하고, 사이드 패널 미리보기를 열어 제목, Markdown 본문, 개인 노트를 저장 전에 편집할 수 있게 합니다.

아티클, 블로그 포스트, 문서, 플랫폼 전용 아카이버가 처리하지 않는 일반 웹 페이지에 적합합니다.

Instagram 저장 게시물 가져오기

instagram.com에서 팝업을 열면 Import Instagram Saved Posts가 표시될 수 있습니다. 이 기능은 Instagram 브라우저 세션과 비공개 웹 API 동작에 의존하므로 beta로 표시됩니다.

시작 전에 가져오기 대상 흐름을 선택합니다:

  • Desktop / Obsidian: 확장이 선택한 저장 게시물, 미디어 파일, import manifest를 ZIP 파일로 내려받습니다. Obsidian 플러그인에서 이 ZIP 파일을 선택하면 vault 안에 Markdown 노트와 attachment를 만들고, 동시에 Social Archiver 계정에도 archive를 등록합니다.
  • Web: 확장이 선택한 저장 게시물을 Social Archiver 계정으로 바로 업로드합니다. ZIP 파일은 만들지 않습니다. 처리 후 웹 앱에서 바로 볼 수 있고, Obsidian에서는 나중에 Sync Existing Archives로 가져올 수 있습니다.

주요 동작:

  • 가져올 저장 컬렉션을 직접 선택
  • 선택한 미디어를 브라우저에서 먼저 로컬 다운로드한 뒤 ZIP에 넣거나 Social Archiver로 업로드
  • 가져오기 작업 일시정지 및 재개 가능
  • Instagram이 계정 확인을 요구하거나 웹 API를 변경하면 일시적으로 동작하지 않을 수 있음

Reddit 저장 게시물 가져오기

reddit.com/user/yourname/saved 같은 Reddit saved 페이지에서 팝업을 열면 Import Reddit Saved Posts가 표시될 수 있습니다. 이 기능도 Reddit saved listing 페이지와 현재 브라우저 세션에 의존하므로 beta로 표시됩니다.

Reddit saved import는 현재 Social Archiver 계정으로 바로 업로드합니다. Obsidian용 ZIP export는 만들지 않습니다. 서버 import가 완료되면 웹 앱에서 볼 수 있고, Obsidian에서는 Sync Existing Archives로 동기화할 수 있습니다.

주요 동작:

  • 브라우저에 로그인된 Reddit 세션을 기준으로 저장한 게시물과 저장한 댓글을 발견
  • 지원되는 미디어를 브라우저에서 다운로드한 뒤 Social Archiver media pipeline으로 업로드
  • 저장한 댓글은 Reddit comment archive로 보존하고, 저장한 게시물은 가능한 thread comment를 함께 보존
  • 팝업에서 일시정지, 재개, 실패 항목 재시도, 폐기 가능
  • 지원하지 않는 Reddit 항목이나 사용할 수 없는 미디어는 건너뛰거나 warning이 있는 상태로 가져올 수 있음

X (Twitter) 북마크 가져오기

x.com/i/bookmarks(또는 twitter.com/i/bookmarks)에서 팝업을 열면 Import X Bookmarks가 표시될 수 있습니다. X bookmarks GraphQL 엔드포인트와 현재 브라우저 세션에 의존하므로 beta로 표시됩니다.

X bookmarks import는 Social Archiver 계정으로 바로 업로드합니다. Obsidian용 ZIP export는 만들지 않습니다. 서버 import가 완료되면 웹 앱에서 볼 수 있고, Obsidian에서는 Sync Existing Archives로 동기화할 수 있습니다.

주요 동작:

  • 현재 페이지에 대해 X가 이미 발행한 bookmarks GraphQL 응답을 가로채 수집하며, 확장이 API를 대신 호출하지 않음
  • 링크 미리보기 카드(이미지 + 목적지 URL), 인용 트윗, X article, 사진, 지원되는 영상 보존
  • 팝업에서 발견(Discovery), 보관(Archive)을 일시정지, 재개, 실패 항목 재시도, 폐기 가능
  • 메인 팝업에 "ready / in progress / paused" 배너가 표시되어 북마크 페이지를 다시 열지 않아도 작업으로 돌아갈 수 있음
  • cursor가 남은 상태로 discovery가 멈추면 추가 북마크가 있을 수 있음 — 현재 import를 먼저 완료한 뒤 Discovery를 다시 실행하세요
  • v1에서는 X 사용자 핸들을 항상 추출할 수 없으므로 UI에 계정 이름 대신 unknown이 표시될 수 있습니다

브라우저 세션 개인정보

Instagram, Reddit, X saved-post / bookmarks import는 사용자의 로컬 Chrome 프로필에 이미 존재하는 브라우저 세션을 사용합니다. 확장은 instagram.com, reddit.com, x.com에 대해 Chrome이 이미 가진 cookie와 session 상태를 사용해 브라우저 안에서 저장 목록이나 북마크 응답을 읽고 (Instagram과 Reddit의 경우) 미디어를 다운로드합니다.

Social Archiver 서버로 Instagram, Reddit, X 비밀번호, cookie, session token, CSRF token, 캡처된 플랫폼 요청 header는 전송하지 않습니다. Web 직접 업로드의 경우 서버는 사용자의 Social Archiver 계정에 archive를 만들기 위해 archive payload, 선택된 미디어 파일, import job metadata, Social Archiver 인증 token만 받습니다. X 북마크의 경우 X 자체 Bookmarks GraphQL 요청의 응답 본문만 전달되며, X 미디어는 그 응답에 담긴 URL을 서버가 직접 다운로드합니다.

설정

확장 옵션 페이지에서 다음을 설정할 수 있습니다:

  • 데스크톱 알림
  • 페이지 안 toast 메시지
  • 아카이브 시 공유 링크 자동 생성
  • Instagram 저장 게시물 가져오기 표시 여부
  • 지원 요청용 debug log 내보내기

Obsidian 및 모바일과 동기화

Chrome에서 만든 아카이브는 Social Archiver 계정에 저장됩니다. 처리 후 다음 위치에 나타날 수 있습니다:

  • 웹 앱에는 처리 후 바로 표시
  • 모바일 앱에는 Auto Sync를 통해 표시
  • Obsidian vault에는 플러그인이 연결되어 있고 Obsidian이 열려 있을 때, 또는 Sync Existing Archives 실행 후 표시

문제 해결

이 페이지를 아카이브할 수 없음

chrome://, chrome-extension://, about: 같은 브라우저 내부 페이지는 아카이브하거나 클립할 수 없습니다. 일반 http 또는 https 페이지를 여세요.

일반 페이지가 Clip 모드로 열림

정상 동작입니다. 플랫폼 전용 URL은 Archive를 사용하고, 일반 웹 페이지는 저장 전 추출된 Markdown을 검토하고 편집할 수 있도록 Clip을 사용합니다.

Instagram 가져오기가 보이지 않음

먼저 Instagram 탭을 열고, 브라우저에서 Instagram에 로그인되어 있는지 확인한 뒤, 확장 옵션에서 가져오기 기능이 켜져 있는지 확인하세요.

Reddit 가져오기가 보이지 않음

먼저 https://www.reddit.com/user/yourname/saved/ 같은 Reddit saved 페이지를 열고, 브라우저에서 Reddit에 로그인되어 있는지 확인하세요.

X Bookmarks 가져오기가 보이지 않거나 0건 캡처됨

먼저 https://x.com/i/bookmarks를 열고, 브라우저에서 X에 로그인되어 있는지 확인하세요. Discovery가 0건으로 끝났다면 X service worker가 캐시된 응답을 반환했을 수 있습니다 — 잠시 후 다시 시도하거나 북마크 탭을 새로고침하면 해결됩니다. 최근에 많은 북마크 변경이 있었던 계정은 페이지네이션이 일시적으로 제한될 수 있으므로, 자연스럽게 누적된 계정에서 가장 잘 동작합니다.

다음 단계

MIT 라이선스로 배포됩니다.