resale-agent-skill-hub
AI-powered multi-platform C2C resale toolkit — 8 Claude Code skills + MCP server for automating second-hand selling
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/madguyevans-creator--resale-agent-skill-hub)HTML
<a href="/listings/madguyevans-creator--resale-agent-skill-hub"><img src="/api/listings/madguyevans-creator--resale-agent-skill-hub/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Pick one path. Path A is recommended for most users.
Path A: Claude Desktop (recommended, 5 minutes)
**Step 1: Install**
git clone https://github.com/madguyevans-creator/skillhub.git cd skillhub && pip install -e . pip install playwright && playwright install chromium
**Step 2: Get API key (one-time)** Go to [console.anthropic.com](https://console.anthropic.com) → API Keys → create key. Save it once:
echo 'sk-ant-your-key' > ~/.broker/api_key
**Step 3: Configure Claude Desktop** Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
{
"mcpServers": {
"skillhub": {
"command": "python3",
"args": ["/path/to/skillhub/broker_core/mcp_server.py"],
"env": { "BROKER_MOCK_MODE": "true" }
}
}
}**Step 4: Restart Claude Desktop.** Done.
Open Claude Desktop, say "帮我卖掉这双鞋" + upload photo. Claude automatically calls 7 MCP tools in the correct order.
Path B: Claude Code CLI
git clone https://github.com/madguyevans-creator/skillhub.git cd skillhub && pip install -e . cp -r skills/* ~/.claude/skills/
Use inside Claude Code: - `/personal-broker` — full pipeline - `/broker-recognize` — analyze product photo - `/broker-price` — price research - `/broker-fuse` — set floor price
Path C: Demo without any accounts (mock mode)
By default `BROKER_MOCK_MODE=true`. Everything works with realistic simulated data — no API key, no platform accounts needed. Photo recognition returns a demo Nike sneaker.
git clone https://github.com/madguyevans-creator/skillhub.git cd skillhub && pip install -e . # Done — you're in mock mode. Use Path A or B above.
Going real: turn off mock mode
export BROKER_MOCK_MODE=false # Then bind platform accounts: python3 skills/broker-auth/scripts/auth.py --all # This opens a browser. Log into each platform once. Cookies persist.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 182 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # SkillHub — Smart Resale Agent
- A collection of 8 Claude Code skills + an **MCP Server** implementing a **Multi-Platform Smart Resale Agent**: an AI-powered conversational workflow for C2C second-hand resale that reduces the barriers to listing and selling pre-owned goods.
- **v2**: Now runs as a standard MCP server (JSON-RPC over stdio) that any MCP-compatible client can call — Claude Desktop, Cursor, VS Code, or custom web frontends.
- ## Architecture
- ```
- skillhub/
- ├── broker_core/ # Shared engine (pip install -e .)
- │ ├── session_manager.py # Browser login → cookie persistence
- │ ├── platform_client.py # Authenticated platform API clients
- │ ├── state_manager.py # Listing lifecycle state (~/.broker/listings.json)
- │ ├── scheduler.py # launchd (macOS) / cron (Linux) registration
- │ ├── audit_logger.py # Append-only Transparency Log (~/.broker/audit.jsonl)
- │ └── mcp_server.py # ★ MCP Server — 7 tools via JSON-RPC
- ├── guardrails/ # ★ Prompt framework (v2)
- │ ├── Omni-Agent-Guardrails.yaml
- │ └── README.md
- ├── skills/ # 8 Claude Code skills
- │ ├── personal-broker/ # Hub: orchestrates the 7-step pipeline
- │ ├── broker-recognize/ # Step 1: Photo → product info
- │ ├── broker-auth/ # Step 3: Bind platform accounts
- │ ├── broker-price/ # Step 2: Authenticated price research
- │ ├── broker-card/ # Step 4: Listing cards → auto-publish
- │ ├── broker-schedule/ # Step 5: Repricing interval & cron/launchd
- │ ├── broker-fuse/ # Step 6: Price Shield (floor price)
- │ └── broker-delist/ # Step 7: Auto-detect sale → delist all
- ├── tests/ # 41 tests
- └── docs/ # Setup guides for MCP clients
- ```
- ## The 7-Step Pipeline
- ```
- 📷 broker-recognize → Photo → structured product info
- 🔐 broker-auth → Open browser → log in once → session persisted
- 🔍 broker-price → Search platforms with session → transparency report
- 🛡️ broker-fuse → ⚠️ GLOBAL INTERCEPTOR — set unbreachable floor price BEFORE publishing
- 📋 broker-card → Generate cards → validate floor → user confirms → auto-publish
- ⏰ broker-schedule → Register launchd/cron for daily repricing checks (floor-gated)
- ✅ broker-delist → Scheduler detects sale → auto-delist all platforms (no confirmation)
- ```
- Each skill can also be invoked standalone (e.g., `/broker-price` for pricing only).
- ## Prerequisites
- ### ANTHROPIC_API_KEY (required)
- `broker-recognize` uses the **Anthropic API** (Claude Vision) to analyze product photos. Set your API key:
- ```bash
- export ANTHROPIC_API_KEY="sk-ant-..."
- ```
- Without this key, photo recognition will fail.
- ### Python 3.9+
- ### Playwright (for platform auth)
- ## Quick Start
- Pick one path. Path A is recommended for most users.
- ### Path A: Claude Desktop (recommended, 5 minutes)
- **Step 1: Install**
- ```bash
- git clone https://github.com/madguyevans-creator/skillhub.git
- cd skillhub && pip install -e .
- pip install playwright && playwright install chromium
- ```
- **Step 2: Get API key (one-time)**
- Go to [console.anthropic.com](https://console.anthropic.com) → API Keys → create key.
- Save it once:
- ```bash
- echo 'sk-ant-your-key' > ~/.broker/api_key
- ```
- **Step 3: Configure Claude Desktop**
- Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
- ```json
- {
- "mcpServers": {
- "skillhub": {
- "command": "python3",
- "args": ["/path/to/skillhub/broker_core/mcp_server.py"],
- "env": { "BROKER_MOCK_MODE": "true" }
- }
- }
- }
- ```
- **Step 4: Restart Claude Desktop.** Done.
- Open Claude Desktop, say "帮我卖掉这双鞋" + upload photo. Claude automatically calls 7 MCP tools in the correct order.
- ### Path B: Claude Code CLI
- ```bash
- git clone https://github.com/madguyevans-creator/skillhub.git
- cd skillhub && pip install -e .
- cp -r skills/* ~/.claude/skills/
- ```
- Use inside Claude Code:
- - `/personal-broker` — full pipeline
- - `/broker-recognize` — analyze product photo
- - `/broker-price` — price research
- - `/broker-fuse` — set floor price
- ### Path C: Demo without any accounts (mock mode)
- By default `BROKER_MOCK_MODE=true`. Everything works with realistic simulated data — no API key, no platform accounts needed. Photo recognition returns a demo Nike sneaker.
- ```bash
- git clone https://github.com/madguyevans-creator/skillhub.git
- cd skillhub && pip install -e .
- # Done — you're in mock mode. Use Path A or B above.
- ```
- ### Going real: turn off mock mode
- ```bash
- export BROKER_MOCK_MODE=false
- # Then bind platform accounts:
- python3 skills/broker-auth/scripts/auth.py --all
- # This opens a browser. Log into each platform once. Cookies persist.
- ```
- ## Sandbox / Mock Mode
- By default, `BROKER_MOCK_MODE=true` — all platform API calls (search, publish, delist) return realistic simulated data. No real HTTP requests are made. This allows:
- - **Demo without platform accounts**: test the full pipeline with mock data
- - **Safe development**: no risk of accidentally publishing or modifying real listings
- - **Anti-scraping avoidance**: no requests that could trigger rate limits or CAPTCHAs
- To use real platform APIs, set `BROKER_MOCK_MODE=false` in your environment. Requires platform accounts bound via `broker-auth`.
- ## Transparency Log
- Every AI-assisted decision is recorded to `~/.broker/audit.jsonl` — an append-only, immutable JSONL file. You can always audit what the agent did and why.
- **What gets logged:**
- - Price research results (`log_pricing`)
- - Price shield checks — blocked or passed (`log_fuse_check`)
- - Listing publishes (`log_publish`)
- - Auto-repricing events (`log_repricing`)
- - Delist events (`log_delist`)
- - Schedule registrations (`log_schedule_registered`)
- **How to view:**
- ```python
- from broker_core import audit_logger
- print(audit_logger.format_trail("item_abc123")) # Human-readable timeline
- trail = audit_logger.get_audit_trail("item_abc123") # Raw JSON array
- ```
- When every action is recorded with rationale, there is no "black box" — the user can always audit what happened and why.
- ## Key Design Decisions
- | Decision | Rationale |
- |----------|-----------|
- | **Not web scraping** | Uses user's own session cookies. Searching as a logged-in user, not crawling. |
- | **Bind once, reuse** | Platform login happens once via browser. Session persisted until expiry (~30 days). |
- | **Sold median pricing** | Recommended price = median of actually-sold comparables. Falls back to 5% below active median. |
- | **Price shield as global interceptor** | Every price-mutating action (publish, repricing) validates against the floor. Blocked actions are logged to audit trail. |
- | **Auto-execute after confirm** | Once user confirms card + floor + schedule, the system auto-publishes and auto-reprices without re-confirmation. |
- | **No confirmation on delist** | When scheduler detects sale on any platform, auto-delist all others immediately. |
- | **launchd / cron** | System-level scheduling, no daemon process needed. |
- | **Mock mode** | `BROKER_MOCK_MODE=true` by default — safe demo without real accounts or anti-scraping risk. |
- | **Append-only Transparency Log** | Immutable JSONL log of every decision. The user can always audit what happened. |
- ## License
- MIT — see [LICENSE](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.