| name | newegg-laptop-finder |
| description | Find the perfect laptop on Newegg by asking the user about their needs and returning the top 10 matching laptops with direct purchase links. Use this skill whenever users want help choosing or finding a laptop — even if they don't mention Newegg by name. Always trigger on phrases like: "help me find a laptop", "what laptop should I buy", "recommend a laptop for gaming/work/school/video editing", "I need a laptop under $X", "best laptop for students", "find me a good laptop", "laptop recommendation", "我想买个笔记本", "推荐笔记本电脑", "给我找一款游戏本", "帮我找笔记本", or any question about choosing or comparing laptops for purchase. This skill handles the full flow: gathering requirements → searching Newegg → showing top 10 results with clickable buy links. |
Newegg Laptop Finder
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.
Overview
- Gather requirements — Ask a short, friendly set of questions
- Build a targeted query — Map their needs to proven search terms
- Fetch results from Newegg — Call the product search API
- Display top 10 — Show a clean results table with clickable purchase links
Step 1: Gather User Requirements
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.
Always ask:
1. Primary use — What will they mainly use the laptop for?
| Use Case | Examples |
|---|
| 🎮 Gaming | gaming, AAA games, FPS, esports |
| 💼 Work / Business / Productivity | office, remote work, presentations |
| 🎓 School / Study / Everyday | note-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+
Optional follow-ups (ask 1 max if not already clear):
- 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.
Step 2: Build the Search Query
Use these proven queries that return real results from the Newegg API:
| Use Case | Primary Query | Fallback 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.)
Step 3: Call the Newegg Product Search API
Use the bash tool. The tool name is "newegg product search" (with spaces — this is critical).
Primary call (with price filter if budget given):
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": "newegg product search",
"arguments": {
"query": "<QUERY>",
"minPrice": <MIN_OR_NULL>,
"maxPrice": <MAX_OR_NULL>,
"order": 15
}
}
}'
Budget → price filter mapping:
| Budget stated | minPrice | maxPrice |
|---|
| Under $500 | null | 600 |
| Under $800 | null | 900 |
| $500–$800 | 400 | 900 |
| $800–$1,200 | 700 | 1400 |
| $1,200–$1,800 | 1000 | 2000 |
| $1,800+ | 1500 | null |
| Around $X | X × 0.8 | X × 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".
Parse the response:
response → result.content[0].text → parse as JSON → products array
Take the first 10 items from products.
Key product fields:
| Field | Notes |
|---|
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 |
Step 4: Display the Top 10 Results
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.
## 🖥️ Top 10 Laptops for [Use Case] — [Budget]
| # | Laptop | Price | Rating | Reviews |
|---|--------|-------|--------|---------|
| 1 | [Product Name](https://www.newegg.com/p/ITEM_NUMBER) | $XXX | ⭐ X.X | NNN |
| 2 | [Product Name](https://www.newegg.com/p/ITEM_NUMBER) | $XXX | ⭐ X.X | NNN |
...
| 10 | ... | ... | ... | ... |
💡 **Click any laptop name to view full specs and buy on Newegg.**
🔗 [See more laptops on Newegg →](https://www.newegg.com/Laptops-Notebooks/SubCategory/ID-32?d=QUERY)
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
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
