# Broker Card

> Listing card preview and auto-publish for C2C platforms. Generates platform-adapted listing cards for user review, then auto-publishes on confirmation. Also handles setting the repricing schedule and price shield before publishing. Use when user is ready to list an item after price research. Trigger: "publish", "list it", "上架", "确认发布".

- **Type:** Skill
- **Install:** `agentstack add skill-madguyevans-creator-resale-agent-skill-hub-broker-card`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [madguyevans-creator](https://agentstack.voostack.com/s/madguyevans-creator)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [madguyevans-creator](https://github.com/madguyevans-creator)
- **Source:** https://github.com/madguyevans-creator/resale-agent-skill-hub/tree/main/skills/broker-card

## Install

```sh
agentstack add skill-madguyevans-creator-resale-agent-skill-hub-broker-card
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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  --action generate  # Generate cards
python3 scripts/publish.py --item-id  --action publish   # Publish all
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [madguyevans-creator](https://github.com/madguyevans-creator)
- **Source:** [madguyevans-creator/resale-agent-skill-hub](https://github.com/madguyevans-creator/resale-agent-skill-hub)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-madguyevans-creator-resale-agent-skill-hub-broker-card
- Seller: https://agentstack.voostack.com/s/madguyevans-creator
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
