Community연구 & 데이터 분석github.com

skuio/sku-skills

SKU.io API용 오픈소스 전자상거래 에이전트 스킬입니다. 한 번 작성하여 Claude, OpenAI, Gemini에서 사용할 수 있습니다.

sku-skills란 무엇인가요?

이 스킬은 AI 에이전트가 SKU.io API를 통해 제품을 조회하고 식별할 수 있도록 지원합니다. 사용자가 '파란색 위젯'과 같은 모호한 표현이나 바코드 스캔 결과를 입력하면, 이 스킬은 해당 제품의 고유 ID, SKU, 이름 및 세부 정보를 반환합니다. 이는 후속 작업에서 명확한 제품 참조를 제공하는 데 필수적입니다. SKU.io API의 products:read 스코프를 사용하며, 정확한 SKU 조회, 바코드 조회, 부분 이름/SKU 검색, ID 기반 조회 등 다양한 조회 방법을 제공합니다. 이 스킬은 Claude Code, Cursor, Codex 등 모든 주요 AI 에이전트 플랫폼에서 사용할 수 있도록 설계되었으며, 오픈소스로 제공되어 사용자 기여를 통해 지속적으로 개선됩니다.

지원 대상✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add skuio/sku-skills

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

제품 찾기

이 스킬을 사용하여 "파란색 위젯"이나 스캔된 바코드를 구체적인 SKU.io 제품(해당 id, sku, 이름 및 세부 정보)으로 변환하세요. 그러면 다운스트림 스킬이 명확한 참조를 가질 수 있습니다.

올바른 조회 선택

입력 유형호출설명
정확한 SKUGET /api/products/by-sku?sku=WIDGET-BLUE-01직접적이며 단일 결과 반환
스캔된 바코드 (UPC/EAN/GTIN)GET /api/products/barcode-lookup?code=0123456789012바코드를 제품으로 변환 (파라미터는 code)
부분 이름 또는 SKUGET /api/products/search?query=blue widget퍼지 검색, 여러 결과 반환 가능
숫자 제품 IDGET /api/products/{id}ID를 이미 알고 있을 때 전체 레코드 조회

항상 가장 구체적인 조회를 사용하세요. 정확한 SKU나 바코드가 없는 경우에만 search를 사용하세요. 이 경우 여러 후보가 반환될 수 있으므로 명확히 구분해야 합니다.

단계

  1. 제공된 정보를 바탕으로 위 조회 방법 중 하나를 선택합니다.

  2. Bearer 토큰(products:read 스코프 필요)과 함께 요청을 보냅니다:

    curl -sS "https://$SKU_TENANT.sku.io/api/products/by-sku?sku=WIDGET-BLUE-01" \
      -H "Authorization: Bearer $SKU_PAT" -H "Accept: application/json"
    
  3. 결과 처리:

    • 정확히 하나의 일치 → 해당 id와 sku를 캡처합니다. 완료입니다.
    • 검색 결과 여러 개 반환 → 정확한 sku를 일치시키거나, 상위 후보(이름 + sku)를 사용자에게 제시하여 선택하도록 합니다. 첫 번째 결과를 자동으로 선택하지 마십시오.
    • 일치하는 항목 없음 → 제품이 존재하지 않거나 보관 처리되었을 수 있습니다. ID를 임의로 생성하지 말고 그 사실을 보고합니다. 포기하기 전에 더 광범위한 search 쿼리를 고려하세요.

참고 사항

  • search는 페이지네이션됩니다. 자세한 내용은 shared/pagination.md를 참조하세요. 가장 적합한 결과는 첫 페이지에 있습니다. 조회 목적으로 페이지를 넘길 필요는 거의 없습니다.
  • 제품 id는 다른 스킬에서 기대하는 안정적인 키입니다(예: 판매 주문 라인의 product_id). 매번 SKU로 다시 확인하는 것보다 id를 다운스트림으로 전달하는 것이 좋습니다.

API 연산

메서드경로기능
GET/api/products/search제품 이름 또는 SKU 조각으로 퍼지 검색
GET/api/products/by-sku정확한 SKU로 단일 제품 조회
GET/api/products/barcode-lookup스캔된 바코드(UPC/EAN/GTIN)를 제품으로 변환
GET/api/products/{id}숫자 ID로 전체 제품 레코드 조회

인증

모든 요청은 SKU.io 개인 액세스 토큰을 Bearer 토큰으로 전송하여 인증합니다:

Authorization: Bearer <YOUR_SKU_PAT>
  • 기본 URL: https://{tenant}.sku.io ({tenant}를 계정 서브도메인으로 바꾸세요)
  • 필요한 스코프: products:read

SKU.io 웹 앱의 설정 → 개발자 → 개인 액세스 토큰에서 토큰을 생성하세요. 전체 흐름은 shared/authentication.md를 참조하세요.


이 스킬 개선하기

이 스킬이 부족한 점이 있었나요? 명확하지 않은 단계, 잘못된 엔드포인트, 또는 완료하지 못한 작업이 있다면 그냥 우회하지 말고, 문제점을 기록하고 풀 리퀘스트를 열어 다음 에이전트가 더 잘할 수 있도록 하세요.

  • 저장소: https://github.com/skuio/sku-skills
  • 정식 스킬은 skills/<domain>/<name>/ 아래에서 편집한 후(이 생성된 파일이 아닙니다), npm run build를 실행하고 PR을 여세요. 외부 기여자는 저장소를 포크한 후 PR을 보내주세요.
  • 전체 에이전트 워크플로는 AGENTS.md에 있습니다.

여러분의 에이전트가 이 모든 것을 처음부터 끝까지 할 수 있습니다. 누군가가 수정 사항을 보낼 때마다 라이브러리는 더 좋아집니다.

관련 스킬