使用说明
超级商店MCP服务器
为Real Canadian Superstore提供的一款MCP服务器，用于提取订单和产品数据 带认证。
特点
- 订单管理完整的订单历史记录，包含商品详情、日期、价格， 图片
- DirectAuth快速承载令牌认证（无需浏览器）
- 数据导出将导出订单导出为CSV或JSON格式以便分析
- 产品探索/发现浏览类别并搜索产品
- 网页内容获取并解析网页
安装
快速安装至光标位置
注在点击安装按钮之前，请确保Cursor正在运行。
手动安装
# Run directly with npx
npx -y superstore-mcp@latest
# Or clone from GitHub
git clone https://github.com/ai-protocols/superstore-mcp.git
cd superstore-mcp
npm install
npm run build
配置
添加到您的 mcp.json：
{
"superstore-mcp": {
"command": "npx",
"args": ["-y", "superstore-mcp@latest"],
"env": {
"SUPERSTORE_BEARER_TOKEN": "your-token-here"
}
}
}
获取您的承载令牌（Bearer Token）
- 登录至 https://www.realcanadiansuperstore.ca
- 打开开发者工具（F12）→ 应用程序 → Cookies → www.realcanadiansuperstore.ca
- 查找
AccessTokencookie 并复制其值（以eyJ) - 粘贴到
SUPERSTORE_BEARER_TOKEN
令牌在约1小时后过期。请从浏览器中复制新的令牌以刷新。
可用工具
认证
login - 验证会话
{}
logout - 结束会议
{}
check_auth_status - 检查认证状态
{}
订单
get_orders - 获取订单历史
{
"limit": 10,
"offset": 0
}
get_order_details - 获取包含所有项目的完整订单
{
"order_id": "531900014110869"
}
get_recent_orders - 按日期筛选订单
{
"days": 90
}
export_orders_csv - 导出为CSV文件
{
"include_items": true,
"filepath": "./orders.csv"
}
export_orders_json - 导出为JSON格式
{
"include_items": true,
"filepath": "./orders.json"
}
产品
get_categories - 获取所有类别
{}
get_products - 从类别中获取产品
{
"category_ids": ["28251"],
"max_pages_per_category": 1
}
get_category - 获取单个类别
{
"category_id": "28251"
}
get_product - 搜索产品
{
"category_id": "28251",
"product_name": "bread"
}
search_products - 搜索产品（别名）
{
"category_id": "28251",
"product_name": "milk"
}
get_product_details - 从URL获取产品详情
{
"product_url": "https://www.realcanadiansuperstore.ca/..."
}
get_product_details_by_name - 搜索并获取详细信息
{
"category_id": "28251",
"product_name": "butter"
}
网络工具
fetch_txt - 将网页作为文本获取
{
"url": "https://www.realcanadiansuperstore.ca"
}
parse_sitemap - 解析网站地图
{
"sitemap_url": "https://www.realcanadiansuperstore.ca/sitemap_index.xml"
}
示例用法
导出所有订单
// Login
await mcp.call("login", {});
// Export with full item details
await mcp.call("export_orders_csv", {
"include_items": true,
});
分析支出
// Get recent orders
const orders = await mcp.call("get_recent_orders", { "days": 90 });
// Get details for each
for (const order of orders.orders) {
const details = await mcp.call("get_order_details", {
"order_id": order.id,
});
console.log(`${order.id}: ${details.items.length} items`);
}
建筑学
- DirectAuth使用浏览器中的承载令牌（推荐）
- API集成电话；通话
api.pcexpress.ca/pcx-bff带有适当的标题 - 备用模式如果未提供承载令牌，则使用Puppeteer进行浏览器自动化
- HTML 解析用于产品页面的JSDOM
文档
许可证
麻省理工学院（MIT）
免责声明
非官方工具。与Loblaw Companies或Real Canadian无任何关联 大型超市。请合理使用。
**仓库（或代码库）**https://github.com/ai-protocols/superstore-mcp（可翻译为：“https://github.com/ai-protocols/超级商店MCP（或超级存储多协议通信协议）”）
版本2.0.0
