icosmos shop
by @taceywong
Shopify 店铺运营/诊断技能：从 Supabase 拉取店铺域名与 token，做装修/产品/结账/指标异常检测，并支持发布引流博文（唯一写操作）。
clawhub install icosmos-shop📖 About This Skill
name: icosmos-shopify description: "Shopify 店铺运营/诊断技能：从 Supabase 拉取店铺域名与 token，做装修/产品/结账/指标异常检测，并支持发布引流博文（唯一写操作）。"
icosmos-shopify
面向 OpenClaw 触发的 Shopify 运营能力集合：以只读诊断为主，帮助定位转化/营销/商品问题；唯一写操作是发布 Shopify Blog 文章（需要明确 --confirm）。
触发
setup once：用 ICOSMOS_USER_EMAIL / ICOSMOS_USER_PASSWORD 同步店铺与 token 到本地缓存
2. content/*：拉原始数据（更全面、更可追溯）
3. audit/* / test checkout：给诊断与验证
4. blog publish：仅当明确需要发布时执行（必须 --confirm）快速参考
| 诉求 | 命令 |
|---|---|
| Setup Once：从 Supabase 同步店铺/token 到本地 | icosmos-shopify setup once |
| 列出店铺 | icosmos-shopify stores list |
| 获取店铺基础信息（原始数据） | icosmos-shopify content shop --store xxx.myshopify.com |
| 获取产品列表（原始数据，分页） | icosmos-shopify content products list --store xxx.myshopify.com --first 20 --after |
| 获取订单列表（原始数据，时间窗） | icosmos-shopify content orders list --store xxx.myshopify.com --start |
| 获取博客列表/文章（原始数据） | icosmos-shopify content blogs list --store xxx.myshopify.com / icosmos-shopify content blogs articles list --store xxx.myshopify.com --blog-id 123 |
| 装修检查单（只读） | icosmos-shopify audit theme --store xxx.myshopify.com |
| 产品质量诊断（只读） | icosmos-shopify audit products --store xxx.myshopify.com --limit 50 |
| 结账链路测试（只读） | icosmos-shopify test checkout --store xxx.myshopify.com |
| 经营指标与异常线索（只读） | icosmos-shopify audit metrics --store xxx.myshopify.com --days 7 |
| 发布引流博文（写操作） | icosmos-shopify blog publish --store xxx.myshopify.com --blog-id 123 --title ... --body-file article.html --confirm |
输出协议（给 OpenClaw 更稳定）
--format json（content/* 默认就是 json），统一结构：store_domain / api_version / meta / data
meta.page_info.has_next_page/end_cursor
- REST：meta.page_info.next_link（来自 Link: rel="next"）依赖与配置
- ICOSMOS_USER_EMAIL
- ICOSMOS_USER_PASSWORD
两个字段需要保存到系统环境变量
所需命令行工具为当前目录下的icosmos-shopify
Shopify
SHOPIFY_API_VERSION（默认 2026-01）安全边界（重要）
--confirm；否则即使参数齐全也只会 dry-run。abcd...wxyz）。