# Broker Card

> broker-card: Generate, Review, and Publish Listings

- Skill: `madguyevans-creator/broker-card` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add madguyevans-creator/broker-card`
- Raw SKILL.md: https://api.skillmd.com/api/skills/madguyevans-creator/broker-card/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: madguyevans-creator (https://skillmd.com/u/madguyevans-creator)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/madguyevans-creator/broker-card

---


# broker-card: Generate, Review, and Publish Listings

Generates platform-specific listing cards, collects schedule+fuse settings, and auto-publishes on user confirmation.

## Workflow

### Phase 1: Card Generation
For each target platform, generate a formatted listing card:

```
┌─────────────────────────────────────┐
│ 🛍️  闲鱼 Xianyu 上架卡片            │
├─────────────────────────────────────┤
│  📝 标题: [platform-optimized]      │
│  📂 分类: [platform category path]  │
│  💰 价格: ¥XXX                      │
│  📋 描述: [platform-tone adapted]   │
│  🏷️  标签: #tag1 #tag2 #tag3       │
│  ⚠️  成色: Grade X — [detail]      │
└─────────────────────────────────────┘
```

### Phase 2: Schedule + Shield (MANDATORY before publishing)
- **Price shield**: Unbreachable floor price. This MUST be set via `broker-fuse` before publishing. The publish script validates: if no floor is set, publishing is blocked.
- **Repricing interval**: How often to re-check prices (default 7 days)

Explain the trade-off: higher floor = more profit per sale but slower; lower floor = faster liquidity.

### Phase 3: Publish (floor-gated)
- Floor validation: script checks `listing.fuse_price > 0` and `listing.current_price >= listing.fuse_price`. Blocked otherwise.
- User says "发布" or "confirm"
- Script auto-publishes to each platform using stored session
- Each publish event is logged to the audit trail (`audit_logger.log_publish`)
- Each listing URL is saved to state manager
- System scheduler is registered for repricing checks

## Platform Adaptations

| Platform | Tone | Title Limit |
|----------|------|-------------|
| 闲鱼 Xianyu | Casual, authentic, community | 30 chars |
| 转转 Zhuanzhuan | Semi-formal, inspection-report | 40 chars |
| eBay | Professional, keyword-dense | 80 chars |
| Depop | Lifestyle, aesthetic | 60 chars |

## Script

```bash
python3 scripts/publish.py --item-id <id> --action generate  # Generate cards
python3 scripts/publish.py --item-id <id> --action publish   # Publish all
```