wallapop-cli

wallapop-cli 是一款专注于 Wallapop 二手交易平台数据查询的 CLI 工具使用文档型 Skill。该 Skill 并非直接执行代码，而是为用户提供完整的命令行操作指南，帮助开发者通过终端高效检索二手商品信息、查看商品详情、获取用户资料以及浏览平台分类体系。

核心用法涵盖四大功能模块：商品搜索支持通过关键词、地理位置坐标（经纬度）、价格区间、商品分类 ID 及结果数量限制进行精细化筛选；商品详情查询可通过商品 ID 获取完整信息包括描述、分类、图片及卖家信息；用户资料查看功能支持获取特定用户的公开档案数据；分类列表功能则提供平台商品类目的结构化数据。所有命令均支持 --json 全局参数，便于将输出集成到自动化脚本或数据处理流程中。

显著优点体现在其纯文档属性带来的极高安全性——Skill 本身仅包含 Markdown 文档，无可执行代码、无数据收集逻辑、无网络通信行为，所有操作均需用户主动安装并执行第三方 CLI 工具完成，实现了责任边界清晰的安全隔离。命令设计遵循标准 CLI 惯例，参数命名直观，支持环境变量预配置（如默认地理位置），显著降低了重复输入成本。JSON 输出模式的支持使其能无缝接入现代数据流水线，满足开发者程序化获取二手市场数据的需求。

潜在缺点与局限性不容忽视。首先，该 Skill 仅提供使用文档，实际功能完全依赖外部 wallapop-cli 工具，用户需自行通过 npm 安装 Node.js 18+ 环境，增加了前置配置复杂度。其次，部分功能（如非搜索端点）需要配置 WALLAPOP_ACCESS_TOKEN，这意味着用户需自行处理认证流程。再者，作为 T3 来源的个人开发者项目，其长期维护稳定性与官方支持度存在不确定性。功能层面目前仅覆盖基础的查询操作，缺乏深度数据分析或批量处理的高级特性。

适合的目标群体主要包括：需要将 Wallapop 二手市场数据集成到自动化工作流的开发者；进行二手商品价格监测或市场研究的数据分析师；偏好命令行交互方式的技术型用户；以及希望通过脚本批量获取商品信息的运维人员。

使用该技能可能存在的常规风险包括：外部依赖安全性——wallapop-cli 作为第三方 npm 包，其代码质量与安全更新不在本 Skill 控制范围内，建议从官方 npm 仓库安装并验证版本；网络与 API 限制——实际数据请求发送至 api.wallapop.com，可能受限于平台 API 速率限制或网络访问策略；隐私泄露风险——配置地理位置环境变量或访问令牌时，若处理不当可能导致敏感信息泄露；性能瓶颈——大规模数据抓取可能触发平台反爬机制，建议合理设置请求间隔。