구글 맵에서 병원·클리닉을 수집하고 WhatsApp 연락처를 찾는 작업을 시작한다.

즉시 반환한다. 실제 수집은 20~40분 걸리므로 check_collection으로 진행을 확인하라.

Args: keyword: 검색어. 현지어가 훨씬 잘 나온다 (인니 'klinik', 베트남 'phòng khám'). 실측상 종합병원('rumah sakit')보다 클리닉('klinik')의 수확률이 5배 높다. region: 전화번호 정규화 기준 ISO 국가코드 (ID, VN, PH, US ...). lat: 검색 중심 위도. 도시명을 좌표로 바꿔서 넘겨라. lng: 검색 중심 경도. radius_km: 격자가 덮을 반경. grid: 한 변의 타일 수. 구글 맵은 검색당 약 120건에서 잘리므로 넓은 지역은 격자로 쪼갠다. limit: 수집할 최대 장소 수. 0이면 제한 없음. lang: 구글 맵 UI 언어. crawl: 웹사이트를 훑어 WhatsApp 링크를 찾을지. 끄면 훨씬 빠르지만 confirmed가 거의 나오지 않는다 (실측 0.5% 대 47%).

수집 작업의 진행 상황과 현재까지의 집계를 돌려준다.

이 세션에서 시작한 수집 작업들.

돌고 있는 수집을 중단한다. 그때까지 수집한 레코드는 그대로 남는다.

수집 결과를 읽는다. 레코드 전체가 아니라 필요한 만큼만 돌려준다.

엑셀 파일(.xlsx)은 수집이 끝나면 CSV와 나란히 자동 생성된다. 병원명·위치· 전화번호·WhatsApp 링크·상태·근거 여섯 컬럼이며 연락 가능한 곳만 담는다.

Args: job_id: start_collection이 준 작업 id. csv_path 대신 쓸 수 있다. csv_path: 결과 CSV 경로. 이전 세션의 결과를 읽을 때 쓴다. status: 'confirmed'(업체가 선언한 확정 번호) / 'candidate'(모바일 번호 추측) / 'unlikely'. 비우면 전부. limit: 최대 반환 건수.

수집 결과를 엑셀(.xlsx)로 다시 뽑는다.

수집이 정상으로 끝나면 엑셀은 자동 생성된다. 이 툴은 그러지 못한 경우를 위한 것이다 — cancel_collection으로 중단해 마무리 코드에 도달하지 못했거나, 예전에 모은 데이터를 지금 형식으로 다시 만들고 싶을 때.

재개 원장(.raw.jsonl)에서 만들므로 수집 도중에도 현재까지의 결과를 뽑을 수 있다.

Args: job_id: start_collection이 준 작업 id. csv_path: 결과 CSV 경로. job_id 대신 쓸 수 있고, 이전 세션의 결과에 쓴다. out_path: 저장할 .xlsx 경로. 비우면 CSV와 같은 이름으로 나란히 만든다.

웹사이트 한 곳을 열어 선언된 WhatsApp 번호를 찾는다. 몇 초면 끝난다.

업체가 href에 넣어둔 wa.me / api.whatsapp.com 링크만 읽는다. 본문에 적힌 맨 번호는 WhatsApp인지 알 수 없으므로 쓰지 않는다.