NorthCinder适配器配置指南连接Shopify、eBay、Etsy、WooCommerce与Amazon的完整方法【免费下载链接】northcinderBuyer-run, ad-neutral shopping-agent MCP software with deterministic ranking, signed purchase mandates, and a local audit trail.项目地址: https://gitcode.com/gh_mirrors/no/northcinderNorthCinder是一款买家自持、广告中立的购物Agent MCP软件它能通过适配器连接Shopify、eBay、Etsy、WooCommerce与Amazon五大主流电商平台。本文是一份面向新手的NorthCinder适配器配置指南从准备环境到逐平台接入全程不需要编写代码只要照着配置环境变量即可让AI购物助手真正跑起来。快速起步先完成3项基础准备开始配置适配器之前请先确认以下三件事缺一不可Node.js 20 或更高版本NorthCinder 完全在本机运行需要新版 Node.js 支持。支持 MCP 的 AI 应用MCP 是 AI 应用连接本机工具的标准协议你需要一个已开启 MCP 功能的客户端。初始化配置在终端执行npx northcinder init初始化向导会引导你完成基础设置并自动打印需要填入 AI 应用的配置信息。初始化入口位于 launcher.ts支持northcinder init与northcinder service两种模式。 值得强调的是NorthCinder 没有云端账号所有搜索记录、设置与审计日志都保存在你自己的电脑上商家数据与佣金永远不会影响商品排名。Shopify适配器配置UCP Agent Profile 是关键Shopify 是五个平台中配置项最多的一个但核心只有两件事Global Catalog 跨店搜索与per-store 单店搜索。配置项说明SHOPIFY_UCP_AGENT_PROFILE_URL你自持的 HTTPS UCP Agent Profile JSON 地址匿名档无需密钥SHOPIFY_GLOBAL_CATALOG_API_KEY可选Dev Dashboard 兼容 Bearer用于提升速率档位SHOPIFY_GLOBAL_CATALOG_MCP_URLGlobal Catalog 端点覆盖默认指向https://catalog.shopify.com/api/ucp/mcpSHOPIFY_MCP_SHOPS逗号分隔的单店域名列表例如www.allbirds.com只要配置了 Profile URLNorthCinder 会优先走 Global Catalog 的search_catalog工具如果失败且配置了单店域名则自动回退到各店铺的/api/mcp端点。注意店铺域名必须是裸域名不允许通配符、路径或端口。相关实现见 shopify-adapter.ts。WooCommerce适配器配置最简单的一行配置WooCommerce 是配置成本最低的适配器因为它的Store API 是公开且无需认证的。你只需要在环境变量中填入店铺域名WOOCOMMERCE_STORE_HOSTSshop.example.com,another-shop.comNorthCinder 会以有界并发的方式同时搜索多家店铺单家失败不会影响其他店铺返回结果。底层调用的是https://host/wp-json/wc/store/v1/products公开端点详见 woocommerce-adapter.ts。⚠️ 注意如果某家店的防火墙或插件屏蔽了wc/store/v1端点NorthCinder 会如实报告「不可用」而不是假装搜出了一个空目录。eBay适配器配置申请 Buy API 密钥的完整流程eBay 原生搜索依赖eBay Buy Browse API需要先申请开发者账号与应用密钥配置项说明EBAY_CLIENT_IDeBay 应用客户端 IDEBAY_CLIENT_SECRETeBay 应用客户端密钥EBAY_ENVsandbox或productionEBAY_MARKETPLACE_ID可选市场 ID申请要点是Sandbox 与 Production 需要两套不同的密钥且 Production 使用 Buy API 需要单独通过 eBay 的资质审核审核不保证通过。缺少任一凭据时适配器会如实返回not_configured。另外适配器不会添加任何 eBay Partner Network 联盟参数保持中立。实现见 ebay-adapter.ts。Etsy适配器配置Personal App 与 API Key 申请方法Etsy 的访问模型分为 Seller App、Personal App 与 Commercial Access 三档。NorthCinder 面向买家、超越单店的使用场景至少需要审核更严格的 Personal App若涉及商业用途还需额外申请 Commercial Access。配置项说明ETSY_API_KEY获批应用的 keystring将获批的密钥填入ETSY_API_KEY后适配器会通过x-api-key请求头调用 Etsy Open API v3 的活跃商品接口。密钥缺失时返回not_configured密钥被拒或未授权则返回访问失败。需要提醒的是Etsy 官方禁止绕过 API 抓取数据请务必遵守站点规则。详见 etsy-adapter.ts。Amazon适配器配置只读浏览器会话模式Amazon 没有面向普通购物账号的目录 APICreators API 属于联盟计划且要求高因此 NorthCinder 的 Amazon 适配器走的是只读 Playwright 浏览器模式配置项说明AMAZON_SESSION_PROFILE你自有的 Chrome 浏览器 Profile 目录路径适配器会启动你已安装的 Chrome使用指定 Profile 完成搜索与商品详情读取。它有四条硬性边界不配置 Profile 就拒绝启动遭遇 CAPTCHA 或验证码立即终止不模拟键盘鼠标绕过限制完全没有结算能力。详情见 amazon-adapter.ts。适配器配置完成后的验证方法所有适配器都遵循「诚实报告」原则未配置返回not_configured访问失败返回unavailable绝不伪造结果。你可以用两种方式验证离线测试在各适配器目录执行pnpm test使用历史抓包数据验证映射逻辑。在线检查执行pnpm live-check它会真实访问你配置的店铺未提供凭据时自动跳过。五个适配器由服务入口统一注册注册逻辑集中在 adapters-from-env.ts每条搜索都会返回各店铺的状态方便你判断覆盖范围。常见问题速查表问题原因与解决返回not_configured对应的环境变量未填写补齐后重启服务返回unavailable店铺端点不可达检查域名是否正确、站点是否屏蔽了接口Shopify 搜索失败确认 UCP Agent Profile URL 可公开访问且为 HTTPSeBay 查询失败检查 Sandbox/Production 环境变量是否与密钥匹配Amazon 无法搜索确认AMAZON_SESSION_PROFILE指向有效的浏览器 Profile总结完成 NorthCinder 适配器配置其实不难WooCommerce 一行环境变量即可上线Shopify 需要理解 UCP Agent ProfileeBay 与 Etsy 需要先通过平台审核而 Amazon 走只读浏览器模式。配置完成后你就能用自然语言让 AI 助手跨平台比价、解释排名理由并在每次自动结算前获得你的明确批准。现在就从npx northcinder init开始你的第一步吧【免费下载链接】northcinderBuyer-run, ad-neutral shopping-agent MCP software with deterministic ranking, signed purchase mandates, and a local audit trail.项目地址: https://gitcode.com/gh_mirrors/no/northcinder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考