Files
Aislo/resources/knowledge/.secrets.local.md
T
eomsangdon a3f5b98032 docs(knowledge): 원가계산 원문 수집 실행 — 폴더 재편·원문 3종 확보·수집 경로 확정
- original/원가계산/ 신설, 다산소프트 폴더 이동 (링크 전건 수정)
- 원문 확보: 건설업 노임(건협)·제조업 노임(중기중앙회)·건설공사 표준품셈 PDF
- 폴더별 _meta.md (출처 URL·갱신주기·수집 방법)
- 표준시장단가 수집 제외 (사용자 결정 — 100억 미만 미적용·품셈과 별도 트랙)
- 자재단가 = 값형, original 미보관 (_meta 안내만) — 값층 관리 예정
- _pipeline/collect_cost_sources.py 수집 스크립트 배치
- 원가_기초데이터_원천.md §4 Aislo 수집 경로 확정표 추가 (API 3종 검증 결과 반영)
2026-08-14 16:35:05 +09:00

4.0 KiB

API 인증키 (로컬 전용 — 커밋 금지)

이 파일은 .gitignore에 등록되어 있다. 원격에 push 되지 않는다. 키는 개인 발급분이며 유효기간이 있다. 만료 시 각 기관에서 재발급 후 아래를 갱신한다.

국가건설기준센터 (KCSC)

  • 용도: 표준시방서(KCS) 본문 수집 — kcsc.re.kr/OpenApi/CodeViewer, /CodeList
  • 인증키: V86LjYzYe237yK1lFjhYXCgOe8H9AtzIJ5xoxQ2O3yg
  • 발급 계정: umsangdon
  • 유효기간: 2026-08-09 20:09 ~ 2027-08-09 20:09 (1년)
  • 사용법: https://kcsc.re.kr/OpenApi/CodeViewer/KCS/<코드>?key=<키> (path 방식, 소문자 key)
  • 발급/재발급: kcsc.re.kr 로그인 → 마이페이지 API Key

국가법령정보센터 (law.go.kr)

  • 용도: 법령·행정규칙 원문 — law.go.kr/DRF/lawSearch.do, lawService.do
  • OC 키: umsangdon (이메일 ID = OC 값, 별도 만료 없음)
  • 사용법: ?OC=umsangdon&target=law&...

공공데이터포털 (data.go.kr) — 일반 인증키

  • 용도: 조달청 나라장터 가격정보현황서비스 등 data.go.kr OpenAPI 전반 (API별 활용신청 필요)
  • 인증키(Encoding형, URL에 그대로 사용): 0j5WZHeNxSkdPVSLXUsx9kVikXEN%2BDc%2Byv68jz8IpKFffjbZkRiQrJO78y6rxPCTqhiSOW4lDxpid0twkSVQ9g%3D%3D
  • 발급: 2026-08-14, 계정 = data.go.kr 회원(사용자 개인). 만료 시 마이페이지 → 오픈API → 개발계정에서 갱신
  • 검증(2026-08-14): 가격정보현황서비스 실호출 정상 (resultCode 00)
    • 엔드포인트: http://apis.data.go.kr/1230000/ao/PriceInfoService/<오퍼레이션>?serviceKey=<키>&pageNo=1&numOfRows=999&type=json
    • 오퍼레이션: getPriceInfoListFcltyCmmnMtril{Engrk|Bildng|MchnEqp|ElctyIrmc|Total}(시설공통자재 토목/건축/기계설비/전기정보통신/종합), getPriceInfoListMrktCnstrctPc{...}(시장시공가격), getCnsttyClsfcInfoList, getNetRsceinfoList, getStdMarkUprcinfoList(표준시장단가 — 호출 방법 미해결, HTTP_ERROR 04)
    • 데이터 범위 실측: 시설공통자재 4분야 27,485건, 고시일 2024-10~2026-04. ⚠ 철근·레미콘·아스콘·시멘트 미포함 — 주요 관급자재는 종합쇼핑몰 계약단가(조합공통품목) 별도 경로 필요

오피넷 (opinet.co.kr) — 유가 무료 API

  • 용도: 유류 단가 (중기 기초자료 — 견적 엔진)
  • 무료 Key: F260814125 (발급 2026-08-14, 사용자 계정)
  • 사용법: https://www.opinet.co.kr/api/<오퍼레이션>?out=json&code=<키> (out=xml 가능)
  • 검증(2026-08-14): avgAllPrice.do(전국 일별 평균 — 고급휘발유 B034/휘발유 B027/자동차용경유 D047/실내등유 C004/부탄 K015), avgRecentPrice.do?prodcd=D047(최근 7일 일별), avgSidoPrice.do(시도별) 실호출 정상
  • ⚠ 선박용경유·중유(벙커C)·대리점 판매가는 무료 API 미포함 — 필요 시 웹표 opinet.co.kr/user/dopavsel/dopAvselSelect.do 스크래핑 (임도·사방 건설기계 연료는 경유 위주라 실무 영향 낮음. 2026-08-14 사용자 결정: 선박용경유 불요, 필요 시 재요청)

한국은행 ECOS (ecos.bok.or.kr) — 환율 API

  • 용도: 환율 매매기준율·재정환율 (중기 기초자료 — 기계경비 외화 환산)
  • 인증키: 0QUDJ05SXNFFD1T4XQUZ (발급 2026-08-14, 사용자 계정. ecos.bok.or.kr/api 마이페이지에서 관리)
  • 사용법: https://ecos.bok.or.kr/api/StatisticSearch/<키>/json/kr/1/100/731Y001/D/<시작일>/<종료일>/<항목코드>
  • 통계표 731Y001 "주요국 통화의 대원화환율" (일별) — 항목코드 (2026-08-14 실조회):
    • 0000001 원/미국달러(매매기준율) · 0000002 원/일본엔(100엔) · 0000003 원/유로 · 0000012 원/영국파운드 · 0000053 원/위안(매매기준율)
    • USD·위안만 공식 매매기준율, 엔·유로·파운드는 재정환율 — ESTX 기계경비 환율 5통화($·¥100·€·£·M) 중 마르크 제외 전부 커버
  • 검증(2026-08-14): USD 일별 5영업일 실호출 정상 (08-14 = 1,414.9원). 값은 서울외국환중개 고시와 동일 원천