Back to Details

newegg-laptop-finder

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Newegg Laptop Finder

Newegg笔记本电脑查找器

Help users find their perfect laptop by understanding their needs, then searching the Newegg catalog to present the top 10 best-matching options — each with a direct link to purchase on Newegg.com.
通过了解用户需求，在Newegg商品目录中搜索并为用户呈现匹配度最高的10款笔记本电脑选项——每款均附带Newegg.com的直接购买链接，帮助用户找到理想的笔记本。

Overview

概述

  1. Gather requirements — Ask a short, friendly set of questions
  2. Build a targeted query — Map their needs to proven search terms
  3. Fetch results from Newegg — Call the product search API
  4. Display top 10 — Show a clean results table with clickable purchase links
  1. 收集需求 — 提出一组简短友好的问题
  2. 构建精准查询语句 — 将用户需求转化为经过验证的搜索关键词
  3. 从Newegg获取结果 — 调用产品搜索API
  4. 展示Top 10结果 — 以简洁的结果表格形式展示，附带可点击的购买链接

Step 1: Gather User Requirements

步骤1：收集用户需求

Ask the user a few focused questions in a warm, conversational tone in one message. Aim for 2–3 questions total. If the user has already given you details (e.g., "gaming laptop under $1000"), extract what you can and only ask about what's genuinely missing.
用亲切的对话语气，在一条消息中向用户提出几个针对性问题，总共2-3个即可。如果用户已提供部分信息（例如“1000美元以下的游戏笔记本”），则提取已知信息，仅询问缺失的关键内容。

Always ask:

必问问题：

1. Primary use — What will they mainly use the laptop for?
Use CaseExamples
🎮 Gaminggaming, AAA games, FPS, esports
💼 Work / Business / Productivityoffice, remote work, presentations
🎓 School / Study / Everydaynote-taking, browsing, streaming
🎨 Creative (photo/video/design)video editing, photo editing, 3D work
2. Budget — What's their price range?
Accept any phrasing: "under $600", "$800 to $1200", "around $1000", "my budget is $1500". If they're unsure, suggest: Under $800 / $800–$1,200 / $1,200–$1,800 / $1,800+
1. 主要用途 — 用户主要用笔记本做什么？
使用场景示例
🎮 游戏gaming, AAA games, FPS, esports
💼 工作/商务/生产力办公、远程工作、演示
🎓 学习/日常使用记笔记、浏览网页、流媒体播放
🎨 创意工作（图片/视频/设计）视频剪辑、图片编辑、3D制作
2. 预算 — 用户的价格范围是多少？
接受任何表述方式：“600美元以下”、“800-1200美元”、“约1000美元”、“我的预算是1500美元”。如果用户不确定，可提供建议档位：800美元以下 / 800-1200美元 / 1200-1800美元 / 1800美元以上

Optional follow-ups (ask 1 max if not already clear):

可选跟进问题（最多问1个，若信息已明确则无需询问）：

  • Any strong brand preference? (ASUS, MSI, Lenovo, Dell, HP, Acer, Razer, etc.)
  • Prefer portability (thin & light) or max performance?
  • Screen size preference? 14–15" (portable) / 16–17" (larger screen)
Keep it short. If the user just wants to browse, start with the best general query.
  • 是否有明确的品牌偏好？（ASUS、MSI、Lenovo、Dell、HP、Acer、Razer等）
  • 更看重便携性（轻薄）还是极致性能？
  • 屏幕尺寸偏好？14-15英寸（便携）/ 16-17英寸（大屏）
保持提问简洁。如果用户只是想浏览，直接使用通用最佳查询语句开始搜索。

Step 2: Build the Search Query

步骤2：构建搜索查询语句

Use these proven queries that return real results from the Newegg API:
Use CasePrimary QueryFallback Query
Gaming (any price)
gaming laptop
RTX laptop
Creative / video editing
thin laptop
notebook computer
Work / Business
notebook computer
thin laptop
School / Study / Everyday
budget laptop
notebook computer
Thin & light / portable
thin laptop
notebook computer
General / unsure
notebook computer
thin laptop
Enhance the query with brand if specified: Add brand name to the query (e.g., 
"ASUS gaming laptop"
, 
"Lenovo notebook computer"
). Note: brand-specific queries may return fewer results; if < 5 results, drop the brand.
Do NOT use these queries — they return 0 or irrelevant results on Newegg: 
chromebook
, 
business laptop
, 
student laptop
, 
student notebook
, 
MacBook
(For MacBook/macOS requests, tell the user Newegg primarily carries Windows laptops and show the best thin & light alternatives.)
使用以下经过验证的查询语句，确保能从Newegg API返回有效结果：
使用场景主查询语句备用查询语句
游戏（任意价位）
gaming laptop
RTX laptop
创意/视频剪辑
thin laptop
notebook computer
工作/商务
notebook computer
thin laptop
学习/日常使用
budget laptop
notebook computer
轻薄/便携
thin laptop
notebook computer
通用/不确定
notebook computer
thin laptop
若用户指定品牌，优化查询语句： 在查询中加入品牌名称（例如
"ASUS gaming laptop"
、
"Lenovo notebook computer"
）。注意：品牌专属查询可能返回较少结果；若结果少于5个，需移除品牌关键词。
禁止使用以下查询语句——在Newegg上会返回0条或不相关结果： 
chromebook
, 
business laptop
, 
student laptop
, 
student notebook
, 
MacBook
（若用户询问MacBook/macOS设备，需告知用户Newegg主要销售Windows笔记本，并展示最佳轻薄替代机型。）

Step 3: Call the Newegg Product Search API

步骤3：调用Newegg产品搜索API

Use the 
bash
tool. The tool name is 
"newegg product search"
 (with spaces — this is critical).
使用
bash
工具。工具名称为
"newegg product search"
（包含空格，这一点至关重要）。

Primary call (with price filter if budget given):

主调用（若用户提供预算则添加价格筛选）：

Required header on every request: all calls to 
apis.newegg.com/ex-mcp/...
must carry 
x-skill: newegg-laptop-finder
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-laptop-finder" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "newegg product search",
      "arguments": {
        "query": "<QUERY>",
        "minPrice": <MIN_OR_NULL>,
        "maxPrice": <MAX_OR_NULL>,
        "order": 15
      }
    }
  }'
每个请求必须包含的请求头：所有对
apis.newegg.com/ex-mcp/...
的调用，除了
Content-Type
外，还必须携带
x-skill: newegg-laptop-finder
。该字段用于向端点标识调用方Skill——即使手动组装请求而非复制以下示例，也必须包含此请求头。
bash
curl -sS -X POST "https://apis.newegg.com/ex-mcp/endpoint/product-search" \
  -H "Content-Type: application/json" \
  -H "x-skill: newegg-laptop-finder" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "newegg product search",
      "arguments": {
        "query": "<QUERY>",
        "minPrice": <MIN_OR_NULL>,
        "maxPrice": <MAX_OR_NULL>,
        "order": 15
      }
    }
  }'

Budget → price filter mapping:

预算→价格筛选映射：

Budget statedminPricemaxPrice
Under $500null600
Under $800null900
$500–$800400900
$800–$1,2007001400
$1,200–$1,80010002000
$1,800+1500null
Around $XX × 0.8X × 1.2
Use slightly wider ranges than stated — the catalog is limited and narrow filters often return fewer than 10 results. If the price-filtered query returns fewer than 5 products, retry without price filters and note in your response which products fall closest to the user's budget.
Sort order: 
15
(Best Selling) by default. Use 
1
for "best rated", 
2
for "cheapest".
用户表述的预算minPricemaxPrice
500美元以下null600
800美元以下null900
500-800美元400900
800-1200美元7001400
1200-1800美元10002000
1800美元以上1500null
约X美元X × 0.8X × 1.2
使用比用户表述稍宽的价格范围——商品目录有限，过窄的筛选条件往往会导致结果不足10条。若带价格筛选的查询返回少于5款产品，需重新调用不带价格筛选的查询，并在回复中注明哪些产品最接近用户预算。
排序方式：默认使用
15
（畅销优先）。可使用
1
表示“评分最高”，
2
表示“价格最低”。

Parse the response:

解析响应：

response → result.content[0].text → parse as JSON → products array
Take the first 10 items from 
products
.
response → result.content[0].text → 解析为JSON → products数组
从
products
数组中取前10项。

Key product fields:

关键产品字段：

FieldNotes
ItemNumber
Build URL: 
https://www.newegg.com/p/{ItemNumber}
WebDescription
Product title (use as link text)
Price.FinalPrice
Numeric price — format as 
$X.XX
. (CurrentPriceText is often empty)
Price.OriginalPriceText
Original price before discount (may be empty)
Price.PriceSaveText
Savings text e.g. "$50.00 (10%)" (may be empty)
Price.RatingOneDecimal
Star rating 0–5
Price.HumanRating
Number of reviews
IsRefurbished
Show 🔄 tag if true
字段说明
ItemNumber
构建链接：
https://www.newegg.com/p/{ItemNumber}
WebDescription
产品标题（用作链接文本）
Price.FinalPrice
数字价格 — 格式化为
$X.XX
。（CurrentPriceText通常为空）
Price.OriginalPriceText
折扣前的原价（可能为空）
Price.PriceSaveText
优惠信息文本，例如“$50.00 (10%)”（可能为空）
Price.RatingOneDecimal
星级评分0-5
Price.HumanRating
评论数量
IsRefurbished
若为true，显示🔄标签

Step 4: Display the Top 10 Results

步骤4：展示Top 10结果

Present results as a clean markdown table. Every product name must be a clickable link so the user can go directly to Newegg to view specs and purchase.
undefined
以简洁的Markdown表格形式呈现结果。每个产品名称必须是可点击的链接，方便用户直接跳转到Newegg查看规格并购买。
undefined

🖥️ Top 10 Laptops for [Use Case] — [Budget]

🖥️ [使用场景]专属Top 10笔记本 — [预算范围]

#LaptopPriceRatingReviews
1Product Name$XXX⭐ X.XNNN
2Product Name$XXX⭐ X.XNNN
...
10............
💡 Click any laptop name to view full specs and buy on Newegg.
🔗 See more laptops on Newegg →

**Formatting rules:**
- Format `FinalPrice` as `$X` (no decimals if `.00`) or `$X.XX`
- If `PriceSaveText` is non-empty: add `> 💸 Save PriceSaveText` below the row
- If `IsRefurbished` is true: append ` 🔄` to product name in the link
- If rating is 0 and reviews is 0: show `—` instead

**After the table**, write **2–3 sentences of buying advice** tailored to the use case:
- 🎮 Gaming: what GPU tier is in the results and what frame rates to expect
- 🎓 School/Everyday: battery life, weight, and value tips
- 🎨 Creative: RAM, display quality, and GPU rendering capability
- 💼 Work: keyboard, display, portability, and build quality notes

---
#笔记本价格评分评论数
1产品名称$XXX⭐ X.XNNN
2产品名称$XXX⭐ X.XNNN
...
10............
💡 点击任意笔记本名称，即可在Newegg查看完整规格并购买。
🔗 查看Newegg更多笔记本 →

**格式规则：**
- 将`FinalPrice`格式化为`$X`（若为.00则省略小数）或`$X.XX`
- 若`PriceSaveText`不为空：在该行下方添加`> 💸 优惠PriceSaveText`
- 若`IsRefurbished`为true：在链接中的产品名称后追加` 🔄`
- 若评分为0且评论数为0：显示`—`替代

**表格之后**，根据使用场景撰写**2-3句购买建议**：
- 🎮 游戏：说明结果中的GPU等级及预期帧率
- 🎓 学习/日常使用：提供电池续航、重量及性价比建议
- 🎨 创意工作：提及内存、显示质量及GPU渲染能力
- 💼 工作：说明键盘、显示屏、便携性及机身材质相关注意事项

---

Edge Cases

边缘情况处理

  • Fewer than 5 price-filtered results: Retry without price filters. Note in your response which results are within or near the user's stated budget.
  • Fewer than 10 results total: Show what's available. Offer to try a different query or remove filters.
  • Results look wrong (only accessories, no laptops): Retry the fallback query from the table above.
  • **Want to c
  • 带价格筛选的结果少于5个：重新调用不带价格筛选的查询。在回复中注明哪些结果符合或接近用户预算。
  • 总结果少于10个：展示所有可用结果。主动提出可尝试其他查询或移除筛选条件。
  • 结果异常（仅显示配件，无笔记本）：使用表格中的备用查询语句重新调用。
  • **想要c