ArcSolve-Kit/.env.example at main · ArcSolver/ArcSolve-Kit · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
# ─── Kakao ───────────────────────────────────────────────
# 카카오 개발자 콘솔(내 애플리케이션 > 앱 키)의 REST API 키
KAKAO_REST_API_KEY=
# (선택) 카카오 로그인 > 보안에서 'Client Secret'을 사용으로 설정한 경우에만
KAKAO_CLIENT_SECRET=
# 카카오 로그인 > Redirect URI 에 등록한 값과 정확히 동일해야 함
KAKAO_REDIRECT_URI=https://localhost
# `arcsolve-mcp auth kakao` 1회 실행 후 발급되는 값
# (생략 시 ~/.arcsolve/credentials.json 에 저장된 토큰을 사용)
KAKAO_REFRESH_TOKEN=

# ─── Telegram ────────────────────────────────────────────
# @BotFather에서 발급한 봇 토큰
TELEGRAM_BOT_TOKEN=
# (선택) 기본 대상 채팅 ID 또는 "@channelusername" — 도구 인자로 덮어쓸 수 있음
TELEGRAM_CHAT_ID=

# ─── Discord ─────────────────────────────────────────────
# 채널 설정 > 연동 > 웹후크에서 발급한 전체 Webhook URL (URL 자체가 시크릿)
DISCORD_WEBHOOK_URL=
# (선택) Bot 토큰 — 채널 직접 전송/조회(create_message·list_messages)용
DISCORD_BOT_TOKEN=

# ─── LINE ────────────────────────────────────────────────
# LINE Developers 콘솔에서 발급한 채널 액세스 토큰
LINE_CHANNEL_ACCESS_TOKEN=
# (선택) 기본 수신자 ID(userId/groupId/roomId) — 도구 인자로 덮어쓸 수 있음
LINE_TO=

# ─── Zotero ──────────────────────────────────────────────
# 백엔드 선택: web | local (미지정 시 ZOTERO_API_KEY 있으면 web, 없으면 local 자동)
ZOTERO_SOURCE=
# [web] zotero.org/settings/keys 에서 발급한 API 키(공개 라이브러리면 생략 가능)
ZOTERO_API_KEY=
# [web] 본인 라이브러리 userID(zotero.org/settings/keys 에 표시). 그룹이면 ZOTERO_GROUP_ID 사용
ZOTERO_USER_ID=
# [web] 그룹 라이브러리를 읽을 때만(설정 시 user보다 우선)
ZOTERO_GROUP_ID=
# [local] 데스크톱 로컬 API base (기본값; Zotero 데스크톱에서 로컬 API 활성 필요)
ZOTERO_LOCAL_BASE=http://localhost:23119/api

# ─── OpenAlex ────────────────────────────────────────────
# (선택) openalex.org/settings/api 에서 발급한 무료 API 키 — 키 없이도 동작(무료 일일 크레딧)
OPENALEX_API_KEY=
# (선택) polite pool용 연락 이메일 — 응답 안정성↑
OPENALEX_MAILTO=

# ─── Notion ──────────────────────────────────────────────
# 내 통합(notion.so/my-integrations)에서 발급한 Internal Integration Token 또는 PAT (필수)
# 읽을 페이지/DB를 통합과 공유(연결 추가)해야 함 — 공유 안 하면 404(object_not_found)
NOTION_TOKEN=

# ─── Crossref ────────────────────────────────────────────
# (선택) polite pool용 연락 이메일 — 무인증이지만 명시 시 레이트리밋 안정성↑(공식 etiquette 권장)
CROSSREF_MAILTO=

# ─── Semantic Scholar ────────────────────────────────────
# (선택) semanticscholar.org/product/api 에서 신청한 API 키 — x-api-key 헤더로 전송.
# 키 없이도 동작(공유 풀, 혼잡 시 429↑). 키 있으면 전용 풀(1 RPS).
SEMANTICSCHOLAR_API_KEY=

# ─── Wikipedia ───────────────────────────────────────────
# (선택) 식별/연락용 User-Agent — 미설정 시 기본 식별 문자열. Wikimedia는 User-Agent를 요구한다
# (없거나 약하면 403/스로틀). 공식 권장은 연락처 포함(예: "(myapp.com, you@example.com)").
WIKIPEDIA_USER_AGENT=
# (선택) Bearer 토큰 — 설정 시 Authorization: Bearer 헤더로 전송해 레이트리밋이 완화된다.
# 토큰 없이도 전체 읽기가 동작한다(무인증).
WIKIPEDIA_API_TOKEN=
# ─── Wikidata ────────────────────────────────────────────
# (선택·권장) 식별용 User-Agent — 미설정 시 기본 식별 문자열. Wikimedia는 식별 가능한 UA가 필수다
# (없으면 403/스로틀, WDQS가 특히 엄격). 공식 권장은 연락처 포함(예: "(myapp.com, you@example.com)").
WIKIDATA_USER_AGENT=
# (선택) Bearer 토큰 — Authorization: Bearer 헤더로 전송. 있으면 레이트리밋 완화(읽기는 토큰 없이도 동작).
WIKIDATA_API_TOKEN=

# ─── AirKorea(에어코리아) ────────────────────────────────
# data.go.kr '대기오염정보' OpenAPI(15073861) 활용신청 후 발급되는 서비스키 (필수)
# ⚠️ Encoding/Decoding 2종 중 **Decoding 키(원문)**를 넣을 것 — httpx 자동 인코딩으로 인한 이중 인코딩 방지
AIRKOREA_SERVICE_KEY=
# ─── PubMed (NCBI E-utilities) ───────────────────────────
# (선택) NCBI 계정 Settings 페이지에서 발급한 API 키 — 쿼리 파라미터 api_key 로 전송.
# 키 없이도 동작(초당 3건). 키 있으면 초당 10건.
NCBI_API_KEY=
# (선택·권장) 식별용 연락 이메일(공백 없는 유효 이메일) — 쿼리 email 로 전송
NCBI_EMAIL=

# ─── E-Gen(응급의료정보) ─────────────────────────────────
# data.go.kr '국립중앙의료원_전국 응급의료기관 정보 조회 서비스'(15000563) 활용신청 후 발급되는 서비스키 (필수)
# ⚠️ Encoding/Decoding 2종 중 **Decoding 키(원문)**를 넣을 것 — httpx 자동 인코딩으로 인한 이중 인코딩 방지
EGEN_SERVICE_KEY=
# ─── Seoul Transit(서울 실시간 교통) ─────────────────────
# ⚠️ 인증키 2종 분리 — 서울 열린데이터광장(data.seoul.go.kr)에서 각각 발급(URL path 세그먼트)
# 지하철 실시간 도착 전용 '실시간 지하철 인증키' (일반 인증키와 다름, 호스트 swopenAPI.seoul.go.kr)
SEOUL_SUBWAY_API_KEY=
# 따릉이 등 일반 데이터셋용 '일반 인증키' (호스트 openapi.seoul.go.kr:8088)
SEOUL_OPENDATA_API_KEY=

# ─── TAGO(국토부 전국 대중교통) ──────────────────────────
# data.go.kr 국토교통부 TAGO OpenAPI(네임스페이스 1613000 — 버스도착/정류소/노선·고속/시외버스·열차) 활용신청 후 발급되는 서비스키 (필수)
# 단일 키로 6개 서비스 전부 커버. ⚠️ Encoding/Decoding 2종 중 **Decoding 키(원문)**를 넣을 것 — httpx 자동 인코딩으로 인한 이중 인코딩 방지
TAGO_SERVICE_KEY=

# ─── Airport(인천국제공항 운항현황) ──────────────────────
# data.go.kr 인천국제공항공사 '항공기 운항 현황 상세 조회'(15140153 · 기관코드 B551177) 활용신청 후 발급되는 서비스키 (필수)
# ⚠️ Encoding/Decoding 2종 중 **Decoding 키(원문)**를 넣을 것 — httpx 자동 인코딩으로 인한 이중 인코딩 방지
# ⚠️ 개발계정은 일일 트래픽 500건 제한(운영계정은 활용사례 등록 후 상향)
AIRPORT_SERVICE_KEY=
# ─── EV Charger(전기차 충전소) ───────────────────────────
# data.go.kr '한국환경공단_전기자동차 충전소 정보' OpenAPI(15076352) 활용신청 후 발급되는 서비스키 (필수)
# ⚠️ Encoding/Decoding 2종 중 **Decoding 키(원문)**를 넣을 것 — httpx 자동 인코딩으로 인한 이중 인코딩 방지
EV_CHARGER_SERVICE_KEY=
# ─── Parking(한국교통안전공단 전국 주차정보) ─────────────
# data.go.kr 한국교통안전공단 '주차정보 제공 API'(15099883 — 시설정보/운영정보/실시간정보) 활용신청 후 발급되는 서비스키 (필수)
# 단일 키로 3개 오퍼레이션 전부 커버. ⚠️ 실시간 잔여면은 연동 주차장 한정.
# ⚠️ Encoding/Decoding 2종 중 **Decoding 키(원문)**를 넣을 것 — httpx 자동 인코딩으로 인한 이중 인코딩 방지
PARKING_SERVICE_KEY=