newegg-product-search（新蛋产品搜索）

Newegg Product Search

Search Newegg products via MCP over HTTP using standard JSON-RPC. Use the bash tool to call the endpoint — no MCP client registration required.

Agent Execution Rules

• 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.

API Call

curl -sS -X POST "https://apis.newegg.com/ex-mcp/endpoint/product-search" \
  -H "Content-Type: application/json" \
  -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" \ -d '{"jsonrpc":"2.0","id":0,"method":"tools/list"}' ``

Parameters

order Values

Mapping user intent → order: "cheapest" → 2 · "most expensive" → 3 · "best rated" → 1 · "most reviewed" → 4 · "newest" → 14 · "best selling" → 15

Response Parsing

The MCP response wraps a PageProducts object. Parse the path:

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

PageProducts fields

ProductItem fields

URL construction:

• Product page: https://www.newegg.com/p/{ItemNumber}
• Product image: https://c1.neweggimages.com/productimage/nb300/{ImageName}

Response Format

## Newegg Search: "{query}"

| # | Product | Price | Rating | Reviews |
|---|---------|-------|--------|---------|
| 1 | [WebDescription](https://www.newegg.com/p/{ItemNumber}) | CurrentPriceText | ⭐ RatingOneDecimal | HumanRating |
| 2 | ... | ... | ... | ... |

📄 Page {page} / {totalPage}  ·  {total} total results
🔗 [View all on Newegg](https://www.newegg.com/p/pl?d={query})

• 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

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.