wallapop-mcp 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -54,6 +54,29 @@ not present on every raw item), `createdAt`.
|
|
|
54
54
|
Free-text search over Wallapop's category tree (`query`, optional). With no query, returns the
|
|
55
55
|
18 top-level categories.
|
|
56
56
|
|
|
57
|
+
## Use cases
|
|
58
|
+
|
|
59
|
+
Example prompts to an LLM client once `wallapop-mcp` is connected:
|
|
60
|
+
|
|
61
|
+
- **Simple search** — "Find iPhone 11s for sale on Wallapop under €80"
|
|
62
|
+
→ `search({ keywords: "iphone 11", maxPrice: 80 })`
|
|
63
|
+
- **Location-aware search** — "What secondhand bikes are listed near Barcelona right now?"
|
|
64
|
+
→ `search({ keywords: "bicicleta" })` (defaults to Barcelona-center when no location is given)
|
|
65
|
+
- **Category-scoped shopping** — "Show me what categories exist under Technology & electronics,
|
|
66
|
+
then find cheap laptops in that category"
|
|
67
|
+
→ `list_categories({ query: "electronics" })` → `search({ keywords: "laptop", categoryId: <id> })`
|
|
68
|
+
- **Price-range research** — "What's the typical asking price for a PS5 on Wallapop? Show me 20
|
|
69
|
+
listings sorted by price"
|
|
70
|
+
→ `search({ keywords: "ps5", maxResults: 20, orderBy: "price_low_to_high" })`
|
|
71
|
+
- **Pagination / "show me more"** — "Show me the next page of those results"
|
|
72
|
+
→ `search({ keywords: "ps5", nextPage: "<cursor from previous response>" })`
|
|
73
|
+
- **Browsing the taxonomy** — "What are Wallapop's top-level categories?"
|
|
74
|
+
→ `list_categories({})`
|
|
75
|
+
|
|
76
|
+
**Known limitation:** `Listing.condition` is usually `undefined` — Wallapop's search API doesn't
|
|
77
|
+
reliably expose item condition (see `docs/STATE.md`'s open questions) — so "find only *new*
|
|
78
|
+
items" isn't reliably answerable from `search` alone today.
|
|
79
|
+
|
|
57
80
|
## Development
|
|
58
81
|
|
|
59
82
|
```bash
|