AgentSkillsCN

wallapop-cli

使用wallapop CLI搜索列表、获取商品详情、查看用户资料和列出类别。当用户请求Wallapop市场数据，或你需要wallapop-cli的命令和标志时使用。

SKILL.md
--- frontmatter
name: wallapop-cli
description: Use the wallapop CLI to search listings, fetch item details, view user profiles, and list categories. Apply when a user asks for Wallapop marketplace data or when you need CLI commands and flags for wallapop-cli usage.
compatibility: Requires wallapop-cli installed (Node.js 18+), network access to api.wallapop.com, and optional WALLAPOP_ACCESS_TOKEN for non-search endpoints.

Purpose

Provide concise, correct commands for using wallapop-cli.

When to use

  • •User asks how to search Wallapop listings from the terminal.
  • •User needs CLI flags for filtering search (price, location, category, limit).
  • •User needs item or user lookup commands.
  • •User needs JSON output for scripting.

Commands

Search listings

code
wallapop search "<query>" [--lat <lat>] [--lng <lng>] [--min-price <n>] [--max-price <n>] [--category <id>] [--limit <n>]

Notes:

  • •Defaults to configured location if --lat/--lng omitted.
  • •--limit trims results locally.

Item details

code
wallapop item <item_id>

User profile

code
wallapop user <user_id>

Categories

code
wallapop categories

JSON output (all commands)

Add the global flag --json:

code
wallapop --json search "laptop"
wallapop --json item abc123

Configuration

  • •Location defaults can be set via env vars:
    • •WALLAPOP_LAT
    • •WALLAPOP_LNG
  • •Optional auth token for non-search endpoints:
    • •WALLAPOP_ACCESS_TOKEN

Output expectations

  • •Search: table or JSON array of results with id, title, price, distance, and user.
  • •Item: table or JSON with title, description, taxonomy, user, images.
  • •User: table or JSON with profile fields.
  • •Categories: table or JSON list of category ids and names.

Examples (safe placeholders)

code
wallapop search "camera" --min-price 50 --max-price 200
wallapop search "chair" --lat 40.0 --lng -3.0 --limit 5
wallapop item abc123
wallapop user user123
wallapop --json categories

Error handling

  • •Non-zero exit code on failure.
  • •For scripted use, prefer --json and handle errors by checking exit code.