사용 설명서15단계e 기준

한눈에 보기 어디를 누르면 되나

앱 맨 위에는 사용법·설정 버튼, 맨 아래에는 탭 6개(매물·신규매물·실거래·경매·공시·바로가기)가 있습니다. 목록에서 하나를 누르면 자세한 화면이 열리고, ← 뒤로로 돌아옵니다.

처음 설정 설치 · 서버 연결

앱은 Cloudflare Pages에 올린 화면이고(무료, 올리기 횟수 걱정 없음), 자료는 구글(Apps Script)에서 받아 옵니다. 기기마다 한 번 설치하고 연결하면 됩니다.

폰에 설치

1. 폰 크롬에서 앱 주소(https://○○○.pages.dev)를 엽니다.
2. ⋮ 메뉴 → 홈 화면에 추가(또는 앱 설치)를 누릅니다.

노트북·PC에 설치

1. 크롬에서 앱 주소를 엽니다. 주소는 dash.cloudflare.com → Workers & Pages → 중개 도우미 프로젝트에 나오는 https://○○○.pages.dev 링크입니다.
2. 주소창 오른쪽 끝 설치 아이콘(모니터에 아래 화살표)을 누릅니다. 안 보이면 ⋮ → 전송, 저장, 공유 → 페이지를 앱으로 설치.
3. 작업 표시줄 아이콘을 오른쪽 클릭 → 작업 표시줄에 고정하면 편합니다.

서버 연결 (기기마다 한 번)

1. 앱 위 설정 → 서버 주소에 Apps Script 웹 앱 주소(끝이 /exec)를 넣습니다.
2. 접속키에 12자리 키를 넣습니다. (Apps Script 편집기에서 makeKey를 실행하면 실행 로그에 나옵니다.)
3. 저장하고 연결 확인 → "연결됨"이 나오면 끝입니다.

다른 기기에 설정 한 번에 넣기

1. 설정을 마친 기기에서 설정 → 다른 기기로 설정 보내기 → 설정 링크 만들기.
2. 카톡 등으로 보내기(또는 링크 복사) → 카톡 나와의 채팅으로 보냅니다.
3. 다른 기기에서 그 링크를 크롬으로 열고 확인 → 서버 주소·접속키(와 쇼츠 사무소 정보)가 들어갑니다. 그 화면에서 앱을 설치하면 됩니다.

매물 매물통합장부 보기 전용 · 최근 수정

매물통합장부를 폰에서 찾아보는 화면입니다. 앱에서는 장부를 고칠 수 없게 해 두었습니다 (실수로 바뀌는 것을 막으려고). 고치는 것은 구글 시트에서 합니다.

매물 목록

• 위의 종류 칩(전체·상가·원투룸·토지…)으로 종류를 고릅니다.
• 검색: 주소·건물명·연락처·비고 글자로 찾습니다. 상태·거래·정렬도 고를 수 있습니다.
• 가격·면적 조건을 열면 매매가·보증금·월세 이하, 면적 이상으로 거를 수 있습니다 (만원·평 단위).
• 매물을 누르면 상세가 열립니다: 장부에서 열기, 📄 브리핑 만들기, 🎬 쇼츠 만들기.

최근 수정

• 1시간마다 장부를 비교해서 바뀐 칸(이전 값 → 새 값), 새로 생긴 매물, 지워진 매물을 기록합니다.
• 처음 한 번 Apps Script 편집기에서 setupLedgerWatch를 실행해야 켜집니다.
• "수정 확인이 ○시간째 멈춰 있습니다"가 보이면 Apps Script의 트리거(scanLedger)를 확인하세요.

매물 접수 폴더 · 건축물대장 · 통화 → 접수대기

노트북에 만든 매물 폴더(공부·사진)와 통화 녹음 텍스트로 장부 한 줄을 미리 채워 줍니다. 확인한 뒤 장부에 붙여넣기만 하면 됩니다.

쓰는 법

1. 노트북 '부동산 사진' 폴더 아래 유형 / 동·리 / 매물 폴더를 만들고 공부(건축물대장·토지대장·토지이음)와 사진을 넣습니다. 구글 드라이브에 올라가면 앱에 나옵니다 (최근 60일).
2. 앱 매물 탭 → 📥 접수 (또는 바로가기 → 매물 접수).
3. 통화 내용: 통화 녹음 앱에서 공유 → 중개 도우미로 보내거나, 글을 복사해 붙여넣기를 누릅니다.
4. 장부에 없는 새 매물 폴더에서 폴더를 누르면 초안이 만들어집니다. 폴더가 없으면 폴더 없이 접수에서 종류·동·지번을 넣습니다.
5. 칸 색을 보고 확인합니다 (아래 표).
6. 필요하면 층·호를 고치고 건축물대장 다시 조회, 통화 내용을 고치고 AI로 채우기를 누릅니다.
7. 저장하면 중개 도우미 시트의 접수대기_종류 탭(예: 접수대기_상가)에 들어갑니다.

장부로 옮기기 (노트북)

1. 초안 화면의 접수대기_종류 탭 열기 링크를 누릅니다.
2. 그 줄의 A칸부터 노란 '◀ 여기까지 복사' 칸 바로 앞까지 골라 복사합니다 (Ctrl+C).
3. 매물통합장부 ○○ 탭 열기 → 맨 아래 빈 줄 A칸을 누르고 붙여넣습니다 (Ctrl+V).
4. 평·평당가 같은 자동계산 칸도 장부와 같은 수식으로 함께 붙습니다. 앱이 곧 장부에 옮김으로 바꿉니다.

폴더 이름 요령

• 동·리와 지번을 넣어 주세요. 예: 단계동 1196-2 1층상가, 흥업리 233-2 202호
• 집합건물(구분상가·오피스텔)은 호수까지: 반곡동 1890 1층 104호 → 그 호의 전용·공용면적을 찾습니다.
• 도로명만 있는 폴더(이화6길 21 302호)는 지번을 비워 두어도 됩니다. 폴더에 건축물대장·토지대장 PDF가 있으면 AI가 지번을 찾아 조회합니다.
• 횡성군 매물은 횡성군 둔내면 두원리 748-3처럼 군 이름부터 적으면 확실합니다.

알아두기

• 건축물대장 숫자가 통화 내용보다 우선입니다. 서로 다르면 AI 메모(노란 글씨)로 알려 줍니다.
• 전화번호는 Gemini에 보내기 전에 가리고, 연락처 칸에는 앱이 직접 넣습니다. 이름과 서류 내용은 Gemini 무료 등급으로 보내집니다.
• 다가구·단독 같은 일반건축물은 호별 면적이 대장에 없습니다 (층별 면적만 나옴).
• 토지는 건축물대장 대신 토지대장·토지이음 서류를 AI가 읽어 채웁니다.
• 통화 녹음 앱이 글이 아니라 파일로 공유하면 앱이 받지 못합니다 → 글을 복사해 붙여넣으세요. 번호를 말로 적은 경우("공일공…")는 가리지 못합니다.
• 종류가 틀리면(예: 상가주택 폴더인데 원투룸) 초안 화면의 매물 종류를 바꾸면 됩니다.
• 앱은 장부 파일에 직접 쓰지 않습니다. 장부로 옮기는 것은 항상 사람이 합니다.

신규매물 네이버 바로보기 · 저장한 매물

네이버 바로보기

• 원주·유형·최신순으로 맞춰 둔 네이버 부동산 화면을 버튼 하나로 엽니다. 누를 때마다 마지막 확인 시각이 남아 어디까지 봤는지 알 수 있습니다.
• 버튼 주소 넣기: 폰 크롬에서 m.land.naver.com → 원주·거래·매물유형 고르고 최신순 → 크롬 공유 → 중개 도우미 → 저장 화면 맨 아래 바로보기 주소로 쓰기.
• PC의 new.land.naver.com 주소는 폰에서 열리지 않습니다. 꼭 폰에서 만든 주소를 넣으세요.

저장한 매물

1. 네이버 앱이나 크롬에서 매물 화면 공유 → 중개 도우미.
2. 저장 창에서 네이버 화면 글을 복사해 두었다면 📋 복사한 내용 붙여넣기 → 거래·가격·면적·층·준공이 채워집니다.
3. 상태(새로 저장·연락함·장부에 옮김·보류·끝남)와 메모로 관리합니다.

네이버 캡처 매물 화면 통째로 남기기 · AI가 칸 채움

네이버 매물 화면(스크롤해서 내려가는 아래쪽까지)을 사진으로 남기고, AI가 사진 글자를 읽어 가격·면적·층·중개사·매물번호를 채웁니다. 광고가 내려가 네이버 링크가 안 열려도 사진은 남습니다.

폰에서

1. 네이버 부동산에서 매물을 열고, 여러 중개사 중 하나를 골라 상세 화면을 엽니다.
2. 전원 + 음량↓로 캡처 → 아래 도구 줄의 스크롤 캡처(↓ 모양)를 끝까지 누릅니다 → 긴 사진 한 장.
3. 도구 줄의 공유 → 중개 도우미. (갤러리에서 사진 여러 장을 골라 공유해도 됩니다.)
4. 앱의 네이버 캡처 저장 창 → 저장. 사진을 줄이고 나눠 올린 뒤 AI가 읽습니다 (10~40초).
5. 상세 화면이 열리면 파란 칸(AI가 채운 칸)이 맞는지 확인하고, 필요하면 고쳐서 저장.

PC에서

• 신규매물 → 저장한 매물 → 📷 캡처 올리기 → 사진 고르기. 또는 사진 파일을 앱 화면에 끌어다 놓기, 캡처 도구로 찍은 뒤 Ctrl+V.
• 저장한 매물 상세 화면에 끌어다 놓거나 붙여넣으면 그 매물에 붙습니다.

저장한 뒤 보이는 것

알아두기

• 목록에 📷조각 수, 장부 있음(같은 지번·단지) / 장부 비슷 n이 표시됩니다. 검색 칸에서 중개사 이름·매물번호로도 찾습니다.
• AI는 빈 칸만 채웁니다. 이미 적힌 칸과 다르게 읽으면 칸 아래 "캡처에서 읽은 값 … 바꾸기"로 알려 줍니다.
• 링크로 먼저 저장해 둔 매물과 매물번호가 같으면 새로 만들지 않고 그 매물에 붙입니다.
• 사진은 구글 드라이브 네이버 캡처 (중개 도우미) 폴더에 매물마다 폴더로 저장됩니다. '부동산 사진' 폴더와는 따로라 매물 접수의 새 폴더 목록에 섞이지 않습니다. 저장한 매물을 지우면 그 폴더도 휴지통으로 갑니다 (30일 안에 되살릴 수 있음).
• 스크롤 캡처가 중간에 멈추는 화면은 일반 캡처 2~3장을 같이 골라 공유하세요. 창에서 ↑↓로 순서를 바꿀 수 있습니다.
• 올리다 끊기면 이어서 올리기로 남은 것부터 올립니다. AI 읽기가 실패해도 사진은 저장되어 있으니 나중에 AI로 다시 읽기.
• AI가 읽는 데 30초~1분쯤 걸릴 수 있습니다. 그동안 폰 연결이 끊겨도 서버는 끝까지 읽으므로, 앱이 "결과를 확인하는 중"으로 기다렸다 받아 옵니다. 상세 화면에 ⏳ 읽기 시작이 보이면 잠시 뒤 새로고침, 지난 AI 읽기 실패가 보이면 그 이유를 확인하세요.
• 캡처 사진은 광고 화면 그대로 Gemini 무료 등급으로 보내집니다. 다른 중개사 광고 사진은 참고·기록용으로만 쓰고, 내 광고·브리핑·쇼츠에는 쓰지 마세요.
• 앱을 새로 올린 뒤 폰 공유 목록에서 사진을 중개 도우미로 보내는 항목이 뜨기까지 하루쯤 걸릴 수 있습니다. 바로 쓰려면 홈 화면의 앱을 지우고 다시 설치하세요. 그동안은 📷 캡처 올리기로 사진을 고르면 됩니다.

실거래 국토부 실거래가

• 위에서 지역을 고릅니다: 원주·횡성·홍천·강릉·여주·양평·제천·충주.
• 유형별: 아파트·오피스텔·빌라·단독주택·분양권·상가업무·토지·공장창고 → 매매/전월세, 1·3·6개월. 검색·읍면동·정렬, 전월세는 전세만/월세만도 거를 수 있습니다.
• 아파트 단지별: 6개월·1년·2년 단지 목록 → 단지를 누르면 면적별 거래, 전세가율, 추이를 봅니다.
• 처음 보는 조합은 국토부에서 받느라 10~30초 걸릴 수 있습니다. 한 번 본 조합은 서버가 미리 준비해 두어 바로 뜹니다.

경매 법원경매

• PC의 경매 수집기(auction.py)가 채운 경매 시트를 봅니다. 수집기가 돌지 않으면 내용이 바뀌지 않습니다 — 위 상태 줄에서 마지막 수집 시각을 확인하세요.
• 최근 변화 / 전체 물건 / 관심물건을 고르고, 주소·사건번호 검색, 물건 종류, 지역, 정렬(입찰일·관심점수·최저가율·최저가)을 씁니다.
• 물건을 누르면 상세(감정가·최저가·회차·AI 분석 등)가 열립니다.

공시 관심종목 DART

• 관심종목의 공시를 1주·1개월·3개월로 봅니다. 종목·분류로 거를 수 있습니다.
• 종목 편집: 종목명이나 종목코드로 찾아 추가·삭제합니다. 구글 시트 '관심종목' 탭에서 직접 고쳐도 됩니다.
• 새로 상장한 종목이 안 찾아지면 Apps Script에서 refreshCorpList를 실행하세요.
• 시트에 같은 종목을 두 번 적었으면 종목 편집 → 겹치는 종목 정리. 이름을 못 찾은 줄(코드 없음)은 비슷한 이름을 보고 시트에서 정식 이름이나 종목코드(6자리)로 고치세요. 우선주(…우)는 본 회사 공시로 봅니다.
• "DART 시스템 점검 중", "DART가 요청을 막았습니다"가 보이면 DART 쪽 사정입니다. 잠시 뒤 새로고침하세요.

바로가기

• 자주 여는 사이트·시트 버튼 모음입니다. 편집으로 주소를 넣거나 지우고, 아래 바로가기 추가로 새 버튼을 만듭니다.
• 구글 시트 '바로가기' 탭에서 고쳐도 됩니다.
• 위쪽 앱 도구에 매물 접수 · A4 브리핑 만들기 · 쇼츠 만들기 · 사용 설명서 버튼이 있습니다.

A4 브리핑 손님용 매물 한 장

1. 매물 상세의 📄 브리핑 만들기로 열면 장부 내용으로 자동 채워집니다. (직접 열었으면 맨 위 매물통합장부에서 고르기.)
2. 사진: 드라이브 '부동산 사진'에서 그 지번 폴더를 자동으로 엽니다. 사진을 누르고 칸을 고르거나, 두 번 누르거나, 칸에 끌어다 놓습니다. 노트북 폴더는 내 PC 폴더 열기, 폰은 폰 사진 고르기.
3. 주변 실거래: 같은 동 최근 1년 거래에서 최대 5건을 체크하고 A4에 넣기를 켭니다.
4. 특징·배너: 장부 비고 후보 버튼을 누르거나, 추출 프롬프트 복사 → Gemini·Claude에 서류와 함께 붙여넣기 → 받은 JSON을 2번 칸에 붙여넣기.
5. 내용이 많아 넘치면 사진 높이가 자동으로 줄어듭니다.

내보내기

• 인쇄: Ctrl+P → PDF로 저장 또는 인쇄. 용지 A4, 여백 없음, 배경 그래픽 켜기.
• JPG 저장, 이미지 복사(카톡 PC 대화창에 Ctrl+V), 폰은 공유로 카톡에 바로.

쇼츠 만들기 유튜브 쇼츠 카드 · 대본

1. 매물 상세의 🎬 쇼츠 만들기로 열면 정보 카드(남색)와 장점 카드(흰색)가 장부 값으로 그려집니다.
2. 현장 메모를 적고(비고 후보를 눌러 넣어도 됨) 대본 프롬프트 복사 → AI 앱에 붙여넣기 → 답을 통째로 붙여넣기 → 대본·장점·제목·소개·해시태그가 채워집니다.
3. 카드 2장 모두 저장 (1080×1920 PNG). 폰은 폰으로 공유.
4. Vrew용 대본 복사(자막만 한 줄씩) → Vrew에 붙여넣고, 장면표 번호대로 정보카드·장점카드·현장영상을 넣습니다.
5. 유튜브 제목·설명란·해시태그를 복사해 올립니다. 설명란에는 매물 정보와 중개사무소 명시사항이 자동으로 들어갑니다.

빠르게 열기 · 사용량

• 앱은 마지막으로 받은 자료를 기기에 저장해 두고 먼저 보여 줍니다. 제목 옆 "○분 전 자료 · 받는 중…"이 잠깐 떴다가 새 자료로 바뀝니다.
• "못 받음 [다시]": 새 자료를 못 받아 저장된 자료를 보여 주는 중입니다. [다시]를 누르세요.
• 앱을 열면 다른 탭 자료도 미리 받아 둡니다.
• 서버 미리 준비: 07~22시에 10분마다 실거래·공시·경매·장부를 미리 받아 둡니다. 켜기 setupWarmUp, 끄기 stopWarmUp.

오늘 서버 사용량 (설정 → 보기)

서버 관리 Apps Script · Cloudflare Pages

서버 코드(Code.gs)를 바꿀 때

1. Apps Script 편집기에서 Code.gs 내용을 새 파일 내용으로 바꾸고 저장합니다.
2. 안내받은 점검 함수가 있으면 실행합니다 (권한 허용 창이 뜨면 고급 → 이동 → 허용).
3. 배포 관리 → 연필 → 버전: 새 버전 → 배포. '새 배포'가 아닙니다 — 새 배포를 하면 주소가 바뀌어 모든 기기 설정을 다시 해야 합니다.

화면(앱)을 바꿀 때

1. dash.cloudflare.com → Workers & Pages → 중개 도우미 프로젝트를 누릅니다.
2. Create deployment(새 배포 만들기) → 받은 zip 파일을 그대로 끌어다 놓기 → Save and Deploy(저장 및 배포).
3. 앱은 이 기기에 저장된 화면으로 먼저 열리고 새 버전은 뒤에서 받습니다. 올린 뒤 앱을 열면 아래에 "새 버전을 받았습니다 · 지금 적용"이 뜹니다 → 누르면 적용 (안 눌러도 다음에 열 때 적용). 제목 옆 단계 표시로 확인하세요.
4. Cloudflare 무료는 올리기 횟수·트래픽 걱정이 없습니다. 다만 한국 접속이 해외 서버로 돌아가 처음 받을 때는 조금 느릴 수 있습니다 (한 번 받으면 바로 열림).

(예전) Netlify

• 15단계b까지는 Netlify에 올렸습니다. Netlify 무료는 한 달 300크레딧, 한 번 올릴 때 15크레딧입니다.
• 앱을 여는 것(트래픽)도 조금씩 크레딧을 씁니다 (1GB에 20, 요청 1만 번에 2). 0이 되면 사이트가 멈추니 15~30은 남겨 두세요. 남은 크레딧과 다시 채워지는 날: Netlify → Usage & billing → Credit balance.

스크립트 속성 (프로젝트 설정 ⚙ → 스크립트 속성)

편집기에서 실행하는 함수

문제 해결

업데이트 기록