Claude Code를 활용한 iNaturalist 관찰 데이터 시각화 도구 개발

섹션별 상세

서로 다른 두 계정의 iNaturalist 관찰 기록을 특정 시간과 거리 기준으로 묶어서 관리해야 하는 필요성이 제기됐다. 기본적으로 2시간 이내 및 5km 이내의 관찰 기록을 하나의 '클럼프(clump)'로 그룹화하는 Python CLI 도구인 inaturalist-clumper를 먼저 개발했다. 이 도구는 API를 통해 데이터를 가져와 논리적 단위로 재구성하는 역할을 수행한다.

근거

Claude Code를 사용하여 모바일 폰에서 전체 앱을 구축했다. — I built this entirely on my phone using Claude Code for web 문단
기본 설정으로 2시간 이내 및 5km 이내의 관찰 기록을 그룹화한다. — by default clumps use observations within 2 hours and 5km of each other 문단

데이터의 지속적인 업데이트와 호스팅을 위해 Git 스크래핑(Git scraping) 기법을 적용한 저장소를 구축했다. GitHub Actions를 통해 정기적으로 CLI 도구를 실행하고 그 결과를 clumps.json 파일로 저장하여 GitHub에 기록한다. 이렇게 생성된 JSON 파일은 GitHub의 raw URL을 통해 외부 자바스크립트에서 CORS 제한 없이 직접 호출이 가능하다.

모바일 환경에서 Claude Code를 사용하여 최종적인 웹 인터페이스인 inat-sightings.html을 제작했다. 프롬프트를 통해 JSON 데이터를 fetch하고 관찰된 생물종의 썸네일을 지연 로딩(lazy loading) 방식으로 표시하는 기능을 구현했다. 사용자가 썸네일을 클릭하면 HTML 모달을 통해 고해상도 이미지를 보여주며 종의 일반 명칭도 함께 표시되도록 설계했다.

기술

Claude Code
Python
GitHub Actions
JavaScript
iNaturalist API

활용 사례

개인 데이터 수집 및 시각화
모바일 환경에서의 긴급 도구 개발
서버리스 데이터 파이프라인 구축

언급된 리소스

GitHubsimonw/inaturalist-clumps

GitHubsimonw/tools