Geosql: A Claude/Codex skill for geospatial data

개요

GeoSQL은 PostGIS, BigQuery, Snowflake, Wherobots와 같은 데이터 웨어하우스에서 지오스페이셜 데이터 작업을 하는 데이터 과학자 및 분석가를 위한 Claude, Codex, GitHub Copilot 통합 스킬입니다.

주요 내용

* 로컬 또는 자체 호스팅: GeoSQL은 SaaS 계정 없이 100% 로컬에서 작동하거나 자체 인프라에 호스팅할 수 있습니다.
* 4배 성능 향상: 맵(map)을 통합한 에이전트 루프를 통해 지오스페이셜 작업에서 4배의 성능 향상을 제공합니다.
* 설치 및 사용: pip install geosql로 설치하거나, Claude, Codex, Copilot과 같은 지원되는 에이전트에 직접 설치할 수 있습니다.
* Dekart 통합: 맵 렌더링 및 PostGIS, BigQuery, Snowflake 커넥터 지원을 위해 오픈 소스 Kepler.gl 백엔드인 Dekart를 선택적으로 사용합니다. Dekart는 로컬에서 Docker로 실행하거나 자체 호스팅, 또는 Dekart Cloud를 사용할 수 있습니다.
* 작동 방식:
* Discovery: 에이전트가 스키마를 추측하는 대신 웨어하우스 메타데이터(테이블, 컬럼, 타입)를 탐색합니다.
* SQL: 지원하는 엔진에 맞는 공간 SQL(ST\_INTERSECTS, ST\_DISTANCE, H3, 파티션 프루닝을 위한 bbox 오버랩 등)을 작성합니다.
* 비용 확인: BigQuery에서는 쿼리가 실행되기 전에 먼저 dry-run하여 스캔되는 바이트를 추정하고, 기본적으로 10 GiB의 청구 제한을 강제합니다. 예산 초과 쿼리는 재작성되어 더 저렴하게 실행됩니다.
* 기하 유효성 검사: 총 면적(다각형) 또는 총 길이(선)를 계산하여 검증하고, 도메인 지식과 교차 확인합니다.
* 맵 피드백: 렌더링된 맵을 통해 에이전트가 텍스트만으로는 놓칠 수 있는 기하 오류를 시각적으로 확인하고 수정합니다.
* 평가: GeoSQL은 특정 동작(비용 보호 기능, 유효성 검사 단계, 올바른 결과)을 주장하는 재현 가능한 평가 스위트를 포함하고 있으며, 현재 8개의 케이스에서 100%의 통과율을 기록했습니다.

시사점

GeoSQL은 맵 렌더링을 에이전트 루프에 통합함으로써 기존 텍스트 기반 에이전트의 한계를 극복하고 지오스페이셜 데이터 분석의 정확성과 효율성을 획기적으로 향상시킬 수 있습니다.