Metadata-Version: 2.5
Name: noon-workbuddy-api
Version: 1.0.0
Summary: Read-only noon seller operations MCP server for WorkBuddy
Author: noon 沙特站卖家工具集
License: MIT
Keywords: ecommerce,mcp,noon,operations,saudi,seller,workbuddy
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business
Requires-Python: >=3.11
Requires-Dist: cryptography<47,>=44
Requires-Dist: mcp<2,>=1.12
Requires-Dist: openpyxl<4,>=3.1
Description-Content-Type: text/markdown

# noon 运营 API for WorkBuddy

这是从 noon 工作区剥离出的独立只读 MCP 连接器。它只包含 noon 服务账号认证、报表读取、本地缓存和运营查询，不包含选品、1688、浏览器自动化、图片、Listing 发布、广告写入或 ASN 预订。

## 工具

- `noon_connection_status`
- `noon_get_orders`
- `noon_get_order_details`
- `noon_get_inventory`
- `noon_get_product_card`
- `noon_get_replenishment`
- `noon_get_operational_alerts`
- `noon_get_todo`
- `noon_get_sales_traffic`
- `noon_export_report`（高级白名单报表入口，最多返回100行）

全部业务能力为只读。报表导出接口只负责生成并下载 noon 报表，不修改订单、库存、价格或商品。

## 本机安装

```bash
./scripts/install-local.sh
```

安装后运行：

```bash
NOON_CREDENTIALS=/absolute/path/noon_credentials_sensitive.json \
NOON_DATA_DIR=/absolute/path/noon-data \
NOON_CONFIG=/absolute/path/config.json \
./.venv/bin/noon-workbuddy-check
```

WorkBuddy 使用根目录的 `mcp.json`。本机部署也可以直接把 `.venv/bin/noon-workbuddy-mcp` 作为 stdio MCP 命令添加到 WorkBuddy。

## 凭证

凭证 JSON 必须包含 `key_id`、`private_key` 和 `project_code`，权限必须是 `0600`。真实凭证、会话 Cookie、JWT、报表下载链接和订单缓存不会进入发布 ZIP。

环境变量：

- `NOON_CREDENTIALS`：服务账号凭证绝对路径。
- `NOON_DATA_DIR`：独立缓存目录，建议权限 `0700`。
- `NOON_CONFIG`：可选商品别名和补货参数配置。
- `NOON_WAIT_SECONDS`：单次报表等待秒数，默认 50，范围 0—60。

## 日期和数据口径

沙特站日期统一按 `Asia/Riyadh`。订单数按订单号去重，件数按非取消且非退回的商品行统计。库存使用报表最新快照；缺失不能视为零。补货建议使用日历日均销量，并明确输出缺项和滞后信息。
