newegg-shell-shocker
Originally fromngbdf/newegg_skills
Installation
SKILL.md
Newegg Shell Shocker
Query Newegg Shell Shocker daily and next-day flash deal products.
Agent execution rules (read first)
- Do not call
ask_clarificationfor this task. The data source (single public GET JSON) and the output format (Markdown tables below) are fully specified — this is notmissing_info,ambiguous_requirement, orapproach_choice. - Immediately after loading this skill, use the
bashtool to run curl. Do not ask the user how to fetch data or which output format they prefer. - Run exactly:
curl -sS "https://www.newegg.com/api/Common/TomorrowShellShocker"
- Treat stdout as JSON and build the tables in Response Format. If curl fails (non-zero exit) or the body is not valid JSON, report the error in your reply — still without asking the user to choose a fetch method.
Trigger Scenarios
- User asks "What's on Shell Shocker"
- User asks "Today's flash deals" / "Newegg flash deals"
- User searches for Shell Shocker prices of specific products
- User requests to view Newegg limited-time special list
API
- Method: GET
- URL:
https://www.newegg.com/api/Common/TomorrowShellShocker - Request: No request body
Response Structure
Root object contains:
TodayItems(array) - Today's flash deal itemsTomorrowItems(array) - Tomorrow's flash deal items
Each item element contains an ItemBase object, from which to extract:
| Field | Path | Description |
|---|---|---|
| Item Number | ItemBase.Item |
e.g., 32-508-055 |
| Item Title | ItemBase.Description.Title |
Full item name |
| Original Price | ItemBase.OriginalUnitPrice |
Original price (USD) |
| Flash Deal Price | ItemBase.FinalPrice |
Final price (USD) |
| Image Filename | ItemBase.Image.Normal.ImageName |
e.g., 32-508-055-V01.jpg |
| Promotion Info | ItemBase.PromotionInfo.PromotionText |
e.g., free gifts, additional discounts, etc. |
Image URL Construction:
https://c1.neweggimages.com/ProductImageCompressAll/{ImageName}
例如:https://c1.neweggimages.com/ProductImageCompressAll/32-508-055-V01.jpg
Product Link Construction:
https://www.newegg.com/p/{Item}
例如:https://www.newegg.com/p/32-508-055
Execution Flow
- Call the API with
bashusing the curl command in Agent execution rules (no other tool for the HTTP request). - Parse JSON, iterate through
TodayItemsandTomorrowItems - Skip rows where
ItemBaseisnull(usually Combo rows) - Extract fields and format the response per Response Format
Response Format
Return a clear product table containing:
## Today's Flash Deals (TodayItems)
| Item Number | Product Name | Original Price | Flash Deal Price | Image |
|---------|---------|------|-------|------|
| 32-508-055 | [adidas $50 Gift Card](https://www.newegg.com/p/32-508-055) | $50 | $50 | [Image](https://c1.neweggimages.com/ProductImageCompressAll/32-508-055-V01.jpg) |
| ... | ... | ... | ... | ... |
## Tomorrow's Flash Deals (TomorrowItems)
| Item Number | Product Name | Original Price | Flash Deal Price | Image |
|---------|---------|------|-------|------|
| ... | ... | ... | ... | ... |
If promotion information exists, display below the product name:
🎁 Promotion: Free $15 Adidas eGift Card w/ purchase
Edge Cases
- Empty Data: If
TodayItemsorTomorrowItemsis empty or doesn't exist, clearly inform the user - Combo Rows: Skip rows that only have
ComboBaseunless the user specifically requests combo details - HTTP Errors: Report status code and error message
- Invalid JSON: Briefly report parsing failure
Example Request
curl -sS "https://www.newegg.com/api/Common/TomorrowShellShocker"
(-sS keeps output clean but still surfaces curl errors.)
Notes
- This API requires no authentication
- Returned data is in English; product names can be translated if needed
- Prices are in USD
- Image URLs support multiple sizes; default to
ProductImageCompressAllpath
Related skills