SuperAPI AI 工具集

ecommerce-ebay-search

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:该技能用于检索 eBay 前台商品刊登数据,帮助电商卖家与买家查找商品、比较价格以及分析 eBay 全球各站点的市场情况。支持基于关键词的搜索,并提供价格区间、商品成色、购买方式、排序方式、卖家所在地等筛选条件。

主要能力:结果包含标题、价格、运费信息、卖家评分、销量和商品成色等详情。ebayDomain 参数决定搜索哪个区域 eBay 站点,默认 ebay.com(美国);当用户提到某个国家或地区时可映射到对应域名,如英国对应 ebay.co.uk、德国对应 ebay.de。购买方式包括 Auction(竞拍)、BIN(一口价)和 BO(可议价)。

必要用法:API 端点为 POST /ebay/search,完整参数、响应与错误码见 references/api.md。脚本调用方式为 python scripts/ebay_search.py '<JSON params>' [--inline]。示例参数:{"keyword": "wireless earbuds"};按站点与价格筛选:{"keyword": "laptop", "ebayDomain": "ebay.co.uk", "priceMin": 500, "priceMax": 1000, "itemCondition": "1000"};查找已售出刊登:{"keyword": "iPhone 15 Pro", "showOnly": "Sold,Complete", "orderBy": "10"}。脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-ebay-search-<timestamp>.json;响应体不超过 8 KB 时在写盘后向 stdout 打印完整 JSON,超过 8 KB 时仅输出摘要,加 --inline 可强制完整输出到 stdout。认证需设置 NEXSCOPE_API_KEY 环境变量。

适用场景:eBay 商品搜索、已售出刊登价格研究、最低价比较、竞拍刊登搜索、按地区浏览市场、按成色与价格筛选、二手或翻新商品查找。不适用于 eBay 卖家账户管理或店铺分析、刊登创建与编辑、订单跟踪与购买历史、跨平台比价(eBay 与 Amazon 等)以及 eBay 广告或推广刊登管理。

限制:仅返回当前在线刊登,不提供历史定价趋势;每页最多 200 条结果;请求过多可能被限流,应谨慎使用 noCache: true;价格以所搜索 eBay 站点的当地货币返回。该工具消耗额度(15 credits),默认同一参数组合每个会话只调用一次,脚本有 24 小时本地缓存;失败或结果为空时不要自动更换关键词、页码或邮编重试,如需进一步检索应先向用户说明额外成本。