linkfox-ebay-search

在多个 eBay 国际站点搜索和浏览商品,按关键词、价格、成色、购买方式、地区和类目筛选,查看商品价格、运费、卖家评价、已售数量和竞拍信息。适用于 eBay 找品、竞品研究、价格对比、已售商品与拍卖检索;不适用于卖家账号管理、店铺经营分析、刊登编辑、订单追踪、购买历史、广告管理或跨平台比价。

SKILL.md

GitHub

eBay 商品搜索

适用范围

适用

搜索 eBay 前台商品,比较当前刊登、已售或已结束刊登的可用数据。 用户希望找商品、核对价格、查看拍卖或研究特定国家市场时使用,无需明确说出“商品搜索”。

场景速查

用户表达 查询场景
在 eBay 上找无线耳机 关键词商品检索。
这个型号在 eBay 卖多少钱 已售或已结束刊登的价格研究。
找最便宜的全新商品,最好包邮 结合成色、运费和价格排序比较。
看看即将结束的古董手表拍卖 拍卖检索与竞拍信息展示。
看英国或德国站有哪些商品 按目标站点和卖家所在地浏览。
找这个类目的翻新商品或下一页结果 按类目、成色或用户指定页码检索。

前置条件

确认用户的搜索目标和目标国家或地区;将用户表达的站点、价格、成色、购买方式等意图映射为筛选条件,具体定义见 references/api.md。

检索流程

  1. 明确用户需要当前商品、已售价格研究还是拍卖信息,确认站点及必要筛选条件。
  2. 按 references/api.md 准备一次检索,优先复用同一参数组合的已有结果。
  3. 先读取摘要,再从落盘文件提取所需字段,按用户目标比较商品。
  4. 说明结果覆盖范围;失败、空结果或需要更多页时,解释原因和额外消耗,由用户决定是否继续。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python scripts/ebay_search.py '<JSON 参数>' [--inline]。
  • 成本约束:本工具每次调用消耗 15 算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

输出策略

  • 始终保存完整响应,目标路径为 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ebay-search-<timestamp>.json。<cwd> 为脚本运行时的工作目录,<session> 优先取环境变量 SESSION_ID,用于聚合同一任务的数据。禁止写入 /tmp,当前目录不可写时应报错。
  • 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
  • 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 total、costToken)、最大列表字段的长度和前 3 条样本。
  • 添加 --inline 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

执行规则

算力消耗预估

15 算力 / 次

声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

解决认证和算力问题

出现以下情况时,按 references/onboarding.md 的指引处理:

  • 未配置接口密钥:LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY 均为空。
  • 响应状态码为 401 或 402。
  • 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

  • 区分市场与卖家位置:站点决定搜索的区域市场,卖家所在地与配送区域是不同维度;根据用户意图分别理解。
  • 区分购买方式:拍卖通过竞价成交,一口价按固定标价购买,最佳报价支持议价。具体参数见接口定义。
  • 清晰展示商品:用表格展示标题、价格、成色、卖家和运费,附商品链接;有促销、退货信息时按需补充。
  • 标明币种和价格区间:使用响应币种及货币符号展示价格;多规格价格以区间呈现。价格比较同时考虑运费。
  • 突出已售和竞拍数据:研究已售商品时突出成交价格与已售数量;拍卖商品展示当前价格及竞拍数量。
  • 展示卖家信任信息:存在卖家好评率和评价数量时一并展示,供用户判断可靠性。
  • 标记推广商品:明确标注赞助或推广刊登,便于用户识别自然结果与广告。
  • 说明分页范围:总数超过当前页时说明总量、本页范围和可继续查看的页;后续调用遵守成本约束。
  • 解释数据边界和错误:数据时效、已售筛选和使用限制见 references/api.md。查询失败时说明原因并建议调整参数,不自动连续试探。

使用示例

查找商品并比较到手价

用户:在 eBay 美国站找全新的 USB-C 线,优先看含运费最便宜的商品。

结合关键词、成色、免运费偏好和含运费排序检索,展示价格、运费、卖家信息与商品链接。

研究已售价格

用户:看看 iPhone 15 Pro 在 eBay 的已售价格。

按已售及已结束刊登筛选,突出成交价格、币种和已售数量,说明这是搜索页可用数据。

浏览区域市场和拍卖

用户:找德国站本地卖家的耳机;或者看看即将结束的古董手表拍卖。

按用户目标选择站点与卖家所在地,或选择拍卖及即将结束排序;列出商品、成色、卖家或竞拍信息。

使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。


更多优质、专业的跨境电商技能,请访问 LinkFox Skill。