超级商店MCP服务器
为Real Canadian Superstore提供的一款MCP服务器,用于提取订单和产品数据
带认证。
特点
- 订单管理完整的订单历史记录,包含商品详情、日期、价格,
图片 - DirectAuth快速承载令牌认证(无需浏览器)
- 数据导出将导出订单导出为CSV或JSON格式以便分析
- 产品探索/发现浏览类别并搜索产品
- 网页内容获取并解析网页
安装
快速安装至光标位置
注在点击安装按钮之前,请确保Cursor正在运行。
手动安装```bash
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`:```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 - 验证会话```json
{}
**`logout`** - 结束会议```json
{}
check_auth_status - 检查认证状态```json
{}
### 订单
**`get_orders`** - 获取订单历史```json
{
"limit": 10,
"offset": 0
}
get_order_details - 获取包含所有项目的完整订单```json
{
"order_id": "531900014110869"
}
**`get_recent_orders`** - 按日期筛选订单```json
{
"days": 90
}
export_orders_csv - 导出为CSV文件```json
{
"include_items": true,
"filepath": "./orders.csv"
}
**`export_orders_json`** - 导出为JSON格式```json
{
"include_items": true,
"filepath": "./orders.json"
}
产品
get_categories - 获取所有类别```json
{}
**`get_products`** - 从类别中获取产品```json
{
"category_ids": ["28251"],
"max_pages_per_category": 1
}
get_category - 获取单个类别```json
{
"category_id": "28251"
}
**`get_product`** - 搜索产品```json
{
"category_id": "28251",
"product_name": "bread"
}
search_products - 搜索产品(别名)```json
{
"category_id": "28251",
"product_name": "milk"
}
**`get_product_details`** - 从URL获取产品详情```json
{
"product_url": "https://www.realcanadiansuperstore.ca/..."
}
get_product_details_by_name - 搜索并获取详细信息```json
{
"category_id": "28251",
"product_name": "butter"
}
### 网络工具
**`fetch_txt`** - 将网页作为文本获取```json
{
"url": "https://www.realcanadiansuperstore.ca"
}
parse_sitemap - 解析网站地图```json
{
"sitemap_url": "https://www.realcanadiansuperstore.ca/sitemap_index.xml"
}
## 示例用法
### 导出所有订单```javascript
// Login
await mcp.call("login", {});
// Export with full item details
await mcp.call("export_orders_csv", {
"include_items": true,
});
分析支出```javascript
// 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
文档
- API 参考
- 认证指南
- 安全指南
许可证
麻省理工学院(MIT)
免责声明
非官方工具。与Loblaw Companies或Real Canadian无任何关联
大型超市。请合理使用。
版本2.0.0
