SuperAPI AI Directory

ziniao-account

General & other

View repository

Updated 10-16 09:45

About this skill

Account (store) management

CRITICAL — Before starting, MUST first use the Read tool to read ../ziniao-shared/SKILL.md CRITICAL — Before executing Shortcuts, be sure to first read the corresponding references/ documentation.

Ziniao's "account" refers to a browser store account (store), not an employee user. This module covers a total of 22 APIs, all of which already have shortcut commands.

Note the distinction: account commands pass throughserver-side API to manage store accounts (create, delete, authorize, tag). If you need to control the local browser window (open/close/navigate/screenshot), please use store + page commands (via the local ZClaw Bridge).

Choosing how to get the store list:

  • Member accounts do not have server-side account list permission, and should use store list(local ZClaw Bridge) to get the store list.
  • If the Boss account's purpose is to open the store browser, it should also preferentially use store list to get locally available stores, rather than account list。
  • account list Suitable for scenarios that require managing store metadata (tags, authorization, batch operations).
  • Member type can be determined via the ziniao-cli config show field in the isBoss result.

Shortcuts — Account CRUD

Command Description Detailed documentation
account list Query account list references/ziniao-account-list.md
account create Create account references/ziniao-account-create.md
account update Edit basic account information Send only modified fields:--id xxx --name "新名"
account delete Delete account (high risk) --id xxx, comma-separated for batch, requires --yes
# 查询
ziniao-cli account list --name "某店" --format table
ziniao-cli account list --page-all

# 创建
ziniao-cli account create --name "我的店铺" --site-id 1 --remark "测试"

# 修改
ziniao-cli account update --id 123 --name "新名称" --site-id 1

# 删除(批量)
ziniao-cli account delete --id "101,102,103" --yes

Shortcuts — Authorization management

Command Description
account auth-add Authorize employee access to store (--store-id and --staff-id both support comma-separated batch)
account auth-remove Revoke employee access permission (--store-id and --staff-id both support comma-separated batch)
account auth-clean Clear all employee authorizations for a store (high risk)
account auth-list Query the list of stores authorized for an employee
account auth-users Query the list of employees authorized for a store
# 批量授权(把 3 个店铺同时授权给 3 个员工)
ziniao-cli account auth-add --store-id "111,222,333" --staff-id "201,202,203"

# 撤销单人
ziniao-cli account auth-remove --store-id 111 --staff-id 201

# 查看某员工被授权的所有店铺
ziniao-cli account auth-list --user-id 201 --page-all --format table

# 清空授权(高风险)
ziniao-cli account auth-clean --store-id 111 --yes

Shortcuts — Tag management

Command Description
account tag-list Query all tags under the enterprise
account tag-of-store --store-id Query the list of tags bound to a store
account tag-create --name Create tag
account tag-rename --id --name Rename tag
account tag-delete --id Delete tag (high risk)
account tag-bind --tag-id --store-id Bind tag to store (--store-id supports batch)
account tag-unbind --tag-id --store-id Unbind (--store-id supports batch)
account tag-replace --store-id --tag-ids Fully replace the store's tag set
account tag-clear --store-id Clear all tags for a store (high risk)
account tag-remove --tag-id --store-id Remove this tag from the specified store (high risk,--store-id supports batch)

Underlying APIs and request body fields must be sent strictly according to the API documentation; do not send undocumented alias fields.

Command API Request body fields (excluding common companyId)
account tag-list /superbrowser/rest/v1/erp/tag/list None
account tag-of-store --store-id /superbrowser/rest/v1/store-tag/list storeId, optional withSystem
account tag-create --name /superbrowser/rest/v1/store-tag/add tagName
account tag-rename --id --name /superbrowser/rest/v1/store-tag/rename tid, name
account tag-delete --id /superbrowser/rest/v1/store-tag/delete tagIds
account tag-bind --tag-id --store-id /superbrowser/rest/v1/store-tag/bind tagIds, storeIds
account tag-unbind --tag-id --store-id /superbrowser/rest/v1/store-tag/unbind tagIds, storeIds
account tag-replace --store-id --tag-ids /superbrowser/rest/v1/store-tag/replace tagIds, storeIds
account tag-clear --store-id /superbrowser/rest/v1/store-tag/clear storeIds
account tag-remove --tag-id --store-id /superbrowser/rest/v1/store-tag/remove tagIds, storeIds
# 查看所有标签
ziniao-cli account tag-list --format table

# 查看某店铺已有标签
ziniao-cli account tag-of-store --store-id 101

# 创建标签后批量绑定到多个店铺
ziniao-cli account tag-create --name "重点店铺"
ziniao-cli account tag-bind --tag-id 99 --store-id "101,102,103"

# 全量替换(将店铺 101 的标签换成 99 和 100)
ziniao-cli account tag-replace --store-id 101 --tag-ids "99,100"

# 从多个店铺移除某个标签
ziniao-cli account tag-remove --tag-id 99 --store-id "101,102" --yes

General API Coverage (the only remaining interface)

# 缓存清理(仅此接口无快捷命令)
ziniao-cli api /superbrowser/rest/v1/erp/store/deletecookie --data '{"removeStoreId":"xxx","removeType":1}'
# removeType: 1=清除所有缓存, 2=仅保留 cookie, 3=仅保留二步验证状态

# 账号授权用户列表 / 用户有权限的账号列表
ziniao-cli api /superbrowser/rest/v1/erp/store/user/list --data '{"storeIdList":["xxx"],"page":1,"limit":10}'
ziniao-cli api /superbrowser/rest/v1/erp/user/stores --data '{"userId":"xxx","page":1,"limit":10}'