Geosql: A Claude/Codex skill for geospatial data

TL;DR Highlight

PostGIS, BigQuery, Snowflake 등에서 지리공간 데이터를 다룰 때 Claude/Codex/GitHub Copilot에 설치해서 SQL 생성과 지도 렌더링까지 자동화해주는 오픈소스 Skill이다.

Who Should Read

지리공간 데이터(PostGIS, BigQuery GIS, Snowflake 등)를 분석하는 데이터 엔지니어나 분석가 중, LLM 에이전트를 활용해서 SQL 작성과 시각화를 자동화하고 싶은 사람.

Core Mechanics

GeoSQL은 Claude, Codex, GitHub Copilot에 설치할 수 있는 Skill 패키지로, 지리공간 SQL 쿼리 생성과 지도 렌더링을 에이전트가 자동으로 처리하도록 해준다.
pip install geosql 한 줄로 설치하고, geosql install claude / codex / copilot 명령으로 각 에이전트에 바로 연결할 수 있다. SaaS 계정 없이 완전 로컬 또는 셀프호스팅으로도 동작한다.
지원 데이터베이스는 PostGIS, BigQuery, Snowflake, Wherobots이며, 지도 렌더링은 오픈소스 Kepler.gl 백엔드인 Dekart를 통해 처리된다. Dekart는 docker run 한 줄로 로컬에 띄울 수 있다.
프로젝트 측 주장에 따르면 '지도 in the loop' 방식(에이전트가 생성한 지도를 루프 안에서 확인하며 수정)을 쓰면 지리공간 태스크 성공률이 4배 향상된다고 한다.
실제 사용 예시로는 오타와 저학교접근성 건물 분석, 시애틀 스포츠용품점 최적 입지 10곳 선정(POI 밀집도 + 경쟁사 거리 기반), 루마니아 주요 도로 EV 충전기 밀도 지도 생성 등이 포함되어 있다.
Claude Code에서는 /plugin marketplace add dekart-xyz/geosql 명령으로 플러그인 마켓에서 직접 설치할 수 있어 별도 CLI 작업 없이도 바로 적용 가능하다.
VS Code Copilot이나 Copilot CLI에서는 /geosql Show EV charger density along major roads and render a map 같은 형태로 슬래시 명령어를 통해 지리공간 분석 요청을 바로 날릴 수 있다.

Evidence

'4배 향상'이라는 수치에 대해 혼란스럽다는 댓글이 달렸다. README의 그래프에는 베이스라인 2% 성공률이 8%로 오른 것으로 보이는데, evals 섹션에는 100% 성공률이라고 나와 있어서 실제 효과가 8%인지 100%인지 명확하지 않다는 지적이다.
'지도 in the loop'에서 에이전트가 실제로 Dekart에서 무엇을 읽어와서 geometry 오류를 잡는지 구체적 메커니즘이 README에 설명되지 않았다는 질문이 있었지만, 별다른 공식 답변은 없었다.
프랑스 국립지리정보원(IGN)에서 일한다는 댓글러가 자신들도 MCP 기반 지리공간 데이터 접근 도구(geocontext)를 개발 중이라고 공유했다. 고밀도 LiDAR 포인트 데이터도 함께 소개하며 이 분야가 활발하게 움직이고 있다고 언급했다.
지리공간 분석이 실제로 어떤 비즈니스 가치를 만드는지 모르겠다는 외부인 시각의 댓글도 있었다. 예시 지도가 예쁘긴 한데 누가, 왜 이런 툴에 비용을 지불하는지 이해가 안 된다는 내용이었다.
'Skill을 마크다운 파일로 공유하는 게 HN에 올릴 만한 내용이냐'는 회의적 댓글도 있었다. 몇 달 후 LLM이 더 좋아지면 이런 Skill 자체가 불필요해질 수도 있고, 그렇지 않다면 LLM 자체가 한계에 부딪힌 것이라는 양방향 비판이었다.

How to Apply

PostGIS나 BigQuery 위에서 지리공간 분석 쿼리를 자주 작성하는 경우, pip install geosql && geosql install claude 를 실행하면 Claude가 지리공간 SQL 생성과 지도 렌더링을 자동으로 처리해줘서 쿼리 작성 시간을 줄일 수 있다.
로컬 환경에서 바로 테스트해보고 싶다면 docker run -p 8080:8080 dekartxyz/dekart 로 Dekart를 띄우고, pip install dekart && dekart init 으로 DB를 연결한 뒤 에이전트에서 /geosql 명령어로 지도를 생성해볼 수 있다.
Claude Code를 쓰고 있다면 /plugin marketplace add dekart-xyz/geosql 명령 하나로 설치할 수 있어, 별도 터미널 작업 없이 Claude Code 안에서 바로 지리공간 분석 워크플로를 시작할 수 있다.
입지 선정이나 인프라 밀도 분석 같은 반복적인 지리공간 리포트가 있는 경우, /geosql Find top 10 locations for [업종] in [도시] based on POI co-location 형태의 프롬프트 템플릿을 만들어두면 매번 SQL을 직접 작성하지 않아도 된다.

Code Example

snippet

# 설치
pip install geosql && geosql

# 에이전트에 설치
geosql install claude
geosql install codex
geosql install copilot

# Claude Code에서 플러그인 설치
/plugin marketplace add dekart-xyz/geosql
/plugin install geosql

# Dekart 로컬 실행 (지도 렌더링용)
docker run -p 8080:8080 dekartxyz/dekart

# Dekart CLI 설치 및 초기화
pip install dekart && dekart init

# VS Code Copilot에서 사용 예시
/geosql Show EV charger density along major roads and render a map
/geosql Show buildings with low school accessibility in Ottawa, render as a map
/geosql Find the top 10 locations for Sporting Goods Store in Seattle based on POI co-location and distance to the nearest competitor. Create a map.

Terminology

SkillLLM 에이전트(Claude, Copilot 등)에 특정 도메인 지식이나 도구 사용 능력을 추가해주는 플러그인 패키지. 마치 브라우저 확장 프로그램처럼 에이전트의 능력을 확장한다.

PostGISPostgreSQL에 지리공간 데이터 처리 기능을 추가한 확장. 좌표, 폴리곤, 경로 같은 지도 데이터를 SQL로 다룰 수 있게 해준다.

Kepler.glUber가 만든 오픈소스 지리공간 데이터 시각화 툴. 대규모 위치 데이터를 브라우저에서 인터랙티브한 지도로 보여줄 수 있다.

POIPoint of Interest의 약자. 지도에서 관심 지점(카페, 주유소, 병원 등 특정 장소)을 나타내는 데이터.

LiDAR레이저 펄스를 쏘아서 거리를 측정하는 센서 기술. 지형이나 건물의 3D 포인트 클라우드 데이터를 생성하는 데 사용된다.

MCPModel Context Protocol의 약자. LLM 에이전트가 외부 도구나 데이터 소스와 표준화된 방식으로 통신하기 위한 프로토콜.