NorthCinder làm gì
NorthCinder là một máy chủ Model Context Protocol mã nguồn mở, giúp tác nhân mua sắm AI so sánh sản phẩm theo bản yêu cầu do người mua xác định. Công cụ tạo danh sách rút gọn được xếp hạng, giải thích lý do mỗi ưu đãi nhận được vị trí tương ứng, xác định các lựa chọn bị loại và báo cáo những cửa hàng đã hoặc chưa được tìm kiếm.
NorthCinder chạy trên máy tính của bạn cùng với một ứng dụng AI hỗ trợ MCP. Chủ sở hữu kho mã không vận hành dịch vụ NorthCinder lưu trữ, hệ thống tài khoản, mặt phẳng điều khiển hay dịch vụ đo lường từ xa. Bạn tự chạy ứng dụng khách và công cụ tổng hợp, lựa chọn các kết nối cửa hàng, đồng thời lưu giữ cấu hình cục bộ và dữ liệu kiểm tra.
Một nguyên tắc thiết kế cốt lõi là tiêu chí của người mua quyết định thứ hạng. Khoản thanh toán từ người bán và thông tin liên kết không cải thiện vị trí của một ưu đãi. Kết quả được tài trợ vẫn được gắn nhãn và xếp dưới kết quả tự nhiên.
Tính năng chính
- Xếp hạng theo người mua: Các ưu đãi được sắp xếp theo yêu cầu trong bản yêu cầu mua sắm của bạn.
- Giải thích máy có thể đọc: Mỗi đề xuất bao gồm điểm số và các lý do có cấu trúc.
- Hiển thị lựa chọn bị loại: Các ưu đãi không đạt tiêu chí bắt buộc được báo cáo cùng với yêu cầu mà chúng không đáp ứng.
- Báo cáo phạm vi cửa hàng: Các cửa hàng không khả dụng, bị chặn và chưa được cấu hình vẫn hiển thị thay vì bị âm thầm bỏ qua.
- Bằng chứng về độ tin cậy của người bán: Mỗi người bán có bằng chứng hỗ trợ rõ ràng hoặc trạng thái chưa xác định trung thực.
- Nhãn nhất quán: Nhãn tài trợ và nguồn vẫn được gắn với từng ưu đãi.
- Xác minh cục bộ: Ứng dụng khách chạy lại việc xếp hạng xác định trên các đầu vào được dịch vụ công khai.
- Thanh toán có kiểm soát: Thanh toán tự động yêu cầu một ủy nhiệm phê duyệt đã ký, chỉ dùng một lần, gắn với ưu đãi, số lượng và hạn mức chi tiêu chính xác.
- Kiểm tra cục bộ: Các đề xuất, phê duyệt và lần thử thanh toán được ghi vào nhật ký kiểm tra cục bộ.
Việc xếp hạng lại cục bộ xác minh thứ tự được tạo từ các đầu vào đã công khai. Việc này không chứng minh rằng danh mục nguồn đầy đủ hoặc mọi thông tin do cửa hàng cung cấp đều chính xác.
Điều kiện tiên quyết
Để cài đặt tiêu chuẩn, bạn cần Node.js 20 trở lên và một ứng dụng AI hỗ trợ MCP. Từng tích hợp cửa hàng có thể yêu cầu quyền truy cập nền tảng, thông tin xác thực hoặc cấu hình bổ sung.
Cài đặt và khởi tạo NorthCinder
Bước 1: Chạy trình khởi tạo
Mở terminal và chạy:
npx northcinder initTrình khởi tạo hướng dẫn bạn thiết lập cục bộ và in ra cấu hình MCP cần thiết cho ứng dụng AI của bạn.
Bước 2: Thêm cấu hình MCP
Sao chép cấu hình do trình khởi tạo in ra vào khu vực cấu hình MCP của ứng dụng AI. Vị trí và quy trình kết nối chính xác tùy thuộc vào ứng dụng, vì vậy hãy làm theo tài liệu MCP của ứng dụng đó.
Bước 3: Kết nối hoặc khởi động lại ứng dụng AI
Áp dụng cấu hình rồi kết nối lại hoặc khởi động lại ứng dụng nếu cần. Khi đó, NorthCinder sẽ khả dụng với tác nhân dưới dạng máy chủ MCP cục bộ.
Gửi bản yêu cầu mua sắm đầu tiên
NorthCinder hoạt động tốt nhất với một bản yêu cầu cụ thể, bao gồm các thuộc tính bắt buộc, ngân sách, yếu tố so sánh và yêu cầu giải thích. Ví dụ:
Tìm giày chạy bộ len màu đen dưới $130. So sánh giá, giao hàng, độ vừa chân và độ tin cậy của người bán. Cho tôi biết vì sao sản phẩm thắng được xếp hạng đầu tiên và những lựa chọn nào bị loại.
Bản yêu cầu này xác định các tiêu chí bắt buộc như màu sắc, chất liệu, loại sản phẩm và giá tối đa. Bản yêu cầu cũng cho tác nhân biết những yếu tố cần so sánh, đồng thời yêu cầu tác nhân nêu rõ cả lý do lựa chọn sản phẩm đứng đầu và các phương án thay thế bị loại.
Kiểm tra phản hồi
Hãy xem xét nhiều hơn kết quả đầu tiên. Phản hồi của NorthCinder có thể bao gồm:
- Các ưu đãi đáp ứng tiêu chí bắt buộc.
- Điểm số và lý do máy có thể đọc cho từng đề xuất.
- Các ưu đãi bị loại và yêu cầu cụ thể mà mỗi ưu đãi không đáp ứng.
- Bằng chứng về độ tin cậy của người bán hoặc chỉ dấu rõ ràng rằng bằng chứng đang thiếu.
- Báo cáo phạm vi theo từng cửa hàng.
- Nhãn nguồn và tài trợ gắn với mọi ưu đãi.
Báo cáo phạm vi đặc biệt quan trọng. Nếu một cửa hàng không khả dụng hoặc bị chặn, không nên hiểu danh sách rút gọn được trả về là kết quả tìm kiếm đầy đủ trên toàn bộ thị trường.
Tìm hiểu quy trình tìm kiếm và phê duyệt
Ứng dụng AI của bạn giao tiếp với ứng dụng khách NorthCinder qua MCP. Ứng dụng khách giao tiếp với dịch vụ tìm kiếm do người mua vận hành, sử dụng các bộ điều hợp cửa hàng đã cấu hình. Kết quả được trả về ứng dụng khách để xếp hạng lại, giải thích và kiểm tra cục bộ.
Việc tìm kiếm và theo dõi giá không cấp quyền mua hàng. Trước khi thanh toán tự động, NorthCinder yêu cầu người mua phê duyệt giao dịch cụ thể. Ủy nhiệm được tạo sau đó đã ký, chỉ dùng một lần và gắn với ưu đãi, số lượng và hạn mức chi tiêu chính xác. Sổ cái nonce liên tiến trình bảo vệ ủy nhiệm khỏi việc sử dụng lại.
Tùy vào tích hợp khả dụng, giao dịch được phê duyệt có thể thực hiện qua kênh thanh toán hoặc chuyển giao giỏ hàng. Thông tin thẻ thô bị từ chối; các kênh thanh toán tự động sử dụng token thanh toán ủy quyền không thể hiện thông tin chi tiết khi có sẵn.
Cấu hình phạm vi cửa hàng
Quyền truy cập cửa hàng khác nhau tùy nền tảng. Hãy đọc tài liệu cho từng bộ điều hợp trước khi phụ thuộc vào bộ điều hợp đó trong quy trình thực tế.
- Shopify: Tính năng tìm kiếm danh mục khả dụng sau khi hoàn tất thiết lập Shopify bổ sung. Kết nối riêng theo từng cửa hàng trước đây không còn được sử dụng.
- WooCommerce: Tính năng tìm kiếm hoạt động với các cửa hàng cung cấp WooCommerce Store API công khai.
- eBay: Tìm kiếm gốc yêu cầu quyền truy cập eBay Buy API đã được phê duyệt.
- Etsy: Tìm kiếm gốc yêu cầu quyền truy cập ứng dụng Etsy đã được phê duyệt.
- Amazon: Có thể dùng hồ sơ trình duyệt do bạn kiểm soát để so sánh chỉ đọc. Tính năng này dừng khi gặp thử thách và không thực hiện thanh toán.
Khi không có quyền truy cập gốc, một tác nhân có thể so sánh các trang sản phẩm được phép bằng những công cụ trình duyệt mà tác nhân đó đã kiểm soát. NorthCinder tiếp nhận các thông tin sản phẩm đã được chuẩn hóa từ những quan sát này. NorthCinder không tiếp nhận cookie, HTML thô, ảnh chụp màn hình, chỉ dẫn trên trang, mật khẩu, mã dùng một lần hoặc khóa của nhà cung cấp AI.
Các ưu đãi do tác nhân quan sát không thể được dùng để thanh toán tự động hoặc theo dõi không cần giám sát cho đến khi một bộ điều hợp gốc hoặc giao thức của nhà bán hàng xác nhận chúng.
Xây dựng NorthCinder từ mã nguồn
Kho lưu trữ này là một workspace pnpm. Các gói sản phẩm yêu cầu Node.js 20 trở lên. Workspace trang web riêng tư yêu cầu Node.js 22.12 trở lên.
Bước 1: Cài đặt các phần phụ thuộc
corepack pnpm install --frozen-lockfileBước 2: Xây dựng workspace
corepack pnpm buildBước 3: Chạy trình khởi tạo cục bộ
node northcinder/bin/northcinder.js initKho lưu trữ cũng bao gồm các bước kiểm tra bản dựng ngoại tuyến, kiểu, kiểm thử, phần phụ thuộc, bí mật, đóng gói và bề mặt công khai. Xem CONTRIBUTING.md để biết đầy đủ các lệnh xác minh bản phát hành.
Mẹo sử dụng nâng cao
Viết các yêu cầu có thể kiểm thử
Hãy tách các yêu cầu bắt buộc khỏi các tùy chọn ưu tiên. Ví dụ, xác định giới hạn chi tiêu cứng và các thuộc tính sản phẩm bắt buộc, sau đó liệt kê những yếu tố so sánh mềm hơn như tốc độ giao hàng, độ vừa vặn và mức độ đáng tin cậy của nhà bán hàng. Cách này giúp dễ kiểm tra hơn các lý do loại bỏ và phần giải thích về thứ hạng.
Kiểm tra phạm vi bao phủ trước khi tin tưởng kết quả đứng đầu
Hãy kiểm tra bộ điều hợp nào đã thành công, bộ điều hợp nào bị chặn và bộ điều hợp nào chưa được cấu hình. NorthCinder cố ý hiển thị rõ những khoảng trống này. Ưu đãi đứng đầu là lựa chọn chiến thắng trong số các đầu vào đã được công bố và đánh giá thành công, không nhất thiết là mọi ưu đãi hiện có trên mạng.
Phân biệt xác minh với tính đầy đủ
Máy khách có thể chạy lại việc xếp hạng một cách xác định để xác minh rằng các tiêu chí người mua đã công bố tạo ra đơn hàng nhận được. Điều này không xác minh tính đầy đủ của danh mục hoặc đảm bảo rằng thông tin do cửa hàng cung cấp là chính xác. Hãy xem bằng chứng còn thiếu và trạng thái tin cậy chưa xác định là những giới hạn có ý nghĩa.
Giữ các quan sát từ trình duyệt trong đúng phạm vi
So sánh có hỗ trợ trình duyệt có thể hữu ích khi không có bộ điều hợp cửa hàng gốc, nhưng các ưu đãi được quan sát cần được xác nhận bằng bộ điều hợp gốc hoặc giao thức của nhà bán hàng trước khi theo dõi không cần giám sát hoặc thanh toán tự động. So sánh Amazon qua trình duyệt chỉ cho phép đọc, dừng khi gặp thử thách và không thực hiện thanh toán.
Bảo vệ thông tin xác thực và dữ liệu thanh toán
Hãy giữ khóa của nhà cung cấp AI trong ứng dụng AI và lưu thông tin xác thực cửa hàng giữa bạn với cửa hàng tương ứng. Không chuyển mật khẩu, mã dùng một lần, cookie hoặc thông tin thẻ thô cho NorthCinder. Xem tài liệu về quyền riêng tư và quyền sở hữu phần mềm cũng như chính sách bảo mật của kho lưu trữ để biết đầy đủ phạm vi này.
Kiểm tra các hợp đồng của dự án
Để thẩm định kỹ thuật sâu hơn, hãy xem đặc tả xếp hạng, kiểm toán tính trung lập, hợp đồng bộ điều hợp, đặc tả tin cậy, gói thanh toán và mã nguồn máy khách của kho lưu trữ. Các tài liệu này mô tả cách triển khai tính trung lập của xếp hạng, vị trí tài trợ, báo cáo phạm vi bao phủ, bằng chứng tin cậy, yêu cầu bắt buộc khi mua hàng và kiểm toán cục bộ.
Trạng thái dự án hiện tại
Phiên bản 0.1.2 là bản phát hành công khai đầu tiên. Phạm vi bao phủ của fixture và harness không chứng minh rằng thông tin xác thực của bên thứ ba hiện đang hợp lệ, mọi cửa hàng đều có thể truy cập trong môi trường sản xuất hoặc một giao dịch mua thực tế đã hoàn tất. Hãy xác minh tài liệu về bộ điều hợp liên quan trước khi dựa vào một tích hợp.
Gói này chưa được liệt kê trong MCP Registry chính thức và trang tiếp thị có trong kho lưu trữ chưa được xuất bản tại một nguồn gốc sản xuất chuẩn.
Kết luận
NorthCinder cung cấp nền tảng cục bộ, có thể kiểm tra cho hoạt động mua sắm có AI hỗ trợ. Nền tảng này kết hợp việc xếp hạng do người mua xác định, lý do loại bỏ rõ ràng, phạm vi bao phủ cửa hàng được hiển thị, bằng chứng về độ tin cậy của nhà bán hàng, kiểm toán cục bộ và phê duyệt theo từng giao dịch mua. Hãy bắt đầu bằng trình khởi tạo, kết nối cấu hình MCP được tạo, gửi yêu cầu cụ thể và kiểm tra cả lý do xếp hạng lẫn các khoảng trống về phạm vi bao phủ trước khi phê duyệt bất kỳ giao dịch mua nào.