get_items
Look up 1–10 Amazon ASINs to get product data: price, ratings, offers, and images. Output as JSON, markdown, or embeddable HTML cards for your content.
Instructions
Look up 1–10 ASINs on Amazon. IMPORTANT: the returned items array is NOT guaranteed to be in the same order as the input asins array — always match items to inputs by the asin field, not by index. Invalid or inaccessible ASINs appear in a separate errors array rather than in items — check both.
PRESENTATION GUIDANCE (important): default to format: 'markdown' or format: 'json'. After the tool returns, summarise conversationally (e.g. "Here's what I found for those 3 ASINs: • Echo Show 5 ($79.99) • Kindle Paperwhite ($139.99) …") — DO NOT paste the raw tool output. Then ASK the user whether they'd like an embeddable HTML card/grid before calling the tool again with an HTML format. Only use format: 'html-card' or format: 'html-grid' when the user has explicitly asked for a preview, card, widget, embed, or paste-ready HTML.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asins | Yes | 1–10 Amazon ASINs. | |
| format | No | Output format. DEFAULT TO 'markdown' OR 'json' when you plan to summarise the results in chat. Use 'html-card' / 'html-grid' ONLY when the user has explicitly asked for an embed, preview, card, widget, grid, or paste-ready HTML — these formats return a full HTML document the user pastes into their blog and are not for in-chat reading. 'markdown' = friendly summary source; 'json' = raw API data for programmatic use; 'html-card' = single product card; 'html-grid' = responsive grid of all items. | markdown |
| merchant | No | ||
| condition | No | ||
| resources | No | Which fields Amazon should return. Names are camelCase (e.g. "itemInfo.title"). Omit to use a sensible default set. | |
| offerCount | No | How many offers per item (max 10). | |
| customStyles | No | Extra CSS appended to the default stylesheet when format is 'html-card' or 'html-grid'. Target stable class-name anchors: .amzn-card, .amzn-card__image, .amzn-card__title, .amzn-card__meta, .amzn-card__brand, .amzn-card__rating, .amzn-card__price, .amzn-card__price--unavailable, .amzn-card__savings, .amzn-card__cta, .amzn-card__disclosure, .amzn-grid. Ignored for 'markdown' and 'json'. | |
| titleMaxChars | No | Maximum rendered title length for HTML card/grid output. Amazon titles are often 150+ chars of keyword stuffing; clamping to ~80 keeps cards one-line on typical widths. Defaults to 80. Set to 0 to disable. Ignored by 'markdown' and 'json' — those formats get the full untruncated title. | |
| hideItemsWithoutPrice | No | When format is 'html-grid', drop items that have no price. Defaults to true — cards without a price are weak embeds (no deal hook, reader must click through to learn anything). Set false for comparison tables where availability can lapse but you still want the product visible. Ignored for 'html-card', 'markdown', and 'json'. | |
| languagesOfPreference | No |