linkfox-ebay-search
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseeBay Product Search
eBay商品搜索
This skill guides you on how to search and retrieve eBay product listing data, helping e-commerce sellers and buyers find products, compare prices, and analyze market trends across eBay's global marketplaces.
本技能将指导您如何搜索和获取eBay商品listing数据，帮助电商卖家和买家在eBay全球站点中查找商品、对比价格并分析市场趋势。
Core Concepts
核心概念
eBay Product Search provides access to eBay's front-end product listing data. It supports keyword-based search with rich filtering options including price range, item condition, buying format, sort order, seller location, and more. Results include product details such as title, price, shipping info, seller rating, sold quantity, and item condition.
Marketplace logic: The parameter controls which regional eBay site is searched. The default is (US). When a user refers to a country or region, map it to the corresponding eBay domain (e.g., UK -> , Germany -> ).
ebayDomainebay.comebay.co.ukebay.deBuying format: eBay supports multiple buying formats -- for bid-based listings, (Buy It Now) for fixed-price listings, and (Best Offer) for negotiable listings.
AuctionBINBOeBay商品搜索可访问eBay前端商品listing数据。它支持基于关键词的搜索，并提供丰富的筛选选项，包括价格范围、商品状态、购买形式、排序方式、卖家所在地等。搜索结果包含商品标题、价格、运费信息、卖家评分、销量、商品状态等详情。
站点逻辑：参数控制搜索的eBay区域站点，默认值为（美国站）。当用户提及某个国家或地区时，需映射到对应的eBay域名（例如：英国 -> ，德国 -> ）。
ebayDomainebay.comebay.co.ukebay.de购买形式：eBay支持多种购买形式——（拍卖式listing）、（Buy It Now，一口价listing）和（Best Offer，议价listing）。
AuctionBINBOParameter Guide
参数指南
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
| keyword | string | No | Search keyword, up to 1024 characters | - |
| ebayDomain | string | No | eBay marketplace domain | ebay.com |
| page | integer | No | Page number for pagination | 1 |
| pageSize | integer | No | Results per page: 25, 50, 100, or 200 | 50 |
| orderBy | string | No | Sort order (see Sort Options below) | 12 (Best Match) |
| priceMin | number | No | Minimum price filter | - |
| priceMax | number | No | Maximum price filter | - |
| itemCondition | string | No | Item condition code(s), pipe-separated (e.g., | - |
| buyingFormat | string | No | Buying format: Auction, BIN, or BO | - |
| showOnly | string | No | Display filters, comma-separated (e.g., | - |
| location | integer | No | Seller location country code | - |
| prefLoc | string | No | Preferred location scope: 1=Domestic, 2=Regional, 3=Worldwide | - |
| zipCode | string | No | ZIP/postal code for regional delivery filtering | - |
| categoryId | integer | No | eBay category ID | - |
| noCache | boolean | No | Bypass cache for fresh results | false |
| 参数 | 类型 | 是否必填 | 描述 | 默认值 |
|---|---|---|---|---|
| keyword | string | 否 | 搜索关键词，最多1024字符 | - |
| ebayDomain | string | 否 | eBay站点域名 | ebay.com |
| page | integer | 否 | 分页页码 | 1 |
| pageSize | integer | 否 | 每页结果数量：25、50、100或200 | 50 |
| orderBy | string | 否 | 排序方式（见下方排序选项） | 12（最佳匹配） |
| priceMin | number | 否 | 最低价格筛选 | - |
| priceMax | number | 否 | 最高价格筛选 | - |
| itemCondition | string | 否 | 商品状态代码，用竖线分隔（例如： | - |
| buyingFormat | string | 否 | 购买形式：Auction、BIN或BO | - |
| showOnly | string | 否 | 显示筛选条件，用逗号分隔（例如： | - |
| location | integer | 否 | 卖家所在国家代码 | - |
| prefLoc | string | 否 | 偏好配送范围：1=国内，2=区域，3=全球 | - |
| zipCode | string | 否 | 用于区域配送筛选的邮政编码 | - |
| categoryId | integer | 否 | eBay分类ID | - |
| noCache | boolean | 否 | 绕过缓存获取最新结果 | false |
Sort Options
排序选项
| Code | Meaning |
|---|---|
| 12 | Best Match (default) |
| 1 | Time: ending soonest |
| 10 | Time: newly listed |
| 15 | Price + Shipping: lowest first |
| 16 | Price + Shipping: highest first |
| 2 | Price: lowest first |
| 3 | Price: highest first |
| 7 | Distance: nearest first |
| 18 | Condition: new first |
| 19 | Condition: used first |
| 代码 | 含义 |
|---|---|
| 12 | 最佳匹配（默认） |
| 1 | 时间：即将结束 |
| 10 | 时间：最新上架 |
| 15 | 价格+运费：从低到高 |
| 16 | 价格+运费：从高到低 |
| 2 | 价格：从低到高 |
| 3 | 价格：从高到低 |
| 7 | 距离：从近到远 |
| 18 | 状态：新品优先 |
| 19 | 状态：二手优先 |
Item Condition Codes
商品状态代码
| Code | Condition |
|---|---|
| 1000 | New |
| 1500 | New other (see details) |
| 1750 | New with defects |
| 2000 | Certified Refurbished |
| 2010 | Excellent - Refurbished |
| 2020 | Very Good - Refurbished |
| 2030 | Good - Refurbished |
| 2500 | Seller refurbished / Remanufactured |
| 2750 | Like New |
| 3000 | Used / Pre-owned |
| 7000 | For parts or not working |
| 代码 | 状态 |
|---|---|
| 1000 | 全新 |
| 1500 | 全新其他（详见详情） |
| 1750 | 全新瑕疵品 |
| 2000 | 认证翻新 |
| 2010 | 极佳 - 翻新 |
| 2020 | 非常好 - 翻新 |
| 2030 | 良好 - 翻新 |
| 2500 | 卖家翻新/再造 |
| 2750 | 近乎全新 |
| 3000 | 二手/已使用 |
| 7000 | 仅作零件或无法使用 |
showOnly Filter Values
showOnly筛选值
| Value | Meaning |
|---|---|
| Complete | Completed listings |
| Sold | Sold listings only |
| FR | Free returns |
| RPA | Returns accepted |
| AS | Authorized seller |
| Savings | Deals & savings |
| SaleItems | Sale items |
| Lots | Lots |
| FS | Free shipping |
| LPickup | Local pickup |
| 值 | 含义 |
|---|---|
| Complete | 已完成listing |
| Sold | 仅显示已售listing |
| FR | 免费退货 |
| RPA | 接受退货 |
| AS | 授权卖家 |
| Savings | 优惠与折扣 |
| SaleItems | 促销商品 |
| Lots | 批量商品 |
| FS | 免运费 |
| LPickup | 自提 |
Supported eBay Domains
支持的eBay站点域名
| Domain | Country |
|---|---|
| ebay.com | United States (default) |
| ebay.co.uk | United Kingdom |
| ebay.de | Germany |
| ebay.fr | France |
| ebay.it | Italy |
| ebay.es | Spain |
| ebay.ca | Canada |
| ebay.com.au | Australia |
| ebay.nl | Netherlands |
| ebay.at | Austria |
| ebay.ch | Switzerland |
| ebay.pl | Poland |
| ebay.ie | Ireland |
| ebay.com.hk | Hong Kong |
| ebay.com.my | Malaysia |
| ebay.com.sg | Singapore |
| 域名 | 国家/地区 |
|---|---|
| ebay.com | 美国（默认） |
| ebay.co.uk | 英国 |
| ebay.de | 德国 |
| ebay.fr | 法国 |
| ebay.it | 意大利 |
| ebay.es | 西班牙 |
| ebay.ca | 加拿大 |
| ebay.com.au | 澳大利亚 |
| ebay.nl | 荷兰 |
| ebay.at | 奥地利 |
| ebay.ch | 瑞士 |
| ebay.pl | 波兰 |
| ebay.ie | 爱尔兰 |
| ebay.com.hk | 中国香港 |
| ebay.com.my | 马来西亚 |
| ebay.com.sg | 新加坡 |
API Usage
API使用说明
This tool calls the LinkFox tool gateway API. See for calling conventions, request parameters, and response structure. You can also execute directly to run queries.
references/api.mdscripts/ebay_search.py本工具调用LinkFox工具网关API。调用规范、请求参数和响应结构请参考。您也可以直接执行来运行查询。
references/api.mdscripts/ebay_search.pyUsage Examples
使用示例
1. Basic Keyword Search
Search for "wireless earbuds" on the US eBay marketplace:
json
{"keyword": "wireless earbuds"}2. Search Sold Listings for Price Research
Find sold listings for "iPhone 15 Pro" to gauge market value:
json
{"keyword": "iPhone 15 Pro", "showOnly": "Sold,Complete", "orderBy": "10"}3. Search on a Specific Marketplace with Price Range
Find new laptops priced between $500 and $1000 on eBay UK:
json
{"keyword": "laptop", "ebayDomain": "ebay.co.uk", "priceMin": 500, "priceMax": 1000, "itemCondition": "1000"}4. Auction Items Ending Soon
Find active auctions for "vintage watch" ending soonest:
json
{"keyword": "vintage watch", "buyingFormat": "Auction", "orderBy": "1"}5. Find the Cheapest New Items
Find the cheapest new "USB-C cable" with free shipping:
json
{"keyword": "USB-C cable", "itemCondition": "1000", "orderBy": "15", "showOnly": "FS"}6. Paginated Results
Get page 3 of results with 100 items per page for "running shoes":
json
{"keyword": "running shoes", "page": 3, "pageSize": 100}7. Category-Specific Search
Search within a specific eBay category:
json
{"keyword": "mechanical keyboard", "categoryId": 33963}8. Location-Filtered Search
Find products located in Germany on the German eBay site:
json
{"keyword": "Kopfhoerer", "ebayDomain": "ebay.de", "location": 77}1. 基础关键词搜索
在美国eBay站点搜索“wireless earbuds”：
json
{"keyword": "wireless earbuds"}2. 搜索已售listing进行价格调研
查找“iPhone 15 Pro”的已售listing以评估市场价值：
json
{"keyword": "iPhone 15 Pro", "showOnly": "Sold,Complete", "orderBy": "10"}3. 指定站点并按价格范围搜索
在英国eBay站点查找价格在500-1000美元之间的全新笔记本电脑：
json
{"keyword": "laptop", "ebayDomain": "ebay.co.uk", "priceMin": 500, "priceMax": 1000, "itemCondition": "1000"}4. 即将结束的拍卖商品
查找“vintage watch”的活跃拍卖商品，按即将结束排序：
json
{"keyword": "vintage watch", "buyingFormat": "Auction", "orderBy": "1"}5. 查找最便宜的全新商品
查找带免运费的最便宜全新“USB-C cable”：
json
{"keyword": "USB-C cable", "itemCondition": "1000", "orderBy": "15", "showOnly": "FS"}6. 分页结果
获取“running shoes”的第3页结果，每页100条：
json
{"keyword": "running shoes", "page": 3, "pageSize": 100}7. 指定分类搜索
在特定eBay分类内搜索：
json
{"keyword": "mechanical keyboard", "categoryId": 33963}8. 按位置筛选搜索
在德国eBay站点查找位于德国的商品：
json
{"keyword": "Kopfhoerer", "ebayDomain": "ebay.de", "location": 77}Display Rules
展示规则
- Present data clearly: Show search results in well-formatted tables including key fields such as title, price, condition, seller info, and shipping
- Price formatting: Always display prices with their currency symbol. When showing price ranges (minPrice to maxPrice), format as a range
- Sold/completed data: When showing sold items, highlight the sold price and quantity to help users with pricing research
- Seller trust indicators: When available, show seller feedback percentage and review count to help users evaluate seller reliability
- Pagination notice: When total results exceed the current page, inform the user of the total count and suggest pagination to see more
- Sponsored items: Clearly mark sponsored listings so users can distinguish organic results from promoted ones
- Error handling: When a query fails, explain the issue and suggest adjusting search parameters
- Link presentation: Provide product links so users can view full details on eBay
- 清晰呈现数据：将搜索结果整理为格式规范的表格，包含标题、价格、状态、卖家信息、运费等关键字段
- 价格格式：始终显示价格及对应货币符号。展示价格范围（最低价至最高价）时，格式化为区间形式
- 已售/完成数据：展示已售商品时，突出显示售价和销量，帮助用户进行价格调研
- 卖家信任指标：若有相关数据，展示卖家好评率和评价数量，帮助用户评估卖家可靠性
- 分页提示：当总结果数超过当前页时，告知用户总数量并建议分页查看更多内容
- 赞助商品标记：明确标记赞助listing，以便用户区分自然结果和推广结果
- 错误处理：查询失败时，说明问题并建议调整搜索参数
- 链接展示：提供商品链接，方便用户在eBay上查看完整详情
Important Limitations
重要限制
- No historical data: This tool returns current live listings only, not historical pricing trends
- Result cap: Maximum 200 results per page
- Rate limiting: Excessive requests may be throttled; use sparingly
noCache: true - Currency: Prices are returned in the local currency of the eBay domain being searched
- 无历史数据：本工具仅返回当前在线listing，不提供历史价格趋势
- 结果上限：每页最多返回200条结果
- 速率限制：请求过多可能会被限流；请谨慎使用
noCache: true - 货币：价格以所搜索eBay站点的本地货币返回
User Expression & Scenario Quick Reference
用户表述与场景速查
Applicable -- Product search and listing data on eBay:
| User Says | Scenario |
|---|---|
| "Search eBay for XX" | Basic product search |
| "How much does XX sell for on eBay" | Sold listing price research |
| "Find cheapest XX on eBay" | Price comparison / lowest price |
| "eBay auctions for XX" | Auction listing search |
| "What's selling on eBay UK/Germany" | Regional marketplace browsing |
| "New XX under $50 on eBay" | Filtered search by condition and price |
| "eBay sold prices for XX" | Completed/sold listing analysis |
| "Find refurbished XX on eBay" | Condition-specific search |
Not applicable -- Needs beyond eBay product listings:
- eBay seller account management or store analytics
- eBay listing creation or editing
- eBay order tracking or purchase history
- Cross-platform price comparison (eBay vs Amazon vs others)
- eBay advertising or promoted listing management
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
- The functionality or purpose described in this skill does not match actual behavior
- The skill's results do not match the user's intent
- The user expresses dissatisfaction or praise about this skill
- Anything you believe could be improved
Call the feedback API as specified in . Do not interrupt the user's flow.
references/api.mdFor more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.
适用场景 -- eBay商品搜索与listing数据相关：
| 用户表述 | 场景 |
|---|---|
| "在eBay上搜索XX" | 基础商品搜索 |
| "XX在eBay上卖多少钱" | 已售listing价格调研 |
| "在eBay上找最便宜的XX" | 价格对比/最低价查找 |
| "eBay上XX的拍卖商品" | 拍卖listing搜索 |
| "英国/德国eBay上卖什么" | 区域站点浏览 |
| "eBay上50美元以下的全新XX" | 按状态和价格筛选搜索 |
| "XX在eBay上的售价" | 已完成/已售listing分析 |
| "在eBay上找翻新XX" | 按状态筛选搜索 |
不适用场景 -- 超出eBay商品listing的需求：
- eBay卖家账户管理或店铺分析
- eBay listing创建或编辑
- eBay订单跟踪或购买历史
- 跨平台价格对比（eBay vs 亚马逊等）
- eBay广告或推广listing管理
反馈：
当出现以下情况时，自动检测并通过反馈API提交反馈：
- 本技能描述的功能或用途与实际行为不符
- 技能结果不符合用户意图
- 用户表达了对本技能的不满或赞赏
- 任何您认为可以改进的内容
请按照中的说明调用反馈API，请勿中断用户流程。
references/api.md如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。