eBay를 Claude와 연결하는 것은 개념적으로 어렵지 않습니다. OAuth 앱, 값 네 개, 권한 목록이면 됩니다. 어려운 점은 eBay가 그 값들을 다른 모든 마켓플레이스와 다르게 부르고, 한 필드가 URL처럼 생겼지만 URL이 아닌 것을 요구한다는 데 있습니다.
네 가지 값과 eBay에서의 명칭
App ID는 클라이언트 ID입니다. Cert ID는 클라이언트 시크릿입니다. 둘 다 eBay Developer Portal의 내 계정 → 애플리케이션 키에 있으며 그대로 복사해 붙여 넣으면 됩니다.
RuName은 많은 사람이 막히는 항목이므로 아래에서 별도로 설명합니다.
Marketplace ID는 어느 eBay 사이트에서 운영할지 선택하며, 해당 마켓플레이스가 지원하는 로케일과 일치해야 합니다. 대부분은 명확하지만 — 그렇지 않은 경우가 있습니다. eBay는 말레이시아와 싱가포르에 en-US를 지정합니다. 가이드보다 오류를 통해 알게 되는 전형적인 세부 사항입니다.
RuName은 주소가 아니라 이름입니다
개발자 포털에서 키 세트 → 사용자 토큰 → 내 애플리케이션을 통해 토큰 받기로 이동한 뒤 리디렉션 URL 항목을 만들거나 엽니다. 해당 항목에서 “인증 승인 시 URL”을 연결하려는 클라이언트의 콜백 주소로 설정합니다. Orkas는 https://orkas.ai/api/connectors/oauth/dcr-callback을 사용하며 별도 서버를 직접 마련할 필요가 없습니다.
그다음이 핵심입니다. eBay가 해당 항목에 대해 생성한 RuName을 복사하세요. 방금 입력한 URL 옆에 있는 짧고 의미를 알기 어려운 문자열입니다. 이를 요구하는 필드 주변이 URL 필드로 둘러싸여 있어 본능적으로 URL을 다시 붙여 넣게 됩니다. 그러면 승인이 되지 않으며, 반환되는 오류도 이유를 알려 주지 않습니다.
샌드박스는 지름길이 아닙니다
eBay는 무료 개발자 계정만 있으면 되고 정상 상태의 판매자 계정은 필요 없는 샌드박스를 운영합니다. API의 구조를 익히는 데는 실제로 유용합니다. 하지만 자신이 원하는 실제 상품 등록 정보와 주문을 다루는 데는 유용하지 않습니다. 샌드박스 데이터는 합성 데이터입니다.
Orkas의 새 연결은 프로덕션만 사용합니다. 따라서 이 설정에서 가장 오래 걸리는 부분은 나중에 고르는 클라이언트가 아니라 eBay Developers Program 신청입니다. 판매자 계정, 재고, 상품 등록, 주문 이행 권한을 가진 앱과 그 프로덕션 키 세트가 필요합니다. 일찍 시작하세요. 신청 결과를 기다리는 동안 공식 권한 부여 가이드를 읽어 볼 만합니다.
읽기는 쓰기와 다릅니다
키 세트가 생기면 권한 목록이 연결의 실제 용도를 결정합니다. 지난주에 무엇이 팔렸는지 묻는 것은 읽기입니다. 상품 등록 정보 수정, 재고 조정, 주문 발송 완료 표시는 쓰기이며, 앱에 해당 권한 범위가 필요합니다.
여러 호스팅형 eBay-Claude 연결 서비스는 설계상 읽기 전용이며, 그 자체로 합리적인 제품입니다. 다만 같은 제품은 아닙니다. 어느 쪽이든 앞서 필요한 신청 절차는 동일하므로, 신청에 수고를 들이기 전에 쓰기 기능을 확인하세요.
Orkas 커넥터는 사용자 기기에서 프로덕션 Sell API를 호출합니다. 자격 증명은 설정 파일이나 다른 회사의 서버에 보관하는 대신 기기에서 암호화되며, 실제 계정에 쓰는 모든 작업은 모델의 신중함에 맡기지 않고 클라이언트의 권한 확인 창을 거칩니다.
다른 방법이 더 나은 경우
보고서만 원한다면: 호스팅형 커넥터는 설정이 더 간단하고 설치할 것도 없습니다. 아무도 지켜보지 않아도 일정에 맞춰 실행되길 원한다면: 이것은 데스크톱 앱이므로 창을 닫으면 중지됩니다. 서버의 예약 작업이 적합합니다. 아직 API를 배우는 중이라면: 샌드박스와 무료 개발자 계정을 사용하고 아직 실제 계정에는 아무것도 연결하지 마세요.
같은 카탈로그에는 Etsy, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce와 중국 플랫폼도 포함되어 있어 스토어마다 자격 증명을 다루는 일을 처음부터 다시 시작할 필요가 없습니다. 관련 글인 Etsy와 Shopify에서는 두 플랫폼에 대해 같은 내용을 다룹니다.