Revised:
1. get_account_info(权限范围 account.read)
返回当前登录用户所属的公司、用户角色、订阅方案以及已启用的功能模块。AI 助手通常最先调用此工具,以确认正在读取谁的数据。
2. list_warehouses(权限范围 inventory.read)
列出公司旗下的所有仓库与库位,并标明哪些库位已与 Shopify 地点建立关联绑定。
3. search_products(权限范围 catalog.read)
支持按商品名称、SKU、条形码、品牌或型号搜索商品,为每个商品返回包含价格、类别和库存的简明摘要行。搜索结果支持分页;如需完整详细记录请使用 get_product。
4. get_product(权限范围 catalog.read)
返回单个商品的完整数据、各库位的库存分布以及在各大电商平台的刊登状态。
5. get_inventory_summary(权限范围 inventory.read)
按库位返回总库存数量,以便助手快速回答公司在各仓库分别保有存货的具体数量。
6. find_missing_product_data(权限范围 catalog.read)
查找缺少销售所需数据(图片、价格、类目、描述、条形码等)的商品,并指出具体缺失的内容。结果支持分页展示。
7. find_listing_problems(权限范围 catalog.read)
查找未能成功在电商平台或销售渠道上架的商品,并用通俗易懂的语言解释错误及提供解决方案,例如缺少 Allegro 类目所必需的 EAN 码。
8. find_unfulfilled_orders(权限范围 orders.read)
列出尚未发货的待处理独立站、电商平台及 B2B 订单,包含订单来源、合作伙伴及当前状态。
9. search_categories(权限范围 catalog.read)
按名称搜索商品类别树,返回类别 ID 和路径;update_product 使用该 ID 设置类别。
10. 写入工具的工作方式
写入工具需要 catalog.write 或 inventory.write 权限范围以及所有者或管理员角色。每个工具分两步执行:confirm=false 时只返回新旧值的预览;confirm=true 并提供 expected_version(来自预览或 get_product 的商品版本)时才保存。如果商品在此期间已被修改,保存会被拒绝。每次调用只修改一个商品,每次修改都以来源 mcp 记录,且无法删除任何内容。
11. update_product(权限范围 catalog.write)
修改单个商品的名称、描述、品牌、商品类型、类别、条形码、SKU、售价或状态(启用或草稿)。在此设置的价格视为手动价格,后台 AI 永远不会覆盖。SKU 需在单独的调用中修改。
12. adjust_stock(权限范围 inventory.write)
通过常规库存变动在某一地点设置、增加或减少单个商品的库存,因此库存变动日志和 Shopify 库存同步也会一并更新。
13. set_channel_listing(权限范围 catalog.write)
在某个平台或渠道上开启、关闭单个商品,或将其恢复为渠道规则。二手、翻新或损坏的商品永远无法在只接受新品的渠道(eMAG、Árukereső、Árgép、Pepita)上开启。
14. create_product(权限范围 catalog.write)
根据条形码或名称创建新商品,可选在某一地点设置初始库存。后台 AI 会识别该商品并在每个商品最多 5 次 AI 调用的常规限额内补全其余信息;已存在的条形码绝不会重复创建。
