Oldcircle/geo-sleuth

어떤 프로젝트인가요?

핵심 기능

• 01철도 교량, 전선 등의 OpenStreetMap 지형지물을 검색해 후보 위치를 생성합니다.
• 02사진 속 능선 윤곽을 고도 기반 스카이라인과 대조하고, 작은 카메라 롤 각도를 계산합니다.
• 03그림자와 태양 방향을 추정해 방위각과 위도대를 추론합니다.
• 04CLIP, DINOv2, SIFT 매칭으로 위성 타일과 거리 뷰 이미지의 순위를 매깁니다.
• 05오차 반경과 방위각이 포함된 카메라 좌표 및 증거 이미지를 출력합니다.
• 066개 주요 코딩 에이전트에서 표준 Agent Skill로 실행됩니다.

활용 사례

• GPS 데이터도 읽을 수 있는 표지판도 없는 사진의 위치를 OSINT 조사 목적으로 찾습니다.
• 판단 근거를 확인하며 GeoGuessr 스타일 퍼즐의 위치 추정 실력을 연습합니다.
• 분석 허가를 받은 풍경 또는 인프라 사진의 촬영 위치를 확인합니다.
• 지형, 위성 이미지, 지도 데이터를 결합해 이미지 위치를 추정하는 방법을 살펴봅니다.

빠른 시작

1. 1

   npx로 스킬을 설치하고 사용할 에이전트를 선택합니다

   npx skills add Oldcircle/geo-sleuth
2. 2

   처음 사용할 때 에이전트가 스킬의 scripts 폴더에서 doctor.py를 실행하고 실패한 검사를 해결하도록 합니다

3. 3

   에이전트에게 사진을 주고 사진을 찍은 장소를 찾아 달라고 요청합니다

사용 전 알아둘 점

• !Python 3.10 이상이 필요하며, 처음 사용할 때 설정 확인을 해야 합니다.
• !전체 실행에는 시간이 오래 걸릴 수 있습니다. 문서에 기록된 한 사례에서는 처음부터 끝까지 약 72분이 걸렸습니다.

포함된 컬렉션

토픽

자주 묻는 질문

geo-sleuth은(는) 무엇인가요?

OpenStreetMap 지형 정보, 고도 기반 스카이라인, 위성 이미지와 거리 뷰를 활용해 사진 촬영 위치를 추정하고 판단 근거를 보고하는 에이전트 스킬입니다. geo-sleuth는 AI 코딩 에이전트를 위한 사진 위치 추정 스킬입니다. 사진을 받으면 에이전트가 일련의 Python 스크립트를 실행해 EXIF 데이터와 사진에 보이는 텍스트를 읽고, OpenStreetMap에서 후보 위치를 검색한 다음, 각 후보 지점에서 계산한 고도 기반 스카이라인과 사진 속 능선 윤곽을 비교합니다. 위성 타일과 거리 뷰 이미지는 CLIP, DINOv2, SIFT 매칭으로 순위를 매기며, 최종 결과로 오차 반경과 방위각이 포함된 카메라 위치, 증거 이미지를 제공합니다.

geo-sleuth은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

geo-sleuth은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

geo-sleuth은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. geo-sleuth의 마지막 커밋은 2026년 11월 5일입니다.

geo-sleuth은(는) 어디에 사용할 수 있나요?

GPS 데이터도 읽을 수 있는 표지판도 없는 사진의 위치를 OSINT 조사 목적으로 찾습니다. 판단 근거를 확인하며 GeoGuessr 스타일 퍼즐의 위치 추정 실력을 연습합니다. 분석 허가를 받은 풍경 또는 인프라 사진의 촬영 위치를 확인합니다. 지형, 위성 이미지, 지도 데이터를 결합해 이미지 위치를 추정하는 방법을 살펴봅니다.

geo-sleuth는 어떻게 설치하나요?

npx로 스킬을 설치하고 사용할 에이전트를 선택합니다: npx skills add Oldcircle/geo-sleuth 처음 사용할 때 에이전트가 스킬의 scripts 폴더에서 doctor.py를 실행하고 실패한 검사를 해결하도록 합니다 에이전트에게 사진을 주고 사진을 찍은 장소를 찾아 달라고 요청합니다

geo-sleuth은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Oldcircle/geo-sleuth