xianyu-automation-skill

SKILL.md

---
name: xianyu-automation
description: Enterprise-grade automated operations for Xianyu stores with full lifecycle management, confirmation safeguards, and intelligent decision engine.
version: 1.0.2
author: AI造物的大铁锤
metadata:
  openclaw:
    requires:
      env:
        - XIAN_YU_APP_KEY
        - XIAN_YU_APP_SECRET
      bins:
        - python
    primaryEnv: XIAN_YU_APP_KEY
    homepage: https://www.goofish.pro
    source: https://clawhub.com/skills/xianyu-automation
---
# 闲鱼自动化运营技能

## 技能概述

这是一个企业级的闲鱼店铺自动化运营技能，为您提供从商品创建到订单完成的全生命周期智能管理。本技能基于完整的闲鱼管家API体系，实现了真正的"无人值守"运营模式，让您能够专注于核心业务开发，而将日常运营工作完全交给自动化系统处理。

## 核心价值

- **全生命周期管理**：覆盖商品创建、上架、监控、优化、下架的完整流程
- **智能决策引擎**：基于实时数据自动调整运营策略，最大化收益
- **风险预警系统**：提前识别潜在问题，避免违规和损失
- **效率革命**：减少90%以上的人工维护工作，实现真正的自动化运营

## 使用前准备

### 必需依赖

- **xianyu-api-client-skill**：基础API通信能力
- **xianyu-product-manager-skill**：商品模板和批量管理能力
- **有效的闲鱼管家开发者账号**：包含完整的API权限

### 运营策略配置

在启用自动化功能前，您需要明确以下运营策略：

#### 1. 商品管理策略

- **商品刷新频率**：建议每3-5天刷新一次商品活跃度
- **库存管理规则**：设置库存预警阈值和自动调整规则
- **价格调整范围**：定义价格浮动的上下限（建议±15%）

#### 2. 订单处理策略

- **自动发货规则**：哪些类型的商品可以自动发货
- **价格修改权限**：是否允许系统自动调整订单价格
- **异常订单处理**：定义需要人工介入的订单类型

#### 3. 监控告警策略

- **关键指标阈值**：浏览量、咨询量、成交率的预警线
- **通知方式**：选择微信、邮件或其他通知渠道
- **响应时间要求**：定义不同级别告警的响应时限

## 功能特性

### 智能商品生命周期管理

- **自动创建**：根据预设模板定期创建新商品
- **活跃度维护**：自动编辑商品信息保持算法推荐权重
- **智能上下架**：根据销售表现和库存情况自动上下架
- **过期清理**：自动删除长期无效果的商品

### 订单自动化处理

- **实时监控**：7x24小时监控新订单状态
- **自动发货**：虚拟商品自动发货（支持卡密系统）
- **智能定价**：根据市场情况和库存自动调整商品价格
- **异常处理**：识别并标记需要人工处理的异常订单

### 数据驱动优化

- **性能分析**：实时分析商品表现数据
- **A/B测试自动化**：自动运行和评估A/B测试结果
- **竞争情报**：监控竞争对手价格和策略变化
- **预测分析**：基于历史数据预测最佳运营策略

### 推送通知处理

- **商品状态回调**：实时处理商品审核、上下架等状态变化
- **订单状态回调**：自动响应订单创建、付款、发货等事件
- **智能响应**：根据推送事件自动执行相应的业务逻辑
- **日志记录**：完整记录所有推送事件和处理结果

## 用户交互流程

### 初始配置向导

首次使用时，系统会引导您完成完整的配置流程：

#### 第一步：运营目标设定

```
请选择您的主要运营目标：
1. 最大化收入（优先高价值商品）
2. 最大化销量（优先高转化商品）  
3. 平衡发展（收入和销量兼顾）
4. 品牌建设（优先高质量服务）

请输入选项 [1-4]:
```

#### 第二步：自动化程度选择

```
请选择自动化程度：
1. 半自动（关键操作需要确认）
2. 全自动（除异常情况外无需人工干预）
3. 自定义（逐项配置每个功能的自动化级别）

请输入选项 [1-3]:
```

#### 第三步：风险控制配置

```
请设置风险控制参数：
- 最大单次操作商品数量：_____
- 价格调整最大幅度：_____%  
- 库存预警阈值：_____
- 异常订单处理方式：[自动暂停/标记待处理/继续执行]

按回车使用默认值，或输入自定义值：
```

#### 第四步：通知偏好设置

```
请选择通知方式：
□ 微信通知（需要配置微信机器人）
□ 邮件通知（需要配置SMTP）
□ 系统日志（仅记录到本地日志文件）
□ 无通知（完全静默运行）

可多选，请输入数字组合（如：1,2）:
```

### 日常运营确认

即使在全自动模式下，系统也会在关键节点请求确认：

#### 重大操作确认

```
检测到以下重大操作：
- 批量下架5个商品（总价值¥3495）
- 调整3个商品价格（平均上调12%）

这可能影响您的店铺表现，是否确认执行？
[Y] 确认执行  [N] 取消操作  [S] 查看详细影响分析
```

#### 异常情况处理

```
发现异常情况：
- 商品"AI客服Agent-标准版"连续7天无浏览量
- 竞争对手同类商品降价20%

建议操作：
1. 自动优化商品标题和描述
2. 调整价格至¥599（降幅14%）
3. 暂停该商品并创建新版本

请选择处理方案 [1/2/3] 或 [M] 手动处理:
```

### 交互控制选项

- **紧急停止**：任何时候输入"STOP"即可暂停所有自动化操作
- **手动覆盖**：可以临时切换到手动模式处理特定任务
- **计划调整**：可以随时修改自动化计划和参数

## 最佳实践建议

### 渐进式部署

- **第一周**：启用半自动模式，熟悉系统行为
- **第二周**：逐步增加自动化功能，监控效果
- **第三周**：切换到全自动模式，享受高效运营

### 数据监控

- **每日检查**：查看自动化操作日志和效果报告
- **每周优化**：根据数据调整运营策略和参数
- **每月复盘**：全面评估自动化效果，制定改进计划

### 风险管理

- **备份策略**：定期备份重要商品数据和配置
- **应急预案**：制定自动化故障的应急处理流程
- **合规审查**：定期检查自动化操作是否符合平台规则

## Security Model

This skill provides automation on top of `xianyu-api-client-skill` and `xianyu-product-manager-skill`. It inherits all security controls from both layers (endpoint allowlist, write confirmation, dry-run, batch limits, credential isolation). The following additional safeguards are enforced.

### Automation Safety Limits (Code-Enforced)

- **Daily product creation cap**: `MAX_DAILY_PRODUCTS = 20` — the skill tracks a `_daily_count` counter and rejects creation requests beyond this limit.
- **Batch refresh cap**: `MAX_BATCH_REFRESH = 100` — prevents runaway refresh operations.
- **Price adjustment range**: Configurable (default ±10%), prevents extreme price changes.

### Write Operation Confirmation

By default, all product mutations flow through the safe `client.create_product()` / `client.delete_product()` / `client.modify_order_price()` path, which requires interactive user confirmation. Automation workflows that need to skip confirmation must explicitly use the `_unsafe` variants.

### Unsafe Methods (Tightly Controlled Automation)

This skill is designed for automation, but `_unsafe` methods should only be used when:

1. The automation workflow has been tested end-to-end with `dry_run=True`
2. A dedicated low-permission Xianyu application key is used (not the main account)
3. Safety limits (`MAX_DAILY_PRODUCTS`, `MAX_BATCH_REFRESH`) remain enforced
4. Operation logs are monitored for anomalies

### Credential Security

This skill does not handle credentials directly. All credential management is delegated to `xianyu-api-client-skill`. Best practices:

- **Use a dedicated low-permission Xianyu application key** for automation
- **Store secrets in environment variables or a secret manager**
- **Rotate credentials every 3-6 months**
- **Do not share credentials with unrelated skills or agents**
- **Revoke immediately** if the skill is uninstalled or no longer trusted

## 依赖关系

- **必需依赖**：
  - xianyu-api-client-skill（v1.0.4+）
  - xianyu-product-manager-skill（v1.1.1+）
- **可选依赖**：
  - 通知服务（微信/邮件等）

## 版本信息

- **当前版本**：1.0.2
- **兼容性**：闲鱼管家开放平台 v1
- **Python版本**：3.7+

## 开始使用

完成初始配置后，您就可以享受真正的自动化闲鱼店铺运营体验。系统会按照您的策略自动执行所有日常操作，同时在关键时刻请求您的确认，确保安全性和可控性。