이미지 텍스트 (OCR)

Instagram 캐러셀, 슬라이드, 스레드를 캡처한 스크린샷처럼 내용이 이미지 안에 들어 있는 포스트가 많습니다. Social Archiver는 그 글자를 읽어 포스트와 함께 저장하고, 앱과 내보낸 Markdown, AI 에이전트용 CLI 어디서든 검색할 수 있게 해 줍니다.

직접 실행하는 텍스트 인식은 기기 안에서 처리됩니다. iPhone·iPad·Mac에서는 Apple Vision, Android에서는 Google ML Kit를 씁니다. 이때는 글자를 읽으려고 이미지를 어딘가로 업로드하지 않습니다. 선택 기능인 자동 읽기(아래)는 Cloud AI를 사용합니다. 한국어, 영어, 일본어, 중국어를 인식합니다.

모바일 앱 (iOS, Android)

텍스트 인식은 기본으로 켜져 있습니다.

이미지가 있는 저장된 포스트를 엽니다.
이미지의 Aa 버튼을 누릅니다. 앱이 그 이미지 속 글자를 읽습니다.
노트에 추가를 누르면 저장됩니다. 이미지가 여러 장인 포스트에서는 모두 노트에 추가로 모든 이미지의 글자를 한 번에 저장합니다. 텍스트 복사를 누르면 대신 복사합니다.

설정은 설정 → 이미지 텍스트 인식에 있습니다:

설정	하는 일
텍스트 인식	이미지 텍스트 인식을 켜거나 끕니다
텍스트 자동 감지	이미지에서 글자를 찾으면 Aa 배지를 표시합니다
라이브 텍스트 (iOS 16 이상)	이미지를 길게 눌러 글자를 선택하고 복사합니다

데스크톱 앱 (Mac)

저장된 포스트를 열고 이미지에서 글자 인식을 클릭합니다.
노트에 저장 또는 텍스트 복사를 클릭합니다.

설정은 설정 → 이미지 텍스트에 있습니다:

설정	하는 일
이미지 속 글자 인식	이 Mac의 Apple Vision을 사용합니다
이미지 텍스트 자동 포함	AI와 장소 추출 요청 전에 아직 읽지 않은 이미지 글자를 인식해, 이미지 내용까지 활용하게 합니다

데스크톱 앱의 이미지 텍스트 인식은 macOS에서만 동작합니다.

자동 읽기 (Cloud AI)

모바일 또는 데스크톱 앱의 이미지 텍스트 설정에서 이미지 텍스트 자동 읽기를 켜면, 그때부터 저장하는 모든 포스트의 이미지 속 글자를 자동으로 읽어 노트에 추가합니다. 기기가 하나도 켜져 있지 않아도 됩니다. 포스트당 이미지는 최대 20장까지 읽습니다. 이 설정은 데스크톱 0.10.2, 모바일 2.6.7 이상에 있습니다.

글자가 있는 포스트당 0.1 Cloud 크레딧을 사용하며, 이미지에 글자가 없는 포스트는 무료입니다. Cloud AI로 처리되므로, 글자를 읽기 위해 이미지가 Cloudflare Workers AI로 전송됩니다. Cloud 크레딧이 바닥나면 크레딧이 다시 채워질 때까지 새 포스트를 읽지 않습니다. 이때 모바일 앱이 그달에 한 번 알림을 보내고, 설정에도 일시 중지 상태와 다시 시작되는 날짜가 표시됩니다. Cloud AI 설정을 따르기 때문에 Cloud AI가 꺼져 있으면 읽지 않습니다. 켜기 전에 저장한 포스트는 자동으로 읽지 않으니, 앱이나 social-archiver image-text를 사용하세요.

텍스트가 저장되는 곳

저장한 텍스트는 포스트에 📷 Extracted Text (Image N) 제목의 노트로 붙습니다. N은 포스트 안에서 그 이미지의 순서입니다. 다른 노트처럼 계정에 동기화되므로 모든 앱에서 보입니다. 같은 이미지를 다시 읽으면 노트가 하나 더 생기지 않고 기존 노트를 바꿉니다.

내보낸 Markdown(social-archiver export, 모바일 앱의 Markdown 내보내기)에서는 캡션 옆 Extracted Text (OCR) 섹션에 들어갑니다.
AI 코멘트와 장소 추출에도 포함되어, 이미지 속 내용을 함께 활용합니다.

CLI에서 (AI 에이전트용)

데스크톱 앱이 설치된 Mac에서는 CLI로 이미지 텍스트를 한꺼번에 읽은 뒤 검색하거나 내보낼 수 있습니다:

bash

# 태그가 붙은 포스트의 모든 이미지 글자 읽기 (이미 읽은 이미지는 건너뜀)
social-archiver image-text --tag study

# 포스트 id로 하나 이상 지정. --force는 이미지를 다시 읽음
social-archiver image-text <archiveId> <archiveId> --force

# 서버에서 노트 검색 (이미지 텍스트 포함)
social-archiver search --q "sleep" --scope notes

# 또는 한 번 내보내고 에이전트가 파일을 읽게 하기
social-archiver export --dir ./study --tag study --limit 500
grep -ril "sleep" ./study

image-text는 Social Archiver가 저장해 둔 이미지 사본이 있으면 그것을 읽기 때문에, 플랫폼의 원본 이미지 링크가 만료된 뒤에도 동작합니다. --limit <n>을 주면 포스트 n개 뒤에 멈춥니다. JSON 결과는 포스트마다 saved, skipped(no-image, already-read, no-text), failed 중 하나로 표시합니다. 캐러셀의 이미지 하나를 읽지 못해도 나머지는 저장되고, 실패한 이미지는 failedImages에 나열됩니다.

버전

image-text와 search --scope는 CLI 0.2.2 이상이 필요하고(social-archiver --version으로 확인), image-text는 데스크톱 앱 0.10.2 이상을 통해 Apple Vision을 실행합니다. SERVICE_NOT_READY가 나오면 데스크톱 앱을 설치하거나 업데이트한 뒤 다시 시도하세요. 데스크톱 0.10.2 이하에 들어 있는 sa 도구는 이 명령이 없는 이전 CLI이므로, CLI를 따로 설치하세요.

영상은 screen-text가 화면에 나온 글자를 읽고, transcribe가 말을 트랜스크립트로 만듭니다. 커맨드라인 (CLI)을 참고하세요.

이미지 텍스트 (OCR) ​

모바일 앱 (iOS, Android) ​

데스크톱 앱 (Mac) ​

자동 읽기 (Cloud AI) ​

텍스트가 저장되는 곳 ​

CLI에서 (AI 에이전트용) ​