Sidekick KR Kakao Trade Patch

POE/POE2 거래 보조 프로그램 Sidekick v2026.6.4 portable에 한국 POE/POE2 거래소 주소 변경 패치를 적용한 비공식 임시 배포본입니다.

이 배포본은 공식 Sidekick 배포본이 아닙니다. 한국 거래소 주소가 Daum Games에서 Kakao Games로 이전된 뒤, Sidekick 한국어 거래 API 접속이 실패하는 문제를 임시로 우회하기 위한 패치판입니다.

ZIP 다운로드 릴리스 페이지 GitHub 저장소

문제 증상

한국어 POE2 환경에서 Sidekick 가격 검색을 실행하면 아래처럼 API 통신 실패 화면이 나올 수 있습니다.

Sidekick API 통신 실패 오류 화면

또는 거래 API 인증 관련 안내가 표시되면서 검색 결과가 나오지 않을 수 있습니다.

  • Sidekick failed to communicate with the trade API.
  • The trade website requires authentication, which Sidekick does not support currently.
  • Sidekick을 삭제 후 재설치하거나 캐시를 초기화해도 한국어 가격 검색 오류가 반복됨
  • 영어 강제 검색으로는 일부 우회가 가능해 보일 수 있지만, 한국어 아이템 비교/검색 흐름에서는 실패함

원인

최근 한국 POE/POE2 서비스의 거래소 주소가 기존 poe.game.daum.net에서 poe.kakaogames.com으로 바뀌었습니다.

그런데 Sidekick v2026.6.4 기준 한국어 거래 API 주소가 아직 Daum Games 주소를 바라보고 있어, 한국어 설정에서 거래 API 접속이 실패하는 문제가 발생했습니다.

패치한 부분

Sidekick의 한국어 게임 언어 설정인 GameLanguageKo.cs에서 거래소 기본 주소만 교체했습니다. 

기존:https://poe.game.daum.net/trade/https://poe.game.daum.net/api/trade/https://poe.game.daum.net/trade2/https://poe.game.daum.net/api/trade2/변경:https://poe.kakaogames.com/trade/https://poe.kakaogames.com/api/trade/https://poe.kakaogames.com/trade2/https://poe.kakaogames.com/api/trade2/

한국어 검색 검증

영어 강제 검색이 아니라 한국어 설정 그대로 검증했습니다. 

LanguageParser=koLanguageUi=koUseInvariantTradeResults=False검증 아이템=진홍색 목걸이DefinitionTradeType=진홍색 목걸이SearchTotal=10000결과 예시=진홍색 목걸이 - 환희, 진홍색 목걸이 - 돌풍

사용 방법

  1. ZIP 파일을 원하는 폴더에 압축 해제합니다.
  2. 압축을 푼 폴더의 Sidekick.exe를 실행합니다.
  3. Sidekick 설정에서 게임 언어와 UI 언어를 Korean으로 맞춥니다.
  4. 리그를 현재 POE2 리그로 선택합니다.
  5. 영어 강제 검색 옵션은 꺼둡니다.
  6. POE2에서 아이템 위에 마우스를 올리고 Sidekick 가격 검색 단축키를 사용합니다.

기본 가격 검색 단축키는 Sidekick 기본값 기준 Ctrl+D입니다.

ZIP 구성

다운로드 ZIP에는 실행에 필요한 포터블 파일만 남겼습니다. 설명서, 작업용 PowerShell 스크립트, 소스 diff, 빌드 정보 파일은 ZIP에서 제외했습니다. 

.portableSidekick.exeUpdate.execurrentpackages

다운로드 정보

주의사항

  • 이 파일은 공식 Sidekick 배포본이 아닙니다.
  • 원본 Sidekick은 MIT 라이선스 프로젝트입니다.
  • 원본 프로젝트 주소: https://github.com/Sidekick-Poe/Sidekick
  • 공식 Sidekick에서 Kakao 주소 패치가 반영되면 공식 최신 버전을 사용하는 것이 가장 좋습니다.
  • 공식 업데이트 후 다시 오류가 나면 이 릴리스의 ZIP을 새로 받아 새 폴더에 압축 해제한 뒤 실행하세요.
[2026-06-19 추가 패치 안내]
어제 배포한 Sidekick KR Kakao Trade Patch 사용 중, 오늘 POE2 거래소 패치 이후 일부 아이템에서 다시 검색 결과가 나오지 않는 문제가 확인되었습니다.

증상은 다음과 같습니다.

- Sidekick could not fetch the listings from the trade API.
- No results found
- 검색 API 상태는 Working으로 보이지만, 실제 매물 목록을 불러오는 단계에서 실패함

확인 결과, 이번 문제는 기존의 Daum → Kakao 주소 변경 문제가 아니라 Kakao 거래 API의 응답 형식이 일부 바뀐 것이 원인이었습니다.

특히 `trade2/fetch` 응답의 `explicitMods` 값이 기존 문자열 형태가 아니라 `{ description, hash, mods }` 형태의 객체로 내려오면서, Sidekick v2026.6.4가 해당 값을 읽지 못하고 오류가 발생했습니다.

이번 2026-06-19 버전에서는 아래 내용을 추가로 패치했습니다.

- 한국 거래 API 주소 Kakao Games 도메인 적용 유지
- `explicitMods` 등 mod 목록이 문자열/객체 어느 형태로 와도 읽을 수 있게 수정
- 한국어 아이템 검색 및 객체형 mod 응답 검증
- 예시 검증 아이템: 경계하는 시야 / 에메랄드 반지
- 회귀 테스트 통과 확인

기존 2026-06-18 버전을 받은 분들은 새 버전으로 다시 받아 주세요.

다운로드:
https://github.com/moreplus0/sidekick-kr-kakao-trade-patch/releases/download/v2026.6.4-kr-kakao-20260619/Sidekick-KR-KakaoTrade-v2026.6.4-20260619.zip

릴리스 페이지:
https://github.com/moreplus0/sidekick-kr-kakao-trade-patch/releases/tag/v2026.6.4-kr-kakao-20260619

SHA256:
40E760BAA53BD7F66C1AC926E9FB04085098CA70FB7C53F8E0783D156263C47F

주의:
이 파일은 공식 Sidekick 배포본이 아니라 한국 POE/POE2 거래소 변경에 대응하기 위한 비공식 임시 패치판입니다. 공식 Sidekick에서 같은 수정이 반영되면 공식 최신 버전을 사용하는 것이 가장 좋습니다.


[2026-06-21 업데이트] Sidekick KR Kakao Trade Patch v2026.6.5  
공식 Sidekick v2026.6.5에는 최근 거래 API 응답 변경 수정이 포함됐지만, 한국 거래소 주소는 아직 기존 Daum 주소로 남아 있습니다.  
이번 20260621 버전은 공식 v2026.6.5를 기반으로 한국 POE/POE2 거래 주소를 poe.kakaogames.com으로 변경했습니다. 기존 패치판 사용자나 공식 업데이트 후 API 오류가 다시 발생한 분은 새 ZIP을 받아 별도 폴더에 압축 해제해 사용해 주세요.  

다운로드 링크
https://github.com/moreplus0/sidekick-kr-kakao-trade-patch/releases/download/v2026.6.5-kr-kakao-20260621/Sidekick-KR-KakaoTrade-v2026.6.5-20260621.zip


금방 사이드킥에서 문제를 패치 하겠지라며 그 동안 기다리기 힘들어서 시작한 임시패치가 버전이 3번 업데이트 되네요. 에휴.. 그래도 여러분들이 사이드킥에 api경로 오류 이슈 전달 했다고 하니 조금만 더 기다려 보자구요.