newegg-product-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Newegg Product Search

Newegg产品搜索

Search Newegg products via MCP over HTTP using standard JSON-RPC. Use the

bash

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

通过HTTP协议基于标准JSON-RPC，借助MCP搜索Newegg产品。使用

bash

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

Agent Execution Rules

Agent执行规则

Do not ask for clarification. Infer
```
query
```
and optional parameters from the user's message and call immediately.
Use the bash
tool to run the curl command below.
On curl failure or invalid JSON, report the error directly.

请勿请求澄清。从用户消息中推断
```
query
```
及可选参数并立即调用。
使用**
```
bash
```
**工具运行下方的curl命令。
若curl调用失败或返回无效JSON，直接报告错误。

API Call

API调用

Required header on every request: all calls to

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

must carry

x-skill: newegg-product-search

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/product-search" \
  -H "Content-Type: application/json" \
  -H "x-skill: newegg-product-search" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "searchPost",
      "arguments": {
        "query": "<QUERY>"
      }
    }
  }'

Replace

<QUERY>

with the user's search term. Add optional fields inside

"arguments"

as needed.

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/product-search" \
  -H "Content-Type: application/json" \
  -H "x-skill: newegg-product-search" \
  -d '{"jsonrpc":"2.0","id":0,"method":"tools/list"}'

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

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

的调用，除

Content-Type

外，还必须携带

x-skill: newegg-product-search

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

bash

curl -sS -X POST "https://apis.newegg.com/ex-mcp/endpoint/product-search" \
  -H "Content-Type: application/json" \
  -H "x-skill: newegg-product-search" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "searchPost",
      "arguments": {
        "query": "<QUERY>"
      }
    }
  }'

将

<QUERY>

替换为用户的搜索词。根据需要在

"arguments"

内添加可选字段。

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

tools/list

以发现正确的工具名称：

bash

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

Parameters

参数

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Search keyword or product name
`order`	integer	No	`8`	Sort order — see values below
`page`	integer	No	`1`	Page number (min: 1)
`minPrice`	number	No	null	Minimum price in USD (inclusive)
`maxPrice`	number	No	null	Maximum price in USD (inclusive)

参数	类型	是否必填	默认值	说明
`query`	字符串	是	—	搜索关键词或产品名称
`order`	整数	否	`8`	排序方式——查看下方取值
`page`	整数	否	`1`	页码（最小值：1）
`minPrice`	数字	否	null	最低价格（美元，包含此值）
`maxPrice`	数字	否	null	最高价格（美元，包含此值）

order

Values

order

取值

Value	Sort By
`1`	Best Rating
`2`	Lowest Price
`3`	Highest Price
`4`	Most Reviews
`6`	Name A → Z
`7`	Name Z → A
`8`	Featured (default)
`14`	Release Date
`15`	Best Selling
`16`	Seller Rating
`22`	Sales Volume

Mapping user intent → order: "cheapest" →

· "most expensive" →

· "best rated" →

· "most reviewed" →

· "newest" →

· "best selling" →

取值	排序依据
`1`	最佳评分
`2`	最低价格
`3`	最高价格
`4`	最多评论
`6`	名称A→Z
`7`	名称Z→A
`8`	精选商品（默认）
`14`	发布日期
`15`	最畅销
`16`	卖家评分
`22`	销量

用户意图→order映射： "最便宜"→

· "最贵"→

· "评分最高"→

· "评论最多"→

· "最新发布"→

· "最畅销"→

Response Parsing

响应解析

The MCP response wraps a

PageProducts

object. Parse the path:

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

MCP响应封装了一个

PageProducts

对象。解析路径：

response → result.content[0].text →（解析为JSON）→ PageProducts

PageProducts fields

PageProducts字段

Field	Description
`page`	Current page number
`pageSize`	Items per page (typically 20)
`total`	Total matching products
`totalPage`	Total pages
`products`	Array of `ProductItem`

字段	说明
`page`	当前页码
`pageSize`	每页商品数量（通常为20）
`total`	匹配商品总数
`totalPage`	总页数
`products`	`ProductItem` 数组

ProductItem fields

ProductItem字段

Field	Description
`ItemNumber`	Item number, e.g. `"24-012-083"`
`WebDescription`	Product title
`Price.CurrentPriceText`	Current price, e.g. `"$159.99"`
`Price.OriginalPriceText`	Original price (show if differs from current)
`Price.PriceSaveText`	Savings text, e.g. `"$90.00 (36%)"` (if on sale)
`Price.RatingOneDecimal`	Avg rating (0–5, one decimal), e.g. `4.4`
`Price.HumanRating`	Number of reviews, e.g. `850`
`ImageName`	Image filename for URL construction
`IsRefurbished`	`true` if refurbished item

URL construction:

Product page:
```
https://www.newegg.com/p/{ItemNumber}
```

Product image:

https://c1.neweggimages.com/productimage/nb300/{ImageName}

字段	说明
`ItemNumber`	商品编号，例如 `"24-012-083"`
`WebDescription`	商品标题
`Price.CurrentPriceText`	当前价格，例如 `"$159.99"`
`Price.OriginalPriceText`	原价（与当前价格不同时显示）
`Price.PriceSaveText`	优惠信息，例如 `"$90.00 (36%)"` （促销时显示）
`Price.RatingOneDecimal`	平均评分（0–5，保留一位小数），例如 `4.4`
`Price.HumanRating`	评论数量，例如 `850`
`ImageName`	用于构建URL的图片文件名
`IsRefurbished`	若为翻新商品则为 `true`

URL构建：

商品页面：
```
https://www.newegg.com/p/{ItemNumber}
```

商品图片：

https://c1.neweggimages.com/productimage/nb300/{ImageName}

Response Format

响应格式

undefined

undefined

Newegg Search: "{query}"

Newegg搜索："{query}"

#	Product	Price	Rating	Reviews
1	WebDescription	CurrentPriceText	⭐ RatingOneDecimal	HumanRating
2	...	...	...	...

📄 Page {page} / {totalPage} · {total} total results 🔗 View all on Newegg


- If item is on sale, append savings below its row: `> 💸 Save PriceSaveText (was OriginalPriceText)`
- If `IsRefurbished` is true, append `🔄 Refurbished` to the product name
- If price filter applied: `💰 Price: $minPrice – $maxPrice`
- If no results: inform the user and suggest broadening the search or removing filters
- Offer to load the next page if `page < totalPage`

#	商品	价格	评分	评论数
1	WebDescription	CurrentPriceText	⭐ RatingOneDecimal	HumanRating
2	...	...	...	...

📄 第 {page} 页 / 共 {totalPage} 页 · 共 {total} 个结果 🔗 在Newegg查看全部


- 若商品正在促销，在其行下方添加优惠信息：`> 💸 优惠 PriceSaveText（原价OriginalPriceText）`
- 若`IsRefurbished`为`true`，在商品名称后追加`🔄 翻新`
- 若应用了价格筛选：`💰 价格范围：$minPrice – $maxPrice`
- 若无结果：告知用户并建议扩大搜索范围或移除筛选条件
- 若`page < totalPage`，提供加载下一页的选项

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: Tell the user no results were found; suggest adjusting
```
query
```
or removing price filters.

HTTP错误或curl调用失败：报告状态码和响应体；请勿重试。
响应中包含
result.error
：向用户显示
```
error.message
```
。
products
数组为空：告知用户未找到结果；建议调整
```
query
```
或移除价格筛选。

newegg-product-search

Original

Translation

Newegg Product Search

Newegg产品搜索

Agent Execution Rules

Agent执行规则

API Call

API调用

Parameters

参数

`order`
Values

`order`
取值

Response Parsing

响应解析

PageProducts fields

PageProducts字段

ProductItem fields

ProductItem字段

Response Format

响应格式

Newegg Search: "{query}"

Newegg搜索："{query}"

Edge Cases

边缘情况

newegg-product-search

Original

Translation

Newegg Product Search

Newegg产品搜索

Agent Execution Rules

Agent执行规则

API Call

API调用

Parameters

参数

order Values

order取值

Response Parsing

响应解析

PageProducts fields

PageProducts字段

ProductItem fields

ProductItem字段

Response Format

响应格式

Newegg Search: "{query}"

Newegg搜索："{query}"

Edge Cases

边缘情况

`order`
Values

`order`
取值