skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
shoplazza/shoplazza-cli62 installs

shoplazza-shop

Store-level config & content for a shoplazza store — use for: shop info / settings (店铺信息 / 店铺设置 / 主域名 / 币种 / 客服邮箱 / customer email); sales & traffic analytics (销量 / 销售额 / 流量 / 流量渠道 / 搜索词 / 报表 / 数据分析 / analytics / PV UV / conversion / SKU 排行 / best-selling SKU); media library & file uploads (素材库 / 媒体库 / 上传文件 / upload file — store assets, NOT product images); metafields / 元字段 / 自定义字段 — ALL metafields live HERE, incl. ones ON products / orders / customers (给商品加字段); blogs & articles (博客 / 文章 / blog post); custom storefront pages (自定义页面 / 关于我们 / About Us / policy page); navigation menus (导航菜单 / 菜单项 / menu items); URL redirects (重定向 / 301 / URL 跳转); markets (市场 / 多市场 / 发布到日本市场); store languages (语言 / 多语言 / 翻译 / 开通日语); real-time rate carrier services (实时运费报价 / 承运商 / carrier service). NOT product catalog / 商品图片 (→ shoplazza-products); NOT 优惠码 (→ shoplazza-discounts); NOT order search / 订单统计 / 物流查询 (→ orders domain); NOT theme editing / 装修 / page templates (→ shoplazza-themes).

How do I install this agent skill?

npx skills add https://github.com/shoplazza/shoplazza-cli --skill shoplazza-shop
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides a comprehensive interface for managing Shoplazza store-level configurations, content, and analytics via the shoplazza CLI. No security vulnerabilities or malicious patterns were identified.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

shoplazza CLI — shop module

CRITICAL — before anything else, use Read on ../shoplazza-common/SKILL.md. It owns every cross-cutting mechanic: the three access tiers, the output envelope (.data), --dry-run, --jq (incl. "don't pass -r"), --fields, schema, api rest, auth / profiles, and the safety protocol. This file covers only the shop domain and never repeats them.

Overview

The shop module is the store-level config & content domain: shop info/settings, sales & traffic analytics, the media library (files), metafields (all three families), blogs & articles, custom pages, navigation menus, URL redirects, markets, store languages, and real-time shipping-rate carrier services. Broad and shallow — this file is the router; per-sub-area depth lives in references/.

The only shortcut is +upload-file — everything else is a spec leaf (--params / --data). All three access tiers apply (tier rule in shoplazza-common).

Command map

Intent → command, highest-fit tier first. Authoritative flags/params live in shoplazza shop <cmd> --help and shoplazza schema shop.<cmd>, not this table.

User intentCommand
Store info — 查店铺信息 / domain / currency / planshop info get (optional --params '{"fields":["id","domain"]}')
改客服邮箱 / change customer-service email (the ONLY editable field)shop info get --jq '.data.id' → shop info update --params '{"shop_id":"<id>"}' --data '{"shop":{"customer_email":"…"}}'
Analytics — 销售额/订单数报表 for a date rangeshop analytics overview --data '{"begin_time":"<unix-str>","end_time":"<unix-str>","indicator":["sales","orders"]}' → references/analytics.md
SKU 销量排行 / best-selling SKUshop analytics by-sku --data '{…,"sort_by":"sales_total","sort_direction":"desc"}'
SPU / landing-page / UTM breakdownshop analytics by-spu (extra required type) / by-land-page (required dimensions) / by-utm
搜索词分析 / 搜了没结果的词 / on-site search keywordsshop analytics search-keyword --data '{…,"sort_by":"count","sort_direction":"desc"}' (has_result is a string "0"/"1")
流量渠道 / 流量来源 / traffic by channelshop analytics traffic-channel (required dimensions + metrics); valid channel names: shop analytics traffic-channel-options
Media library — 上传文件到素材库 (public URL only)shop +upload-file --source-url <url> [--source-url <url> …] [--folder <name>]
Check an upload task / 上传进度shop files task --params '{"task_id":"<id>"}' (the shortcut already fetches it once)
Browse the media library / 看素材库shop files list (folder defaults to all_upload; page_size ≤ 300)
File detail / delete a fileshop files {get,delete} --params '{"file_uri":"<uri>"}'
Metafields — 店铺级 metafieldshop metafields-shop create --data '{"namespace":"…","key":"…","type":"string","value":"…"}' → references/metafields.md
Metafield ON a product/order/customer… (给商品加字段)shop metafields-resource create --params '{"owner_resource":"product","owner_id":"<id>"}' --data '{"definition_id":"…","namespace":"…","key":"…","type":"…","value":…}'
Define a metafield schema (元字段定义)shop metafields-definition create --params '{"owner_resource":"…"}' --data '{"name":"…","namespace":"…","key":"…","type":"…"}'
Blog content — 发博客文章 / new blog postshop articles create --data '{"article":{"title":"…","content":"…","blog_ids":["…"]}}' → references/blogs-articles.md
Manage blogs (containers of articles)shop blogs list / shop blogs create --data '{"blog":{"Title":"…"}}' (title key is capital Title)
Custom pages — 自定义页面 / 关于我们 / About Usshop pages create --data '{"page":{"title":"…","content":"…"}}' → references/pages-redirects.md
Navigation menus — 看导航菜单 / list menus & itemsshop menu list (built-ins have ids header / footer; one menu: --params '{"ids":["header"]}')
新建菜单 / create a custom menushop menu create --data '{"title":"…","children":[…]}' (custom menus only)
改菜单名 / 改菜单项 / edit a menushop menu update --params '{"id":"<menu-id>"}' --data '{"title":"…"}' — sending children replaces the whole item tree (see Gotchas)
删菜单 / delete a custom menushop menu delete --params '{"id":"<menu-id>"}' (built-in header / footer can't be deleted)
URL redirect — 301 / 跳转shop redirects create --data '{"redirect":{"from_url":"…","redirect_url":"…","status":"…"}}' (status required — see Gotchas)
Markets — 建市场 / 发布到某国shop markets create --data '{"name":"…","countries":["JP"]}' → references/markets.md
Languages — 开通语言 / 多语言shop languages supported → add → enable → publish → references/languages.md
Carrier services — 注册实时运费报价承运商shop carrier-services create --data '{"carrier_service":{"name":"…","callback_url":"…","carrier_code":"…"}}' → references/carrier-services.md

Write discipline

Config domain — no full ask-matrix, but these writes have required no-default fields. Missing or ambiguous → ask with AskUserQuestion (one batch), never fabricate. Never ask about defaulted/optional fields.

OperationMust ASK if missingDefault silently / never ask
+upload-filea public URL (local file → degrade: explain the API only fetches public URLs, ask for a link or a host)--folder (default all_upload)
pages createtitleurl, meta_*, independent_seo — omit; never fabricate SEO fields
redirects createfrom_url, redirect_url; status value if the wording doesn't settle it (enum not in schema — see Gotchas)—
metafields-shop createnamespace, key, type, valuedescription, definition_id (optional here)
metafields-resource createowner_resource+owner_id, definition_id, namespace, key, valuedescription; type — resolve from the definition (metafields-definition get) before asking
markets createname, countriesconfirm — never silently pass true (it deletes occupied markets)
carrier-services createname, callback_url (the user's own endpoint — never invent), carrier_codeactive, logo, short_desc
languages addthe language(s); resolve IETF codes via languages supported—
info updatethe new customer_emailshop_id — resolve it yourself via info get, don't ask
menu createtitle; each item's title + link target (resolve ids yourself)category (always custom 3), target, disabled
menu updatewhich menu (resolve the id via menu list), the changetitle / category — omit to keep them

Destructive leaves (pages batch-delete, markets delete — irreversible, files delete, redirects delete, metafields-* delete, menu delete, menu update with children) → --dry-run first + restate, per shoplazza-common → Safety protocol.

Boundaries

Reads like another domain (or another domain reads like shop):

Sounds likeActually belongs toCommand
给商品/订单加元字段 / metafield on a productHERE — all metafields live in shop, even product-owned onesshop metafields-resource create --params '{"owner_resource":"product",…}'
商品图片 / 主图 / image attached to a productshoplazza-productsproducts images create
上传文件 / 素材库 / media library assetHEREshop +upload-file / shop files …
销量/流量/转化 报表 / sales & traffic analyticsHEREshop analytics …
订单量统计 / 搜订单 / order count & searchorders domainorders +count / orders +search
实时运费报价承运商 / rate-quoting carrier at checkoutHEREshop carrier-services …
物流商查询 / 运单追踪 / fulfillment tracking carriers, shipping zonesorders domainorders tracking-carriers / orders shipping-schemas
自定义页面 / 关于我们 / brand-story pageHERE (content, not theming)shop pages create
导航菜单 / 菜单项 / add a link to the main menuHERE (menu content)shop menu list → shop menu update
页头显示哪个菜单 / bind a menu to the header cardshoplazza-themesthemes +edit (the card's link_list setting)
改模板 / 装修 / theme & template editing, layout of a custom pageshoplazza-themesthemes +page / themes +edit / themes template …
博客/文章 blog & articlesHERE (not product reviews)shop blogs / shop articles
买家评价 / product reviewsshoplazza-productsproducts comments …
优惠码 / 折扣 / discount codesshoplazza-discountsdiscounts +*

Permissions · Scope

Authorization is by domain (the unit of --domain), not per command. Authorization flow is in shoplazza-common → Authentication.

OperationNeedsGrant
read (info get, analytics *, files list/get/task, * list/get/count)shop read scopeauth login --domain shop
write (+upload-file, * create/update/delete, languages enable/publish, …)shop write scopeauth login --domain shop

Look up exact scope literals with shoplazza auth scopes; --domain shop expands into them.

Gotchas

Domain-specific pitfalls only (generic ones — .data prefix, --jq without -r — are in shoplazza-common).

SymptomCauseFix
Analytics call rejected / emptyEvery analytics report is POST (only traffic-channel-options is a GET): filters go in --data, not --params; begin_time/end_time are unix-second timestamps passed as STRINGS ("1782864000")Compute the timestamps, quote them as strings, send via --data
traffic-channel 400 cannot unmarshal object … filters of type stringIts filters is a JSON object encoded as a string; search-keyword's has_result is also a string"filters":"{\"last_referrer_first_show\":{\"operator\":\"in\",\"value\":[\"Social\"]}}"; "has_result":"0" — see references/analytics.md
Menu items lost after menu updatechildren replaces the whole item tree: items left out are deleted, [] clears the menuRead the menu first, edit the full tree, send all of it back (keep each existing item's id); omit children to change only the title
Nested menu items came back flat / nesting lostmenu list returns items flat — a sub-item points at its parent via pid; writes take nesting only as nested children (no pid field)Rebuild the tree from pid before sending children
Unsure what to put in a menu item's url_objThe link type values are not enumerated in the schemaCopy url_obj from an existing item of the same kind in menu list (type + source_id + url); never invent a type or source_id
Tried to update shop name/addressinfo update exposes one editable field: shop.customer_emailAnything else is not updatable via this endpoint; say so
info update needs a shop_id the user can't knowshop_id is a required path paramResolve first: shop info get --jq '.data.id'
Asked to upload a local file+upload-file takes public URLs, NOT local files (verbatim in its help); the API fetches the URLDegrade: no write; ask for a public link or suggest hosting it first
Upload "done" but file missingUpload is an async task — POST returns a task_id; the shortcut auto-fetches the task onceRe-check with shop files task --params '{"task_id":"…"}' until status/success_list settle
blogs create title ignored / rejectedBlog title key is capital Title (required, 1–100), not lowercase titleshop blogs create --data '{"blog":{"Title":"…"}}' — confirm fields via schema shop.blogs.create
What values can redirects status take?status is required but the schema documents no enum — do not invent oneCheck schema shop.redirects.create, inspect existing rules (shop redirects list --jq '.data.redirects[].status') or the OpenAPI docs; ask the user if still ambiguous
metafields-resource create rejected, metafields-shop create fineAsymmetry: resource-level requires definition_id; shop-level doesn't (optional). Type enums differ too (shop: JSON/string; resource: single_line_text_field, integer, …)See references/metafields.md
Language published but market relations vanishedlanguages publish is a full replacement — market_ids: [] removes ALL relationsAlways send the complete target list
Added a language, storefront unchangedNewly added languages are disabled by default; unsupported codes are silently droppedlanguages enable after add; verify codes via languages supported
markets create/update with confirm: true deleted other marketsA country may belong to only ONE market; confirm: true auto-deletes the occupied marketsPreview with markets preview, --dry-run, restate what gets deleted, get explicit consent
metafields-definition get 404s with id in pathIts id is a query param, not a path segmentshop metafields-definition get --params '{"id":123456}'

Recipes

# 1. Store's primary domain and currency
shop info get --jq '{domain: .data.domain, currency: .data.currency}'

# 2. Change the customer-service email (only editable field; two steps)
SHOP_ID=$(shop info get --jq '.data.id')
shop info update --params "{\"shop_id\":\"$SHOP_ID\"}" --data '{"shop":{"customer_email":"support@brand.com"}}'

# 3. Sales + order count, 2026-07-01 .. 2026-07-15 (unix seconds as STRINGS)
shop analytics overview --data '{"begin_time":"1782864000","end_time":"1784159999","indicator":["sales","orders"]}'

# 4. Best-selling SKU over a window (sort desc by sales metric)
shop analytics by-sku --data '{"begin_time":"1782864000","end_time":"1784159999","sort_by":"sales_total","sort_direction":"desc","page_size":10}'

# 5. Upload a public image to the media library (async task; folder defaults to all_upload)
shop +upload-file --source-url https://example.com/banner.png

# 6. Create an "About Us" custom page
shop pages create --data '{"page":{"title":"关于我们","content":"我们是一家来自杭州的 DTC 品牌"}}'

# 7. Permanent URL redirect (status REQUIRED — pin the value via schema/existing rules first)
shop redirects list --jq '.data.redirects[].status'   # see what values live rules use
shop redirects create --data '{"redirect":{"from_url":"/old-sale","redirect_url":"/new-sale","status":"<verified-value>"}}'

# 8. Shop-level metafield (no definition_id needed at shop level)
shop metafields-shop create --data '{"namespace":"global","key":"support_phone","type":"string","value":"400-800-1234"}'

# 9. Product-level metafield (owner in --params, definition_id REQUIRED in --data)
shop metafields-resource create --params '{"owner_resource":"product","owner_id":"66880"}' \
  --data '{"definition_id":"D8899","namespace":"specs","key":"material","type":"single_line_text_field","value":"cotton"}'

# 10. Launch Japanese and publish it to the Japan market
shop languages supported --jq '.data.languages'   # find the exact IETF code
shop languages add --data '{"codes":["ja-JP"]}'
shop languages enable --params '{"language_code":"ja-JP"}'
MARKET_ID=$(shop markets list --jq '.data.markets[] | select(.name=="Japan") | .id')
shop languages publish --params '{"language_code":"ja-JP"}' --data "{\"market_ids\":[\"$MARKET_ID\"]}"

# 11. Rename a custom menu without touching its items (no children = items kept)
shop menu list --jq '[.data.menus[] | {id, title, category}]'   # category 3 = custom
shop menu update --params '{"id":"<menu-id>"}' --data '{"title":"Footer links"}'

References

  • references/analytics.md — 7 POST reports + the channel-options lookup, indicators/dimensions, sort enums, timestamp rules
  • references/metafields.md — definitions vs resource vs shop metafields, owner_resource enum, type enums
  • references/blogs-articles.md — blogs (containers) vs articles (posts); blog title key is capital Title
  • references/pages-redirects.md — custom pages CRUD/batch, redirects & the undocumented status enum
  • references/markets.md — market lifecycle, country occupation/confirm, price/tax/domain/language
  • references/languages.md — add → enable → publish flow, full-replacement semantics
  • references/carrier-services.md — rate-quoting carrier registration
  • Per-command flags: shoplazza shop <cmd> --help
  • Spec-leaf params / body / response: shoplazza schema shop.<cmd> (nested: schema shop.metafields-resource.create)
  • Cross-cutting mechanics (auth / tiers / envelope / --dry-run / --jq / safety): ../shoplazza-common/SKILL.md

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/shoplazza/shoplazza-cli/shoplazza-shop">View shoplazza-shop on skillZs</a>