Claude Code skill

1
# ListBee
2
3
Use the ListBee API to create and manage digital product listings.
4
5
## When to use
6
7
Use this skill when the user:
8
- Asks to sell something, create a product, or monetize content
9
- Wants to create a listing, set a price, or share a buy link
10
- Asks about orders, buyers, or payment status
11
- Wants to update or delete an existing listing
12
13
## Auth
14
15
All requests use:
16
```
17
Authorization: Bearer $LISTBEE_API_KEY
18
```
19
20
Get the key from `LISTBEE_API_KEY` in the environment.
21
22
## Base URL
23
24
`https://api.listbee.so`
25
26
## Core operations
27
28
### Create a listing
29
30
```python
31
import httpx, os
32
33
resp = httpx.post(
34
    "https://api.listbee.so/v1/listings",
35
    headers={"Authorization": f"Bearer {os.environ['LISTBEE_API_KEY']}"},
36
    json={
37
        "name": "<product name>",
38
        "price": <price in cents>,
39
        "deliverable": "<URL or text payload>",
40
    },
41
)
42
listing = resp.json()
43
print(listing["url"])  # share this with buyers
44
```
45
46
### List listings
47
48
```python
49
resp = httpx.get(
50
    "https://api.listbee.so/v1/listings",
51
    headers={"Authorization": f"Bearer {os.environ['LISTBEE_API_KEY']}"},
52
)
53
listings = resp.json()["data"]
54
```
55
56
### Get a listing
57
58
```python
59
resp = httpx.get(
60
    "https://api.listbee.so/v1/listings/{slug}",
61
    headers={"Authorization": f"Bearer {os.environ['LISTBEE_API_KEY']}"},
62
)
63
listing = resp.json()
64
```
65
66
### Update a listing
67
68
```python
69
resp = httpx.put(
70
    "https://api.listbee.so/v1/listings/{slug}",
71
    headers={"Authorization": f"Bearer {os.environ['LISTBEE_API_KEY']}"},
72
    json={"price": 2900},  # any fields to update
73
)
74
```
75
76
### Delete a listing
77
78
```python
79
httpx.delete(
80
    "https://api.listbee.so/v1/listings/{slug}",
81
    headers={"Authorization": f"Bearer {os.environ['LISTBEE_API_KEY']}"},
82
)
83
```
84
85
### List orders
86
87
```python
88
resp = httpx.get(
89
    "https://api.listbee.so/v1/orders",
90
    headers={"Authorization": f"Bearer {os.environ['LISTBEE_API_KEY']}"},
91
)
92
orders = resp.json()["data"]
93
```
94
95
## Readiness
96
97
Every listing response includes `readiness`:
98
- `readiness.sellable: true` → buyers can purchase now
99
- `readiness.sellable: false` → check `readiness.actions` for what's blocking
100
- `readiness.next` → code of the highest-priority action
101
102
If `sellable` is false, surface `readiness.actions[0].message` to the user.
103
104
## Errors
105
106
Errors use RFC 9457 format:
107
```json
108
{ "type": "...", "title": "...", "status": 422, "detail": "...", "code": "...", "param": "..." }
109
```
110
111
Common status codes: 401 (invalid key), 404 (not found), 422 (validation error), 429 (rate limit).
112
113
## Key facts
114
115
- Price is always in cents: $19.00 = `1900`
116
- Listings are looked up by `slug`, not `id`
117
- `deliverable` can be a URL (file delivered to buyer) or raw text
118
- `listing.url` is the product page — share it with buyers
119
- ID prefixes: `lst_` listing, `ord_` order, `acc_` account