이 레포, 나한테 필요한가?
사람 검수 전
- 무엇인가
- NorthCinder는 AI 쇼핑 도우미가 상품을 비교하고, 설명하고, 구매 전에 승인을 받도록 도와주는 프로그램이에요.
- 마치 공정한 쇼핑 가이드처럼, 광고비를 낸 판매자가 검색 결과에서 더 위에 올라오지 못하게 하고, 모든 추천 이유를 투명하게 보여줘요.
- 사용자가 직접 컴퓨터에 설치해서 쓰는 '로컬 퍼스트' 방식이라 개인정보도 안전하게 보호할 수 있어요.
[README-001 · README-002 · README-003]- 할 수 있는 일
- 공정한 AI 쇼핑 도우미 [README-001 · README-003 · README-004]
- 진입 조건
- 중급자용 · JavaScript [분석]
- 먼저 확인
- 이 도구는 MCP를 지원하는 AI 앱에서만 작동하므로, 사용하는 AI 앱이 MCP를 지원하는지 먼저 확인해야 합니다. [README-002]
이걸로 실제로 할 수 있는 일
기능명보다 사용자가 완성할 수 있는 작업과 결과를 우선해 정리했습니다.
공정한 AI 쇼핑 도우미
광고비에 영향받지 않고, 사용자 기준에 따라 상품을 비교하고 추천하는 AI 에이전트를 만들 수 있습니다.
투명한 구매 감사 시스템
모든 추천과 구매 결정에 대한 이유와 증거를 기록하여, 나중에 검토할 수 있는 로컬 감사 추적 시스템을 구축할 수 있습니다.
개인정보 보호 쇼핑 플랫폼
사용자 컴퓨터에서만 작동하여 데이터가 외부로 유출되지 않는, 프라이버시 중심의 쇼핑 경험을 제공할 수 있습니다.
기능보다 중요한 건
내 상황과의 적합성.
공식 기능과 시작 조건을 바탕으로 한 AI 판단입니다. 도입 전 원문과 실제 환경에서 다시 확인하세요.
- AI 쇼핑 도우미를 직접 만들고 싶은 경우
- 광고에 영향받지 않는 공정한 상품 추천이 필요한 경우
- 개인정보 보호를 중요시하며 로컬에서 모든 처리를 원하는 경우
- 구매 결정 과정을 투명하게 기록하고 감사하고 싶은 경우
- 이미 완성된 쇼핑 플랫폼에 빠르게 기능을 추가해야 하는 경우
- MCP를 지원하지 않는 AI 앱을 사용 중인 경우
기술과 도입 조건
자동 감지된 기술 스택, 문서 상태와 유지보수 메모를 한곳에 모았습니다.
Node.js 20+ · MCP (Model Context Protocol) · TypeScript · pnpm
README에 상세한 사용 예시와 설정 가이드가 포함되어 있습니다. RANKING.md, NEUTRALITY-AUDIT.md, TRUST.md 등 별도 문서가 존재합니다.
최근 24시간 내 push 기록이 있습니다. 유지보수 품질과 응답 속도는 별도 확인이 필요합니다.
코드 위험 신호를 확인하고 있습니다.
저장소를 실행하지 않고 공개 텍스트 파일과 설치 경로를 읽고 있습니다.
저장소 전체 정적 검사
커밋을 고정하고 저장소의 소스 파일 전체를 파일 단위로 확인합니다. 설치·빌드·실행은 하지 않습니다.
가장 짧은 시작 경로
- 01설치
터미널에서 `npx northcinder init` 명령어를 실행하면 설정이 시작됩니다.
- 02실행
설치 후 AI 앱에 MCP 설정을 추가하고, '검은색 울 러닝화 130달러 미만 찾아줘' 같은 구체적인 요청을 해보세요.
GitExplain 자동 분석은 설치 명령을 직접 실행해 검증한 결과가 아닙니다.
아래 내용을 Codex 같은 코딩 에이전트에 붙여 넣으면 공식 문서를 다시 확인한 뒤 내 환경에 맞는 설치를 안내합니다.
너는 내 로컬 개발 환경에서 오픈소스 저장소를 안전하게 설명하고 설치하는 시니어 엔지니어야.
저장소: https://github.com/cinderline/northcinder
GitExplain 요약: NorthCinder는 AI 쇼핑 도우미가 상품을 비교하고, 설명하고, 구매 전에 승인을 받도록 도와주는 프로그램이에요. 마치 공정한 쇼핑 가이드처럼, 광고비를 낸 판매자가 검색 결과에서 더 위에 올라오지 못하게 하고, 모든 추천 이유를 투명하게 보여줘요. 사용자가 직접 컴퓨터에 설치해서 쓰는 '로컬 퍼스트' 방식이라 개인정보도 안전하게 보호할 수 있어요.
주요 언어: JavaScript
난이도 메모: 중급자용
해야 할 일:
1. 먼저 저장소의 최신 README, 설치 문서, manifest를 읽고 현재 기본 브랜치 기준으로 설명해줘.
2. 이 저장소가 무엇이고 내가 무엇을 만들 수 있는지 비개발자도 이해할 수 있게 짧게 설명해줘.
3. 내 운영체제와 기존 개발 환경을 먼저 질문한 다음, 가장 안전한 설치 방법을 단계별로 제시해줘.
4. 명령을 실행하기 전 각 명령이 바꾸는 것과 예상 결과를 알려줘. 파괴적인 명령은 자동 실행하지 마.
5. 필요한 API 키나 비밀 값은 채팅이나 코드에 직접 적게 하지 말고 환경 변수와 .env 예시로 안내해줘.
6. 설치 후 최소 예제를 실행해 성공 여부를 확인하고, 실패하면 오류 원인과 되돌리는 방법을 알려줘.
7. GitExplain 요약과 공식 문서가 다르면 공식 문서를 우선하고 차이를 명시해줘.
GitExplain이 정리한 시작 메모:
1. 설치: 터미널에서 `npx northcinder init` 명령어를 실행하면 설정이 시작됩니다.
2. 실행: 설치 후 AI 앱에 MCP 설정을 추가하고, '검은색 울 러닝화 130달러 미만 찾아줘' 같은 구체적인 요청을 해보세요.도입 전에 놓치기 쉬운 점
이 도구는 MCP를 지원하는 AI 앱에서만 작동하므로, 사용하는 AI 앱이 MCP를 지원하는지 먼저 확인해야 합니다.
[MEDIUM · README-002]근거 원장
이 표는 원문이 어떤 분석 항목에 연결됐는지를 보여주며, 사실 정확도를 보증하는 점수는 아닙니다.
이 해설로 저장소를 이해하셨나요?
입력 내용 없이 선택 결과만 기록합니다.