수집된 변경은 자동 반영하지 않습니다. 변경 감지 → diff → Claude 요약·영향 품목 태깅 → 관리자 승인 후에만 규칙에 반영합니다. 키는 모두 Cloudflare Pages 시크릿으로 보관하며 브라우저에 노출하지 않습니다.
| API | 용도 | 인증·비용 | 연결 방법 | 상태 |
|---|---|---|---|---|
| Anthropic Claude API ANTHROPIC_API_KEY | 자연어 검색어 → 구조화 시나리오 파싱, 근거 설명문·전략 서술, 관보 변경분 요약·영향 품목 태깅. 세율 계산에는 사용하지 않음. | API 키 종량제(사용량 과금) | functions/api/parse.ts 구현 완료. Cloudflare Pages 시크릿으로 키 등록 시 즉시 활성화 (미등록 시 규칙 기반 파서로 자동 대체). | 키 필요 |
| Federal Register API | 232·301·122 포고문, 상무부 AD/CVD 행정심사 결과 고시 자동 수집 → 변경 감지 큐. | 키 불필요 무료 | Cloudflare Workers Cron(매일)으로 /api/v1/documents.json?conditions[term]=section+232 조회 → 신규 문서를 검토 큐(DB)에 적재. | 준비 |
| USITC HTS REST API | 미국 HTS 10단위 MFN 세율·Chapter 99 코드 동기화. | 키 불필요 무료 | hts.usitc.gov/reststop/search?keyword=7210.49 형태로 조회, 주 1회 diff → 관리자 승인 후 Measure 갱신. | 준비 |
| CBP CSMS (GovDelivery) | CBP 시행 지침(Chapter 99 코드, 신고 방법) 공지 수집. | 스크래핑 무료 | 공식 API 없음 → GovDelivery 이메일 구독을 Cloudflare Email Worker로 받아 파싱하거나 공지 페이지 크롤링. | 수동 |
| API | 용도 | 인증·비용 | 연결 방법 | 상태 |
|---|---|---|---|---|
| 한국은행 ECOS Open API ECOS_API_KEY | 원/달러 매매기준율 — 현재 화면의 환율(추정 1,400원)을 기준일별 실제값으로 대체. | API 키 무료(키 발급) | ecos.bok.or.kr 에서 인증키 발급 → Pages Function /api/fx 에서 일별 환율 조회 후 KV 캐시. | 키 필요 |
| Supabase (PostgreSQL + Auth) SUPABASE_URL / SUPABASE_ANON_KEY | 규칙·근거·이력 DB(현재는 코드 내 시드), 관리자 콘솔 로그인, 검토 큐, 사용자 워치리스트. | OAuth/계정 무료 티어 | supabase.com 프로젝트 생성 → docs/ARCHITECTURE.md의 스키마 적용(source_ids NOT NULL 제약) → URL·anon key를 Pages 환경변수로 등록. | 준비 |
| Trade.gov Consolidated Screening List API TRADE_GOV_API_KEY | 기업 수출통제(Entity List·SDN 등) 자동 조회 — 기업 카드의 수출통제 상태. | API 키 무료(키 발급) | developer.trade.gov 가입 → 구독 키 발급 → /api/screen?name=CXMT 형태의 Pages Function. | 키 필요 |
| API | 용도 | 인증·비용 | 연결 방법 | 상태 |
|---|---|---|---|---|
| Banxico SIE API BANXICO_TOKEN | 멕시코 페소 환율(IVA·DTA 계산용 MXN 환산). | 토큰 무료(토큰 발급) | banxico.org.mx SIE API 토큰 발급 → /api/fx에 MXN 추가. | 키 필요 |
| 멕시코 DOF (관보) | LIGIE 세율 개정·PROSEC/IMMEX 고시 수집. | 스크래핑 무료 | 공식 API 없음 → 일일 관보 목차 크롤링 + Claude로 관세 관련 고시 분류·요약 → 검토 큐. | 수동 |
| 공공데이터포털 (관세청·KOTRA) DATA_GO_KR_KEY | 관세청 품목분류·관세율, KOTRA 해외시장뉴스(통상 협상 대시보드 자동 갱신). | API 키 무료(활용신청) | data.go.kr 활용신청 → 서비스키를 Pages 시크릿으로 등록. | 키 필요 |
| UN Comtrade API COMTRADE_KEY | 정책 공백 시 레퍼런스 유사도(무역규모 비교) 계산. | API 키 무료 티어 | comtradedeveloper.un.org 구독 키 발급. | 키 필요 |
| Resend (이메일 알림) RESEND_API_KEY | 워치리스트 시나리오 결과 변경 시 이메일 알림. | API 키 무료 티어 | 도메인 인증 후 API 키를 Pages 시크릿으로 등록, Cron Worker에서 발송. | 키 필요 |