@reffo/skill-reverse-auction

Reverse auction skill for the Reffo peer-to-peer marketplace. Buyers post what they want with a budget, sellers compete to win.

Install

npm install @reffo/skill-reverse-auction

The beacon auto-discovers and loads the skill on startup.

How It Works

Buyer Flow

1. Post a want — describe what you're looking for + max budget
2. Want broadcasts to the P2P network via DHT
3. Sellers see the want and send competitive bids
4. Review bids, accept the best one
5. Mark as sold to complete the transaction

Seller Flow

1. Browse active wants from buyers on the network
2. Send a bid with your price and item details
3. Wait for buyer response — accepted, rejected, or countered
4. If accepted, complete the sale

API

All routes mounted at /skills/reverse-auction/:

Wants

• GET /wants — list wants (filter: status, category)
• GET /wants/:id — get a want
• POST /wants — create a want
• PATCH /wants/:id — update a want
• DELETE /wants/:id — cancel a want

Bids

• GET /bids — list bids (filter: role, wantId)
• GET /bids/:id — get a bid
• POST /bids — send a bid
• PATCH /bids/:id/respond — accept/reject/counter
• PATCH /bids/:id/withdraw — withdraw a bid
• PATCH /bids/:id/mark-sold — mark as sold

MCP Tools

12 tools for AI agent integration: create_want, list_wants, get_want, update_want, cancel_want, search_wants, send_bid, list_bids, get_bid, respond_to_bid, withdraw_bid, mark_bid_sold

MCP Prompts

• post-a-want — guided buyer workflow
• fulfill-a-want — guided seller workflow

Cross-Platform

Distribution artifacts in dist/:

• SKILL.md — ClawHub / LobeHub
• openapi.json — OpenAI GPT Store Actions
• claude-plugin.json — Anthropic Claude Marketplace

License

AGPL-3.0-only