用途：在 eBay 各国际站点搜索和浏览商品 listing，帮助卖家与买家查找商品、对比价格、分析市场行情。
主要能力：支持关键词搜索，并可组合价格区间（priceMin/priceMax）、商品成色（itemCondition）、购买方式（Auction 拍卖、BIN 一口价、BO 议价）、排序（orderBy）、卖家所在地（location）、首选地区范围（prefLoc）、邮编、分类 ID、分页（page/pageSize，每页 25/50/100/200）等筛选。结果含标题、价格、运费、卖家评分、已售数量、成色等。ebayDomain 控制站点，默认 ebay.com，支持英国、德国、法国、意大利、西班牙、加拿大、澳大利亚、荷兰、奥地利、瑞士、波兰、爱尔兰、香港、马来西亚、新加坡等域名。showOnly 可筛选已售（Sold）、已完成（Complete）、免运费（FS）、免费退货（FR）等。
使用方式：API 端点 POST /ebay/search；也可用 Python 脚本 python scripts/ebay_search.py '<JSON 参数>' [--inline]。脚本默认将完整响应写入 <cwd>/linkfox/<日期>/<session>/data/ 下的 JSON 文件，响应体超过 8 KB 时 stdout 只输出摘要，加 --inline 可强制全量打印。建议先用摘要判断，再用 jq 或 ConvertFrom-Json 按需抽取字段。
限制：仅返回当前在线 listing，不含历史价格趋势；每页最多 200 条；请求过多可能被限流，noCache 慎用；价格以所查站点当地货币返回。本工具消耗 15 算力，用户需为算力付费，高频调用前应提醒用户。未配置 API Key 或遇 401/402、余额不足时，按 references/onboarding.md 处理。不适用于卖家账户管理、listing 创建编辑、订单跟踪、跨平台比价或广告管理。