NorthCinder로 구매자가 통제하는 AI 쇼핑 워크플로 구축하기

NorthCinder의 기능

NorthCinder는 구매자가 정의한 조건에 따라 AI 쇼핑 에이전트가 제품을 비교하도록 돕는 오픈 소스 Model Context Protocol 서버입니다. 순위가 매겨진 후보 목록을 만들고, 각 상품이 해당 순위를 받은 이유를 설명하며, 제외된 옵션을 식별하고, 어떤 스토어를 검색했거나 검색하지 않았는지 보고합니다.

NorthCinder는 MCP를 지원하는 AI 애플리케이션과 함께 사용자의 컴퓨터에서 실행됩니다. 저장소 소유자는 호스팅 NorthCinder 서비스, 계정 시스템, 제어 플레인 또는 텔레메트리 서비스를 운영하지 않습니다. 사용자가 클라이언트와 집계 엔진을 실행하고, 스토어 연결을 선택하며, 로컬 구성과 감사 데이터를 보관합니다.

핵심 설계 원칙은 구매자 기준이 순위를 결정한다는 것입니다. 판매자 지불금과 제휴 정보는 상품의 순위를 높이지 않습니다. 스폰서 결과에는 계속 라벨이 표시되며 자연 검색 결과보다 낮은 순위에 배치됩니다.

주요 기능

• 구매자 중심 순위: 상품은 쇼핑 조건에 명시된 요구 사항에 따라 정렬됩니다.
• 기계 판독 가능한 설명: 각 추천에는 점수와 구조화된 근거가 포함됩니다.
• 공개되는 제외 결과: 필수 기준을 충족하지 못한 상품과 충족하지 못한 요구 사항이 함께 보고됩니다.
• 스토어 검색 범위 보고: 이용할 수 없거나 차단되었거나 구성되지 않은 스토어도 누락되지 않고 표시됩니다.
• 판매자 신뢰 근거: 각 판매자에는 명시적인 뒷받침 근거 또는 정직한 미확인 상태가 표시됩니다.
• 지속적인 라벨: 스폰서십 및 출처 라벨이 각 상품에 계속 연결됩니다.
• 로컬 검증: 클라이언트는 서비스가 공개한 입력을 바탕으로 결정적 순위를 다시 계산합니다.
• 통제된 결제: 자동 결제에는 정확한 상품, 수량 및 지출 한도에 연결된 서명된 일회용 승인 위임장이 필요합니다.
• 로컬 감사: 추천, 승인 및 결제 시도가 로컬 감사 추적 기록에 저장됩니다.

로컬 재순위 계산은 공개된 입력으로 생성된 순서를 검증합니다. 이것이 상위 서비스의 카탈로그가 완전했거나 모든 스토어 제공 정보가 정확했다는 것을 증명하지는 않습니다.

사전 요구 사항

표준 설치에는 Node.js 20 이상과 MCP를 지원하는 AI 애플리케이션이 필요합니다. 개별 스토어 통합에는 추가 플랫폼 액세스, 자격 증명 또는 구성이 필요할 수 있습니다.

NorthCinder 설치 및 초기화

1단계: 초기화 프로그램 실행

터미널을 열고 다음을 실행합니다.

npx northcinder init

초기화 프로그램이 로컬 설정 과정을 안내하고 AI 애플리케이션에 필요한 MCP 구성을 출력합니다.

2단계: MCP 구성 추가

초기화 프로그램이 출력한 구성을 AI 앱의 MCP 구성 영역에 복사합니다. 정확한 위치와 연결 절차는 애플리케이션에 따라 다르므로 해당 애플리케이션의 MCP 문서를 따르세요.

3단계: AI 앱 연결 또는 재시작

구성을 적용한 뒤 필요한 경우 애플리케이션을 다시 연결하거나 재시작합니다. 그러면 NorthCinder를 로컬 MCP 서버로 에이전트에서 사용할 수 있게 됩니다.

첫 쇼핑 조건 제출

NorthCinder는 필수 속성, 예산, 비교 요소 및 설명 요청이 포함된 구체적인 조건에서 가장 잘 작동합니다. 예:

130달러 이하의 검은색 울 러닝화를 찾아 줘. 가격, 배송, 착용감, 판매자 신뢰도를 비교해 줘. 우승 상품이 1위에 오른 이유와 제외된 옵션을 알려 줘.

이 조건은 색상, 소재, 제품 유형 및 최대 가격과 같은 필수 기준을 설정합니다. 또한 에이전트에 비교할 요소를 알려 주고, 선정 이유와 제외된 대안을 모두 공개하도록 요청합니다.

응답 검토

첫 번째 결과만 보지 말고 더 많은 내용을 검토하세요. NorthCinder 응답에는 다음이 포함될 수 있습니다.

1. 필수 기준을 충족하는 상품
2. 각 추천의 점수와 기계 판독 가능한 근거
3. 제외된 상품과 각 상품이 충족하지 못한 구체적인 요구 사항
4. 판매자 신뢰 근거 또는 근거가 없다는 명확한 표시
5. 스토어별 검색 범위 보고
6. 모든 상품에 연결된 출처 및 스폰서십 라벨

검색 범위 보고는 특히 중요합니다. 어떤 스토어를 이용할 수 없었거나 차단된 경우, 반환된 후보 목록을 전체 시장을 완전히 검색한 결과로 해석해서는 안 됩니다.

검색 및 승인 워크플로 이해

사용자의 AI 앱은 MCP를 통해 NorthCinder 클라이언트와 통신합니다. 클라이언트는 구매자가 실행하는 검색 서비스와 통신하며, 검색 서비스는 구성된 스토어 어댑터를 사용합니다. 결과는 로컬 재순위 계산, 설명 및 감사를 위해 클라이언트로 반환됩니다.

검색 및 가격 알림은 구매 권한을 부여하지 않습니다. 자동 결제 전에 NorthCinder는 특정 구매에 대한 구매자 승인을 요구합니다. 생성된 위임장은 서명된 일회용 문서이며, 정확한 상품, 수량 및 지출 한도에 연결됩니다. 프로세스 간 논스 원장이 위임장의 재사용을 방지합니다.

사용 가능한 통합에 따라 승인된 구매는 결제 레일을 통해 진행되거나 장바구니 전달 방식으로 처리될 수 있습니다. 원시 카드 정보는 거부되며, 가능한 경우 자동 결제 레일은 불투명한 위임 결제 토큰을 사용합니다.

스토어 검색 범위 구성

스토어 액세스 방식은 플랫폼마다 다릅니다. 실제 워크플로에서 사용하기 전에 각 어댑터의 문서를 읽어 보세요.

• Shopify: 추가 Shopify 설정을 완료한 후 카탈로그 검색을 사용할 수 있습니다. 이전의 스토어별 연결 방식은 더 이상 사용되지 않습니다.
• WooCommerce: 공개 WooCommerce Store API를 제공하는 스토어에서 검색할 수 있습니다.
• eBay: 기본 검색에는 승인된 eBay Buy API 액세스가 필요합니다.
• Etsy: 기본 검색에는 승인된 Etsy 애플리케이션 액세스가 필요합니다.
• Amazon: 읽기 전용 비교에는 사용자가 직접 관리하는 브라우저 프로필을 사용할 수 있습니다. 챌린지가 나타나면 중단하며 결제를 진행하지 않습니다.

기본 액세스를 사용할 수 없는 경우 에이전트는 자신이 이미 제어하는 브라우저 도구를 사용해 허용된 상품 페이지를 비교할 수 있습니다. NorthCinder는 이러한 관찰에서 정규화된 상품 정보를 받습니다. 쿠키, 원시 HTML, 스크린샷, 페이지 지침, 비밀번호, 일회용 코드 또는 AI 제공업체 키는 받지 않습니다.

에이전트가 관찰한 판매 정보는 기본 어댑터나 판매자 프로토콜을 통해 확인되기 전까지 자동 결제 또는 무인 모니터링에 사용할 수 없습니다.

소스에서 NorthCinder 빌드하기

이 저장소는 pnpm 워크스페이스입니다. 제품 패키지에는 Node.js 20 이상이 필요합니다. 비공개 사이트 워크스페이스에는 Node.js 22.12 이상이 필요합니다.

1단계: 종속성 설치

corepack pnpm install --frozen-lockfile

2단계: 워크스페이스 빌드

corepack pnpm build

3단계: 로컬 초기화 프로그램 실행

node northcinder/bin/northcinder.js init

이 저장소에는 오프라인 빌드, 타입 검사, 테스트, 종속성, 비밀 정보, 패키징 및 공개 표면 검사도 포함되어 있습니다. 전체 릴리스 검증 명령은 CONTRIBUTING.md를 참조하세요.

고급 사용 팁

테스트 가능한 요구사항 작성

필수 요구사항과 선호사항을 구분하세요. 예를 들어 엄격한 지출 상한과 필수 상품 속성을 지정한 다음, 배송 속도, 적합성, 판매자 신뢰도와 같은 비교 요소를 더 유연한 조건으로 나열하세요. 이렇게 하면 탈락 이유와 순위 설명을 더 쉽게 감사할 수 있습니다.

우승 상품을 신뢰하기 전에 검색 범위 감사

어떤 어댑터가 성공했는지, 어떤 어댑터가 차단되었는지, 어떤 어댑터가 설정되지 않았는지 확인하세요. NorthCinder는 이러한 공백을 의도적으로 드러냅니다. 최상위 상품은 공개되고 성공적으로 평가된 입력 중에서의 우승 상품일 뿐, 온라인에서 이용 가능한 모든 상품 중의 우승 상품은 아닐 수 있습니다.

검증과 완전성을 구분

클라이언트는 순위를 결정적으로 다시 실행하여 공개된 구매자 기준이 수신된 주문을 산출했는지 검증할 수 있습니다. 하지만 이는 카탈로그의 완전성을 검증하거나 스토어가 제공한 정보의 진실성을 보장하지 않습니다. 누락된 증거와 알 수 없는 신뢰 상태를 중요한 한계로 받아들이세요.

브라우저 관찰을 정해진 범위 안에서 유지

기본 스토어 어댑터를 사용할 수 없을 때 브라우저 지원 비교가 도움이 될 수 있지만, 관찰된 판매 정보는 무인 모니터링 또는 자동 결제 전에 기본 방식이나 판매자 프로토콜을 통해 확인해야 합니다. Amazon 브라우저 비교는 읽기 전용이며, 챌린지가 나타나면 중단하고 결제를 진행하지 않습니다.

자격 증명과 결제 데이터 보호

AI 제공업체 키는 AI 애플리케이션에 보관하고, 스토어 자격 증명은 사용자와 해당 스토어 사이에 보관하세요. 비밀번호, 일회용 코드, 쿠키 또는 가공되지 않은 카드 정보를 NorthCinder에 전달하지 마세요. 전체 경계에 대해서는 저장소의 개인정보 보호 및 소프트웨어 소유권 문서와 보안 정책을 검토하세요.

프로젝트 계약 검토

더 심층적인 기술 검증을 위해 저장소의 순위 사양, 중립성 감사, 어댑터 계약, 신뢰 사양, 결제 패키지 및 클라이언트 소스를 검토하세요. 이러한 자료에는 순위 중립성, 후원 배치, 범위 보고, 신뢰 증거, 구매 의무 및 로컬 감사가 구현되는 방식이 문서화되어 있습니다.

현재 프로젝트 상태

버전 0.1.2는 최초 공개 릴리스입니다. 픽스처 및 하네스 범위는 타사 자격 증명이 현재 유효하다는 것, 모든 스토어에 프로덕션 환경에서 접근할 수 있다는 것 또는 실제 구매가 완료되었다는 것을 입증하지 않습니다. 통합에 의존하기 전에 관련 어댑터 문서를 확인하세요.

이 패키지는 아직 공식 MCP 레지스트리에 등록되지 않았으며, 저장소에 포함된 마케팅 사이트도 표준 프로덕션 오리진에 게시되지 않았습니다.

결론

NorthCinder는 AI 지원 쇼핑을 위한 로컬 기반이자 직접 점검 가능한 토대를 제공합니다. 구매자가 정의한 순위, 명시적인 탈락 이유, 공개된 스토어 범위, 판매자 신뢰도 증거, 로컬 감사 및 구매별 승인을 결합합니다. 초기화 프로그램으로 시작하고, 생성된 MCP 구성을 연결한 다음, 정확한 요청을 제출하세요. 구매를 승인하기 전에 순위 결정 근거와 범위의 공백을 모두 검토하세요.