인앱 브라우저에서는 카메라/위치 권한이 매번 다시 묻거나 작동하지 않을 수 있어요.
iOS: 우측 상단 ⋯ 또는 ↗ 메뉴 → "Safari로 열기" / "다른 브라우저로 열기"
Android: 우측 상단 ⋯ 메뉴 → "다른 브라우저로 열기" 또는 "Chrome으로 열기"
와이파이 연결 전엔 인터넷이 없어서 Claude API 호출이 안 돼요. 카페에 가기 전 미리 OCR 모델을 받아두면 오프라인에서도 추출됩니다.
사진 한 장으로
와이파이 끝.
카페 와이파이 정보를 찍으면 SSID 추출 · QR 생성 · 데스크톱 명령어까지 한 번에.
PC 마이크로 폰의 소리를 수신합니다. 폰 결과 화면의 "🔊 PC로 소리 전송" 버튼을 PC 근처에서 눌러주세요.
처음 한 번 마이크 권한을 묻습니다.
수신 대기 중... 폰에서 "PC로 소리 전송"을 눌러주세요.
수신 완료!
잠시 후 결과 화면으로 이동합니다.
테이블 카드 · 스티커 · 메뉴판 · 영수증 모두 OK
SSID와 비밀번호를 JSON으로 정확히 분리
폰 QR · 노트북 명령어 · 친구한테 링크 한 줄
폰 카메라로 QR을 비추면 바로 접속됩니다.
PC 측에서 Wifi Snap을 열고 "🎧 소리로 받기 (PC 모드)"를 먼저 활성화해야 합니다.
연결됐는데 인터넷이 안 되나요? 포털 페이지 열기 ↗
이 와이파이에 연결된 상태에서 측정해주세요. 약 6-10초.
macOS
터미널에 붙여넣고 실행. en0이 아니면 networksetup -listallhardwareports로 확인.
Windows
관리자 권한 PowerShell에 붙여넣기.
Linux
NetworkManager 환경 기준 (nmcli).
데스크톱 CLI (한 줄 연결)
PC에 wifi-snap CLI를 한 번 설치하면, 다음부턴 공유 URL 하나로 즉시 연결됩니다.
(폰에서 본인 카톡으로 URL 보낸 뒤 PC에서 붙여넣는 흐름)
완전 오프라인 PC를 와이파이에 붙이는 대안
- 폰 핫스팟 5초만 — 폰 설정 → 개인용 핫스팟 ON → PC가 폰 인터넷으로 잠깐 연결 →
wifi-snap실행 → 카페 와이파이로 전환. 끝나면 핫스팟 꺼도 됨. - Apple 끼리 — 폰에서 SSID/PW 복사 → macOS Continuity 클립보드로 Mac에 자동 동기화 → Mac 터미널에 붙여넣기. AirDrop도 가능.
- 직접 타이핑 — 폰 화면 보면서 손으로 입력. 위 결과 화면의 SSID/PW 박스를 확대해서 보세요.
1. PC에 한 번 설치 (macOS / Linux)
1. PC에 한 번 설치 (Windows PowerShell)
2. 이 와이파이 적용
2-bis. 또는 한 번 클릭으로 (v0.11+)
인스톨러가 OS에 wifi-snap:// 스킴을 등록합니다. 아래 링크를 클릭하면 (Slack/이메일/Notion 등 어디든)
별도 터미널 없이 자동으로 wifi-snap이 실행되어 연결됩니다.
※ wifi-snap CLI는 외부 서버 호출 없음. URL 안의 SSID/PW만 디코드해서
OS별 와이파이 연결 명령(networksetup / netsh / nmcli)으로 변환합니다.
자세한 사용법: cli/README
기록
이 브라우저에 최근 50개까지 저장됩니다.
지도
기록된 위치별 와이파이. 핀을 탭하면 SSID/속도 정보가 떠요.
설정에서 "위치 기억"을 켜고 새 카페에서 추출하면 여기에 핀이 찍힙니다.
설정
모델
OCR 수준의 작업이라 Haiku로 충분합니다. 이상하게 추출되면 Sonnet으로 전환.
카카오톡 공유 (선택)
설정하면 결과 화면에 "카톡" 공유 버튼이 나타나고, 썸네일·버튼이 포함된 깔끔한 공유 카드로 전송됩니다.
설정 안 해도 일반 "공유" 버튼으로 카톡 전송 가능합니다(시스템 공유 시트 경유).
키 발급 절차:
1. Kakao Developers에서 앱 생성
2. 앱 설정 → 플랫폼 → Web 에 사이트 도메인 등록
(https://iq-agent-lab.github.io)
3. 제품 설정 → 카카오톡 공유 활성화
4. 앱 키 → JavaScript 키를 위 칸에 붙여넣기
위치 기억
추출할 때 현재 위치(좌표)를 함께 저장합니다. 다음에 같은 카페에 오면 사진 없이 자동으로 와이파이 정보가 떠요. 위치는 이 브라우저에만 저장됩니다.
오프라인 OCR (Tesseract)
Claude API 호출이 실패하면 자동으로 브라우저 안의 Tesseract OCR + 로컬 파서로 전환합니다.
API 키가 없어도 추출 가능. 단, Claude보다 정확도는 낮으므로 결과를 확인 후 직접 수정이 필요할 수 있어요.
중요: 카페에 가기 전에 인터넷 있는 곳에서 한 번 모델을 다운받아 두세요.
한 번 받으면 브라우저에 영구 저장되어 이후엔 오프라인에서 작동합니다.
네트워크 인터페이스 (macOS)
기본 en0. M1/M2 Mac에서 dock 사용 시 en7 등일 수 있음.
앱 설치
카메라 권한
카메라 권한은 처음 한 번만 묻습니다. 매번 묻는다면 주소창 카메라 아이콘에서 "항상 허용"으로 변경하거나, 홈 화면에 앱을 설치하면 더 안정적으로 동작합니다.