功能描述

快手生活服务-商家经营助手,为商家提供查询商品、查询商家门店、查询商家职人、查询商家官方账号、查询商家子账号、查询商家的经营数据等能力;

使用说明 (SKILL.md)

快手生活服务-商家经营助手

Name: kuaishou-lifeservice-business-assistant
Author: qingfeng9924

appkey配置引导

⚡ 快速开始

开发者申请 → 商家确认授权 → 获取 apiKey → 开始使用

龙虾使用前置准备操作

如下为授权申请流程：

打开快手开放平台：https://open.kwailocallife.com/
点击「Skill 接入」→「立即接入」
填写商家 ID，提交授权申请
等待商家确认授权
确认授权状态变为「已授权」后，复制 apiKey 发送给龙虾就可以使用了

联系商家确认授权

如下为确认授权流程：

主账号登录商家后台
打开应用授权页面：https://lbs.kwailocallife.com/ll/merchant/league-sub/shop/empower
在「待授权」列表中找到应用，点击「确认授权」

注意

商家必须用主账号登录
授权后请及时告知开发者

示例配置

ks700591219338675217#20234234234#sdfdsfas

快速使用：把以上配置信息直接发送给我就能测试验证啦。

🔐 账号配置指南

添加您的商家账号

在使用各项功能前，请先添加您的快手商家账号信息：

账号信息格式：{app_key}#{merchant_id}#{app_secret} （这3个信息可以在快手开放平台的后台获取）

添加账号

python3 scripts/api_key_manager.py --add "您的app_key#您的merchant_id#您的app_secret"

添加成功后，系统会自动保存您的账号信息，下次使用时无需重复输入。

查看已保存的账号

python3 scripts/api_key_manager.py --list

会显示类似这样的结果：

[1] app_key=ks656118173425091421, merchant_id=1234567
[2] app_key=ks656118173425091422, merchant_id=1234568 (当前使用)

切换使用哪个账号

如果您有多个门店账号，可以这样切换：

python3 scripts/api_key_manager.py --select 1

查看当前使用的账号

python3 scripts/api_key_manager.py --current

功能

操作	说明	触发示例
查询商家品牌资质	查询商家品牌资质	"商家品牌资质"
查询职人	查询商家职人信息	"职人列表"、"查询职人"
查询职人数据	查询商家职人数据	"职人数据"、"查询职人数据汇总"
查询实时经营汇总	查询商家实时交易/退款数据	" 查询交易实时汇总 "、" 查询退款数据汇总"
查询待办事项	查询商家待办事项	"商家待办事项"、"查询待办事项列表"
查询职人自动激励	查询商家职人自动激励	"查询职人自动激励信息"、"查询商家职人激励信息"
查询子账号	查询商家子账号列表	"查询子账号列表"、"查询子账号" 、"有哪些子账号"
查询经营数据	查询经营数据	"经营表现"、"经营情况"、"经营状况"、"GMV表现" 、"诊断数据"、"经营数据" 、"店铺数据" 、"交易数据"
评价管理	查询某个门店的用户评价评分	"用户评价评分"、"评价评分"、"查询某个门店"、"门店评分"
评价管理	查询某个门店下最新的某些条件的评论	"最新用户评价评分"、"最新评价评分"、"最新查询某个门店"、"最新门店评分"
评价管理	查询评价分析	"分析评价"、"评价分析"
扫码物料	查询某个门店最新一条物料信息 & 下载	"下载"、"物料信息"、"最新物料"
应用授权	查询已授权 & 未授权的应用列表	"已授权"、"未授权"、"应用列表"
查询商家基础激励	查询商家商品基础激励的总体状态（激励中数量 & 未激励数量）	"激励中数量"、"激励数量"、"基础激励"
查询职人定向激励	查询职人的定向激励数据	"职人定向激励"、"职人激励"、"定向激励"
查询门店认领	查询商家门店认领信息	"门店认领信息"、"门店资质"
查询合同	查询商家合同信息	"合同列表"、"查询合同"
查询区域	查询商家区域信息	"区域"
官方账号管理	查询官方账号信息	"官号"
查看商品	查询商品列表	"查看商品列表"、"查询商品"、"商品状态"
门店商品	查询门店商品列表	"门店商品列表"、"查询门店商品"
商品门店	查询商品门店列表	"商品关联门店"、"查询商品门店"

脚本

脚本	功能
`scripts/call_api.py --api query_brand_info_list`	查询商家品牌资质
`scripts/call_api.py --api artisan_list`	查询职人列表
`scripts/call_api.py --api staff_user_info`	查询子账号列表
`scripts/call_api.py --api todo_list`	查询商家数据
`scripts/call_api.py --api merchant_artisan_metric`	查询商家职人数据
`scripts/call_api.py --api merchant_realtime_metric`	查询商家交易实时汇总
`scripts/call_api.py --api merchant_refund_metric`	查询商家经营退款数据
`scripts/call_api.py --api artisan_auto_commission`	查询商家职人自动激励信息
`scripts/call_api.py --api item_commission`	查询商家商品基础激励的总体状态
`scripts/call_api.py --api artisan_direct_commission`	查询职人的定向激励数据详情
`scripts/call_api.py --api comment_analysis`	查询评价分析
`scripts/call_api.py --api poi_qrcode`	获取门店的扫码物料信息
`scripts/query_report.py`	查询经营数据
`scripts/call_api.py --api merchant_area_list`	查询商家区域列表
`scripts/call_api.py --api merchant_contracts`	查询合同信息
`scripts/call_api.py --api query_poi_manage_list`	查询门店认领信息
`scripts/call_api.py --api query_official_account`	查询官方账号信息
`product_api.py --api item_list`	查看商品列表
`product_api.py --api item_sku_list`	查询门店维度商品列表
`product_api.py --api item_poi`	查询商品维度的门店列表

使用方法


# 查询已授权 & 未授权的应用列表
python3 scripts/call_api.py --api query_developer_auth_list 
#查询商家品牌资质
python3 scripts/call_api.py --api query_brand_info_list
#查询商家区域列表
python3 scripts/call_api.py --api merchanrt_area_list
#查询商家合同信息
python3 scripts/call_api.py --api merchant_contracts
#查询门店认领信息
python3 scripts/call_api.py --api query_poi_manage_list
# 查询商家职人自动激励的状态信息：
python3 scripts/call_api.py --api artisan_auto_commission
#查询商家商品基础激励的总体状态：
python3 scripts/call_api.py --api item_commission --current_page 1 --page_size 10
#查询职人的定向激励数据详情：
python3 scripts/call_api.py --api artisan_direct_commission --current_page 1 --page_size 10
# 24. 查询评价分析
python3 scripts/call_api.py --api comment_analysis --out_poi_id 门店ID --start_date 20260101 --end_date 20260320
# 查询职人列表
python3 scripts/call_api.py --api artisan_list --current_page 1 --page_size 100
# 获取商家职人的整体经营数据：
python3 scripts/call_api.py --api merchant_artisan_metric --start_date 20260101 --end_date 20260320
# 查询某个具体职人的经营数据：
python3 scripts/call_api.py --api artisan_metric --artisan_id 职人ID --start_date 20260101 --end_date 20260320
# 获取商家的待办事项列表：
python3 scripts/call_api.py --api todo_list
# 查询商家某个子账号的详细信息：
python3 scripts/call_api.py --api staff_user_info --staff_id 子账号ID
# 获取商家所有子账号的列表：
python3 scripts/call_api.py --api sub_accounts --current_page 1 --page_size 10
# 查询官方账号
python3 scripts/call_api.py --api query_official_account
# 获取商家交易的实时汇总信息：
python3 scripts/call_api.py --api merchant_realtime_metric
# 获取商家经营退款数据汇总：
python3 scripts/call_api.py --api merchant_refund_metric
# 查询经营数据
python3 scripts/query_report.py --begin-date 20260316 --end-date 20260322 --channel [1,2] --format markdown

# 查看某个门店下的所有商品：
python3 scripts/product_api.py --api item_sku_list --poi_id 门店ID --page_size 10 分页大小 --page_num 1 页码从1开始

# 查询商品关联的门店列表：
python3 scripts/product_api.py --api item_poi --item_id 商品ID --page_size 10 分页大小 --page_num 1 页码从1开始

# 查看您店铺里的所有商品（自动标注状态：✅ 已上架 | ⚠️ 已下架 | ❌ 已删除）
python3 scripts/product_api.py --api item_list --cursor 0 --size 20

💡 小贴士：输出会自动标注商品状态和价格（元），方便快速筛选。详细示例见 examples/product_api_examples.md

错误处理

status	说明
0	成功
其他	失败，查看 message 字段

欢迎语

安装成功后用礼貌、简洁的语言给用户介绍一下我们的功能，仅在安装成功后总结发送一次

额外信息参考

比如状态&枚举定义等参考：references/api-reference.md

许可

MIT License

安全使用建议

This package appears to be a straightforward client for Kuaishou merchant APIs. Before installing or running it: - Confirm you trust the source (homepage and owner) and that those domains (open.kwailocallife.com, lbs-open.kuaishou.com) are legitimate for your organization. - Understand credential handling: the skill accepts either an ACCESS_TOKEN environment variable or app_key#merchant_id#app_secret stored via the provided api_key_manager; both approaches will result in tokens being cached to ./ .kuaishou-localife-token/. If you prefer not to persist secrets to disk, avoid using the api_key manager and provide only a short-lived token at runtime. - Protect the local token directory (set appropriate filesystem permissions) since it contains credentials. - Review the scripts yourself (they are included) if you have stricter security requirements — network calls are limited to Kuaishou domains only. - If you are unsure about the declared env var name (KWAI_ACCESS_TOKEN vs ACCESS_TOKEN), test the flow in a safe environment: either set the env token or add/select an app_key context via scripts/api_key_manager.py. Overall the skill is internally coherent for its described function; the main caution is to manage and protect the access token/app secret material appropriately.

功能分析

Type: OpenClaw Skill Name: kuaishou-lifeservice-business-assistant Version: 1.0.0 The skill bundle is a merchant assistant for the Kuaishou Life Service platform, designed to help users manage products, stores, and business metrics. It includes scripts for local credential management (api_key_manager.py), OAuth token retrieval (get_access_token.py), and various API clients (call_api.py, product_api.py, query_report.py) that interact with official Kuaishou domains like lbs-open.kuaishou.com and open.kwailocallife.com. While the skill handles sensitive credentials (app_key, merchant_id, app_secret), it stores them locally in a hidden directory (./.kuaishou-localife-token/) and shows no signs of data exfiltration, malicious execution, or harmful prompt injection.

能力评估

✓ Purpose & Capability

Name/description describe a Kuaishou merchant assistant and the code + docs implement many merchant-related API calls against Kuaishou domains (open.kwailocallife.com, lbs-open.kuaishou.com). Required binary (python3) and the single credential (an access token) are appropriate for this purpose.

✓ Instruction Scope

SKILL.md and scripts instruct adding API credentials, running local Python scripts, and calling Kuaishou APIs. The instructions only reference local storage under ./.kuaishou-localife-token and Kuaishou endpoints; they do not instruct reading unrelated system files or sending data to non-Kuaishou endpoints.

✓ Install Mechanism

This is instruction+script based with no install spec — no external downloads or package installs are performed by the skill bundle itself. All network calls in code point to Kuaishou domains. No high-risk URL downloads or archive extraction present.

ℹ Credentials

The skill declares a single primary environment credential (KWAI_ACCESS_TOKEN), which is proportionate. There is a minor inconsistency: the codebase primarily supports app_key#merchant_id#app_secret managed via local files and has a get_access_token flow that fetches/caches tokens; other docs mention exporting ACCESS_TOKEN. The dual modes are reasonable but the declared required env var name may not be strictly necessary if the api_key manager is used.

✓ Persistence & Privilege

The skill writes token and account context files under a local directory (./.kuaishou-localife-token/) — this is expected for caching credentials. always is false and the skill does not request system-wide privileges or modify other skills. Local persistence and file I/O are limited to its own token directory.

版本历史

v1.0.0

Initial release of kuaishou-lifeservice-merchant (快手生活服务-商家经营助手). - Provides merchants with the ability to query products, merchant stores, staff, official accounts, sub-accounts, and business operation data. - Includes account configuration and switching support for multiple merchants. - Offers a set of scripts for querying brand qualifications, staff info, transaction data, evaluations, incentives, contracts, products, and more. - Features clear error handling and usage examples for all major merchant management functions. - Supports fast authorization and onboarding for developers and merchants via the Kuaishou Open Platform.

元数据

Slug kuaishou-lifeservice

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

kuaishou-lifeservice-business-assistant 是什么？

快手生活服务-商家经营助手,为商家提供查询商品、查询商家门店、查询商家职人、查询商家官方账号、查询商家子账号、查询商家的经营数据等能力;. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 221 次。

如何安装 kuaishou-lifeservice-business-assistant？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install kuaishou-lifeservice」即可一键安装，无需额外配置。

kuaishou-lifeservice-business-assistant 是免费的吗？

是的，kuaishou-lifeservice-business-assistant 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

kuaishou-lifeservice-business-assistant 支持哪些平台？

kuaishou-lifeservice-business-assistant 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 kuaishou-lifeservice-business-assistant？

由 kuaishou-lifeservice（@qingfeng9924）开发并维护，当前版本 v1.0.0。

kuaishou-lifeservice-business-assistant