# 店铺

> Shoplazza AI Toolkit 中 shoplazza-shop 技能的自然语言指令示例：上传文件、加元字段、查销售分析、发博客与自定义页面、加 URL 重定向。

`shoplazza-shop` 技能的自然语言指令——店铺设置、内容、分析、元字段与文件。每条请求前加 `/shoplazza-shop` 前缀，再描述任务。

## 前置条件

* [快速开始](../get-started)
* 对店铺完成认证：`shoplazza auth login --store-domain <域名> --domain shop`

## 示例

### 1. 从 URL 上传文件

```
/shoplazza-shop 把这张图上传到媒体库:https://example.com/banner.jpg
```

运行 `shop +upload-file --source-url "https://example.com/banner.jpg"`。上传接受公网 URL，不接受本地文件。

### 2. 给商品加元字段

```
/shoplazza-shop 给商品 445566 加个自定义字段 material,值为 cotton
```

用 `shop metafields-resource create` 创建作用于该商品的元字段。所有元字段——包括商品/订单/客户上的——都在 shop 域。

### 3. 销量分析

```
/shoplazza-shop 看下 1 月的 SKU 销量排行
```

运行 `shop analytics by-sku --data '{"begin_time":"1767225600","end_time":"1769903999","sort_by":"sales_total","sort_direction":"desc"}'`。分析类调用都是 POST 请求：时间窗放在 `--data` 里，用字符串形式的 Unix 秒（此处为 2026 年 1 月，UTC）。

### 4. 发布博客文章

```
/shoplazza-shop 在博客 123 下发一篇《夏季穿搭》
```

用 `shop articles create` 在该博客下创建文章。

### 5. 创建自定义页面

```
/shoplazza-shop 建个"关于我们"页面
```

运行 `shop pages create`。

### 6. 添加 URL 重定向

```
/shoplazza-shop 把 /old-summer 重定向到 /collections/summer
```

运行 `shop redirects create`。

## 域边界

商品**主图/图片**属于 [`/shoplazza-products`](./products)，不在店铺媒体库；任何资源上的元字段都在**这里**。

## 参见

* [Shoplazza CLI:shop 命令](/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/shop)