| name | track-transit |
| description | 대한민국 기초/광역 지방자치단체의 버스 교통정보(노선·정류장·이용량·배차·공항버스)를 GITS·GBIS·공공데이터포털·지자체 공식 사이트에서 수집·집계하고 인용 메타가 포함된 Markdown 보고서를 생성한다. Use when: 특정 지역의 버스 이용량·노선·배차 현황 조사, 광역/공항버스 노선 확인, 버스 교통정보 출처 식별, 노선 거버넌스 브리핑 작성.
|
| argument-hint | <지역명> [이용량|노선|배차|공항버스|거버넌스|전체] |
track-transit
대한민국 지방자치단체의 버스 교통정보를 공식 출처에서 수집·집계하고, 인용 메타가 포함된 보고서를 생성한다.
언제 쓰는가
- 특정 지역의 버스 이용량·정류장 수·배차간격 현황을 정량화할 때
- 광역버스·공항버스·지역버스 노선 목록과 경로를 확인할 때
- 버스 노선 신설·변경·폐지 거버넌스(기초지자체/광역지자체/국토부/의회 역할)를 분석할 때
- 준공영제·반공영제 운영 구조를 파악할 때
- 환승센터·BRT·교통거점 계획 자료를 수집할 때
대상 지역 식별
- 작업 시작 시 저장소 루트의
location.txt를 먼저 읽어 기준 행정구역을 확정한다.
- 사용자가 다른 지역을 명시하면 그 지시가
location.txt보다 우선한다.
자료원 우선순위
| 순위 | 출처 | 수집 내용 |
|---|
| 1 | gits.gg.go.kr — 경기도교통정보센터(GITS) 원시데이터 | 지역별 버스이용객수(연간), 통행구분별 환승 분석, BIT 설치 현황 |
| 2 | www.gbis.go.kr — 경기버스정보시스템 | 광역버스·공항버스 노선 목록, 정류장별 배차, 실시간 정보 |
| 3 | www.data.go.kr — 공공데이터포털 | 지자체별 버스정류장·노선·BIT·공항버스 CSV/XLSX |
| 4 | 해당 지자체 공식 사이트(.go.kr) | 공항버스 운행 일정, 준공영제 계획, 노선 공고 |
| 5 | www.law.go.kr | 여객자동차운수사업법·대중교통육성법·수도권교통특별법 조문(거버넌스 분석 시) |
경기도 지역 주요 데이터셋 ID (공공데이터포털)
| 데이터셋 ID | 내용 |
|---|
| 15077307 | 경기도 성남시 버스정류장 현황 CSV |
| 15138309 | 경기도 성남시 버스노선 현황 CSV |
| 15122007 | 경기도 성남시 BIT 현황 CSV |
| 15048509 | 경기도 성남시 공항버스 현황 XLSX |
| 15144886 | 경기도 성남시 기타 버스 현황 |
타 지자체는 data.go.kr에서 <지자체명> 버스정류장 검색으로 ID 확인 후 사용.
워크플로우
1. 수집 목표 결정
사용자 요청을 아래 4가지 모드 중 하나로 분류:
- 이용량 모드: GITS 원시데이터 → 지역별 월간 승하차 합산, 피크 시간대, 환승 비중
- 노선·배차 모드: data.go.kr CSV → 노선명·배차간격·경유 정류장 목록
- 공항버스 모드: GBIS + 지자체 공식 XLSX → 공항버스 노선·정류장·운행 시간
- 거버넌스 모드: law.go.kr + 지자체 공고 → 신설·변경·폐지 절차, 권한 주체 분석
전체(전체 인수 또는 미지정)는 4가지 모드를 순서대로 수행.
2. 원문 보존
-
수집 즉시 보관함/다운로드/<host>/<basename>에 저장.
-
.meta.json 필수 필드:
{
"source_url": "...",
"collected_at": "<ISO-8601 KST>",
"content_sha256": "...",
"saved_file": "..."
}
-
파일명에 수집일 접두어 금지 — 시간 추적은 .meta.json의 collected_at으로.
3. 데이터 집계 방법
이용량 (GITS XLSX 기준):
- 행정동 목록을 확정한 후 해당 행을 필터링.
- 평일/주말 평균과 범위(min~max)를 각각 산출.
- 피크 시간대(가장 높은 시간대 1~2개)를 명시.
- 환승 비중 = 환승통행 / 전체통행 × 100.
노선·배차 (CSV 기준):
- 정류장 CSV의 행정동 컬럼으로 지역 필터.
- 고유 노선명 수와 배차간격(평일) 분포(≤10분 / 11-20분 / 21-30분 / 31분 이상) 계산.
- 배차간격 최소·최대·중앙값 명시.
공항버스 (XLSX 기준):
- 시트별 노선명 목록 추출.
- 각 시트에서 조사 지역 내 정류장명 필터.
4. 거버넌스 분석 (선택)
버스 노선 관리 권한 구조는 아래 법령 조문을 기준으로 기술:
| 법령 | 핵심 조문 |
|---|
| 여객자동차운수사업법 | 제84조(노선 인가), 제86조(운행계획 변경) |
| 대중교통육성법 | 제7조(광역 교통계획) |
| 수도권대중교통특별법 | 제3조(협의체), 제6조(노선 조정) |
| 지방자치법 | 제13조(자치사무), 제27조(조례 제정) |
권한 주체별 정리 형식:
- 기초지자체(시청): 관할 내 시내버스 노선 인가·변경·폐지 신청, 준공영제 계약
- 광역지자체(도청): 광역버스 노선 조정, 준공영제 운영비 보조, 환승센터 계획
- 국토교통부: 면허 기준 고시, 공항버스 노선 인가 최종 권한
- 지방의회(시의회/도의회): 예산 심의, 조례 제정·개정, 행정사무감사
5. 보고서 생성
산출물 경로: 보관함/결과/YYYY-MM-DD <지역명> 버스 <주제>.md
파일 상단 YAML frontmatter:
---
title: "<지역명> 버스 <주제> 브리핑"
source_url: "<대표 수집 URL>"
collected_at: "<ISO-8601>"
content_sha256: "<hash>"
license: "공공데이터 이용허락 / KOGL Type 1"
pii_masked: false
---
보고서 구성 (모드별 선택):
# <지역명> 버스 <주제> 브리핑
기준 YYYY-MM, 대표 출처 ...
## 핵심 수치 ← 이용량 모드
## 노선·배차 현황 ← 노선 모드
## 공항버스 노선 ← 공항버스 모드
## 수집 방법 ← 항상 포함
## 한계·주의사항 ← 항상 포함
## 거버넌스 구조 ← 거버넌스 모드
---
출처: <URL> · 수집 <ISO-8601> · sha256:<short>
파일명 규칙
- 형식:
YYYY-MM-DD <광역> <기초> 버스 <주제>.md
- 예시:
2026-04-30 경기도 성남시 분당구 버스 교통정보 이용량.md2026-05-16 경기도 성남시 버스 노선 관리 권한 구조 브리핑.md2026-05-16 경기도 성남시 환승센터 서부권 교통사업 재검증.md
완료 체크리스트
안전·정책
*.go.kr 화이트리스트 우선. 그 외 도메인(예: gbis.go.kr)은 명시 동의 후 사용.- GITS raw ZIP/XLSX는 직접 CLI 다운로드 불가한 경우 수동 사전 다운로드 후 경로 참조.
- GBIS 실시간 API는 공공데이터포털 인증키 없이 자동 수집 불가 → 인증키 확보 여부를 먼저 확인.
- robots.txt·rate limit 준수. 위반 의심 시 즉시 중단하고 사용자에 보고.
- 수치 해석과 정책 평가는 분리 — 사실 카드에는 수치와 출처만 기입.
성남시 작업에서 확인된 실전 패턴
- GITS는
data/list.do 게시판에서 연도별 ZIP/XLSX를 직접 다운로드. URL 패턴: download2.do?f=<encoded>.
- data.go.kr CSV에서 행정동 필터링 시
행정동 또는 정류장명 컬럼의 접두어로 분당구 동 이름 확인.
- 공항버스 XLSX는 시트별로 노선이 구분됨. 지역 내 정류장은
판교, 운중, 정자, 미금 등 키워드로 필터.
- 준공영제 운영비 분담 비율과 적자 보전 구조는 경기도 공식 발표 자료(
gnews.gg.go.kr)를 1차 출처로 사용.
