API 키 설정 및 진단 이력 관리
여기에 등록한 키는 서버 DB에 저장되며, 진단 시 실제 데이터 수집에 사용됩니다.
저장된 키로 각 API를 실제로 한 번씩 호출해서 동작하는지 확인합니다. 키를 바꾼 뒤에는 항상 눌러보세요. (최대 45초)
data.go.kr (공공데이터포털) → 회원가입 후 "건강보험심사평가원" 관련 API 활용신청 → 승인 시 발급되는 서비스키(인증키) 입력 (병원·약국 정보, 의약품 정보 등에 사용)
developers.naver.com → 애플리케이션 등록 → 사용 API에서 "검색"과 "데이터랩(검색어트렌드)"을 함께 선택 후 발급 (블로그·카페·지역 검색 + 검색어 트렌드 조회에 사용, Client ID/Secret 하나로 두 API 모두 동작)
⚠️ 아래 네이버 클라우드 Maps 카드의 키와 혼동하지 마세요. 여기는 developers.naver.com 키입니다. (Client ID 20자 / Client Secret 10자)
console.ncloud.com → Services → Maps → Application → 해당 Application의 [인증 정보]에서 확인. 경쟁병원 주소를 좌표로 변환해 내 병원과의 실제 거리(km)를 계산하는 데 사용됩니다.
⚠️ 위 네이버 오픈API 키와 다릅니다. Application 등록 시 Geocoding 서비스가 선택되어 있어야 동작합니다.
searchad.naver.com → 광고플랫폼 → 도구 → API 사용 관리에서 확인 (파워링크·키워드 광고 효율 조회에 사용)
등록하지 않아도 나머지 기능은 정상 동작합니다. (선택)
Custom Search
⛔ 현재 사용할 수 없는 API입니다 (구글 정책). 구글이 Custom Search JSON API를 신규 고객에게 개방하지 않습니다. 2026년에 만든 프로젝트는 API를 활성화하고 키를 새로 발급해도 403 This project does not have the access to Custom Search JSON API가 반환됩니다. 기존 고객도 2027년 1월 1일 서비스 종료 예정입니다. → 아래 두 칸은 비워두셔도 됩니다. 값을 넣어도 구글 검색 순위는 수집되지 않습니다. 대안(Places API 전환 또는 유료 SERP API)은 별도 논의 예정입니다.
403 This project does not have the access to Custom Search JSON API
programmablesearchengine.google.com → 검색엔진 선택 → "검색 엔진 ID". 8ac1ab64606d234f1 같은 17자 형식입니다. AIza… 로 시작하는 값은 API Key이므로 여기에 넣으면 안 됩니다.
8ac1ab64606d234f1
Google Places (구글 평점 · 리뷰 수 실측)
✅ Custom Search 대신 사용하는 채널입니다. 구글 검색 순위는 정책상 조회할 수 없지만, Places API로 구글 평점 · 리뷰 수 · 홈페이지 등록 여부는 실측할 수 있습니다. 사전 준비 3가지 — ① 콘솔 → 라이브러리에서 Places API (New) 사용 설정 ② 해당 키의 API 제한사항에 Places API (New) 포함 ③ 프로젝트에 결제 계정 연결 (무료 한도가 있어도 필수) 요금: 평점·리뷰 수를 조회하면 Enterprise SKU로 과금되며 월 1,000콜 무료입니다. 진단 1회당 최대 2콜 → 월 약 500회까지 무료.
Google Maps
Google Ads
fisis.fss.or.kr (금융감독원 금융통계정보시스템) → Open API → 인증키 신청 후 발급 (금융기관 통계 조회에 사용)
환자가 검색창 대신 AI에게 물었을 때 이 병원이 거명되는지 확인합니다. 둘 중 하나만 넣어도 동작하며, 없으면 해당 항목만 "키 없음"으로 표시됩니다. platform.openai.com/api-keys (OpenAI · 결제수단 등록 필요 · 1회 진단 약 1원) · aistudio.google.com/apikey (Gemini · 무료 할당량 있음)
모델 지정 (선택) — 비워 두면 계정에서 쓸 수 있는 최신 모델을 자동으로 찾아 씁니다. 특정 모델로 고정하고 싶을 때만 이름을 적으세요. (예: gpt-5.6-terra, gemini-3.8-flash) 모델이 폐기되어 오류가 나면 다음 진단 때 자동으로 다시 고릅니다. 지운 값으로 되돌리려면 - 한 글자를 넣고 저장하세요.
gpt-5.6-terra
gemini-3.8-flash
-
둘 다 점수에 넣지 않고 참고 지표로만 보여줍니다. 표본이 쌓이면 배점을 정합니다. 유튜브 — 공식 채널 유무 · 구독자 · 발행 속도 · 병원명/지역+진료과/지정 키워드 검색 노출. 구글 클라우드 콘솔 에서 YouTube Data API v3 를 사용 설정한 뒤 API 키를 만듭니다(무료). 하루 10,000 units 제한이 있고 진단 1회에 최대 302 units(약 33건/일)를 씁니다. 그래서 같은 조건은 7일간 캐시합니다. 다른 구글 키를 빌려 쓰면 대개 403 이 납니다 — 그 키에 API 제한(예: Places 만 허용)이 걸려 있기 때문입니다. 전용 키를 따로 만드는 것이 가장 확실합니다. 카카오맵 — developers.kakao.com 에서 앱을 만들면 나오는 REST API 키입니다(하루 10만 건 무료). 키를 넣는 것만으로는 안 됩니다 — 내 애플리케이션 → 해당 앱 → 좌측 메뉴 [카카오맵] → [사용 설정]을 반드시 ON 으로 바꿔야 합니다. 꺼져 있으면 403 이 뜨는데, 키 문제로 보이지만 키는 멀쩡합니다. (활성화된 앱이 2개 이상이면 비즈월렛 연결도 필요할 수 있습니다) 카카오는 평점·리뷰를 API 로 제공하지 않습니다(제휴로도 불가). 등록 여부와 전화·주소 정확도만 봅니다.
병원 주변의 거주인구 · 직장인구(종사자 수) · 사업체 수를 가져옵니다. "이만한 시장이 있는데 순위는 35위" 라는 대비를 만드는 자료입니다. sgis.kostat.go.kr/developer → 회원가입 → 서비스 신청 → 서비스 ID와 보안 Key 발급 (무료). 승인까지 잠시 걸릴 수 있습니다. ※ 없어도 반경 내 경쟁 병원 밀도는 공공데이터포털 키로 나옵니다.