newegg-clearance

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Newegg Clearance Store

Newegg清仓商店

Browse the Newegg Clearance / Promotion Store via MCP over HTTP using standard JSON-RPC. Use the

bash

tool to call the endpoint — no MCP client registration required.

通过MCP以HTTP方式调用标准JSON-RPC协议浏览Newegg清仓/促销商店。使用

bash

工具调用端点——无需注册MCP客户端。

Agent Execution Rules

Agent执行规则

Do not ask for clarification. The data source and output format are fully specified — call immediately.
Use the bash
tool to run the curl command below.
On curl failure or invalid JSON, report the error directly.
Display the top 10 products from the response.
Browse all link to "https://www.newegg.com/Clearance-Store/EventSaleStore/ID-697"
**Don't show image

请勿请求澄清。数据源和输出格式已完全指定——直接调用即可。
使用**
```
bash
```
**工具运行下方的curl命令。
若curl调用失败或返回无效JSON，直接报告错误。
显示响应中的前10个商品。
浏览全部链接指向"https://www.newegg.com/Clearance-Store/EventSaleStore/ID-697"
不要显示图片

API Call

API调用

Required header on every request: all calls to

apis.newegg.com/ex-mcp/...

must carry

x-skill: newegg-clearance

in addition to

Content-Type

. It identifies the calling skill to the endpoint — include it even when you assemble a request by hand rather than copying an example below.

bash

curl -sS -X POST "https://apis.newegg.com/ex-mcp/endpoint/website-www-tool" \
  -H "Content-Type: application/json" \
  -H "x-skill: newegg-clearance" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "getapi_adapter_Jss_promotionStore",
      "arguments": {
        "storeId": 697,
        "CountryCode": "USA",
        "CompanyCode": 1003
      }
    }
  }'

If the call returns a tool-not-found error, first run

tools/list

to discover the correct tool name:

bash

curl -sS -X POST "https://apis.newegg.com/ex-mcp/endpoint/website-www-tool" \
  -H "Content-Type: application/json" \
  -H "x-skill: newegg-clearance" \
  -d '{"jsonrpc":"2.0","id":0,"method":"tools/list"}'

每个请求必须包含的请求头：所有对

apis.newegg.com/ex-mcp/...

的调用，除了

Content-Type

外，还必须携带

x-skill: newegg-clearance

。它用于向端点标识调用的Skill——即使你手动组装请求而非复制下方示例，也需包含此请求头。

bash

curl -sS -X POST "https://apis.newegg.com/ex-mcp/endpoint/website-www-tool" \
  -H "Content-Type: application/json" \
  -H "x-skill: newegg-clearance" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "getapi_adapter_Jss_promotionStore",
      "arguments": {
        "storeId": 697,
        "CountryCode": "USA",
        "CompanyCode": 1003
      }
    }
  }'

如果调用返回工具未找到错误，请先运行

tools/list

以查找正确的工具名称：

bash

curl -sS -X POST "https://apis.newegg.com/ex-mcp/endpoint/website-www-tool" \
  -H "Content-Type: application/json" \
  -H "x-skill: newegg-clearance" \
  -d '{"jsonrpc":"2.0","id":0,"method":"tools/list"}'

Response Parsing

响应解析

The MCP response wraps a store catalog object. Parse the path:

response → result.content[0].text → (parse as JSON) → root object

MCP响应封装了一个商店目录对象。解析路径如下：

response → result.content[0].text → (解析为JSON) → 根对象

Root Fields

根字段

Field	Description
`Products`	Array of product entries (up to 36/page)
`TotalItemCount`	Total products in the clearance store

字段名	描述
`Products`	商品条目数组（每页最多36个）
`TotalItemCount`	清仓商店中的商品总数

Product Entry Fields

商品条目字段

Each entry in

Products

has a top-level

ProductNumber

and an

ItemCell

object.

Field	Description
`ProductNumber`	Item number, e.g. `"17-701-025"`
`ItemCell.Description.Title`	Full product title
`ItemCell.Description.SimplifiedLineDescription`	Shortened product title (prefer this if non-empty)
`ItemCell.ItemManufactory.Manufactory`	Brand name
`ItemCell.ItemPriceRange.PriceRangeMin`	Lowest available price in USD
`ItemCell.ItemPriceRange.PriceRangeMax`	Highest available price in USD
`ItemCell.Review.RatingOneDecimal`	Avg rating (0–5, one decimal), e.g. `4.3`
`ItemCell.Review.HumanRating`	Number of reviews
`ItemCell.Feature.IsOpenBoxed`	`true` if open-box item
`ItemCell.Feature.IsRefurbished`	`true` if refurbished item
`ItemCell.Subcategory.SubcategoryDescription`	Category label, e.g. `"Power Supplies"`

URL construction:

Product page:

https://www.newegg.com/p/{ProductNumber}

Price display logic:

If
```
ItemPriceRange
```
is not null: show
```
PriceRangeMin
```
as the price (and
```
PriceRangeMax
```
if different)
If
```
ItemPriceRange
```
is null and
```
FinalPrice
```
> 0: show
```
FinalPrice
```
If both are unavailable: show
```
"—"
```

Products

中的每个条目包含顶级字段

ProductNumber

和

ItemCell

对象。

字段	描述
`ProductNumber`	商品编号，例如 `"17-701-025"`
`ItemCell.Description.Title`	完整商品标题
`ItemCell.Description.SimplifiedLineDescription`	简化商品标题（若非空则优先使用）
`ItemCell.ItemManufactory.Manufactory`	品牌名称
`ItemCell.ItemPriceRange.PriceRangeMin`	最低可用价格（美元）
`ItemCell.ItemPriceRange.PriceRangeMax`	最高可用价格（美元）
`ItemCell.Review.RatingOneDecimal`	平均评分（0–5，保留一位小数），例如 `4.3`
`ItemCell.Review.HumanRating`	评论数量
`ItemCell.Feature.IsOpenBoxed`	若为开箱商品则为 `true`
`ItemCell.Feature.IsRefurbished`	若为翻新商品则为 `true`
`ItemCell.Subcategory.SubcategoryDescription`	分类标签，例如 `"Power Supplies"` （电源供应器）

URL构造：

商品页面：

https://www.newegg.com/p/{ProductNumber}

价格显示逻辑：

若
```
ItemPriceRange
```
不为空：显示
```
PriceRangeMin
```
作为价格（若
```
PriceRangeMax
```
不同则同时显示）
若
```
ItemPriceRange
```
为空且
```
FinalPrice
```
> 0：显示
```
FinalPrice
```
若两者均不可用：显示
```
"—"
```

Response Format

响应格式

undefined

undefined

🏷️ Newegg Clearance Store — Top 10 Deals

🏷️ Newegg清仓商店 — 十大优惠

#	Product	Brand	Price	Rating	Reviews
1	SimplifiedLineDescription	Manufactory	$PriceRangeMin	⭐ RatingOneDecimal	HumanRating
2	...	...	...	...	...
...

📦 {TotalItemCount} total clearance items available


- If `IsOpenBoxed` is true, append `📦 Open Box` badge after the product name
- If `IsRefurbished` is true, append `🔄 Refurbished` badge after the product name
- If `RatingOneDecimal` is 0 and `HumanRating` is 0, show `—` for both rating columns
- Prefer `SimplifiedLineDescription` for the display name; fall back to `Title` if empty
- Truncate product names longer than 80 characters with `…`

#	商品	品牌	价格	评分	评论数
1	SimplifiedLineDescription	Manufactory	$PriceRangeMin	⭐ RatingOneDecimal	HumanRating
2	...	...	...	...	...
...

📦 共有{TotalItemCount}件清仓商品


- 若`IsOpenBoxed`为true，在商品名称后追加`📦 开箱品`标识
- 若`IsRefurbished`为true，在商品名称后追加`🔄 翻新品`标识
- 若`RatingOneDecimal`为0且`HumanRating`为0，评分和评论数列均显示`—`
- 优先使用`SimplifiedLineDescription`作为显示名称；若为空则回退使用`Title`
- 商品名称超过80字符时，用`…`截断

Edge Cases

边缘情况

HTTP error or curl failure: Report status code and body; do not retry.
result.error
in response: Display
```
error.message
```
to the user.
Empty
Products
array: Inform the user the clearance store appears empty.
ItemPriceRange
is null and
FinalPrice
is 0: Display price as
```
"—"
```
.

HTTP错误或curl调用失败：报告状态码和响应体；请勿重试。
响应中包含
result.error
：向用户显示
```
error.message
```
。
Products
数组为空：告知用户清仓商店暂无商品。
ItemPriceRange
为空且
FinalPrice
为0：价格显示为
```
"—"
```
。