macys-researchlisted
Install: claude install-skill Crawlora-org/crawlora-skills
# Macy's research
Look up a specific Macy's product's detail and reviews by its numeric
productId, and pull Macy's own typeahead suggestions — all as normalized
JSON from the Crawlora API, with no HTML scraping. This skill does not
cover search or category browsing; it only works from a known productId.
## When to use this skill
- "What does this Macy's product cost / what's in the description?" given
a macys.com product URL or its `?ID=` value.
- "Pull the reviews and rating summary for this Macy's product."
- "What does Macy's autocomplete suggest for [query]?" to discover related
search terms.
- "Summarize this Macy's item's colors, pricing, and customer sentiment"
for a known product.
## Setup (one-time)
- Get a free Crawlora API key (2,000 credits/mo, no card) at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).
- Set `CRAWLORA_API_KEY` in the environment before running the helper.
- The helper reads `CRAWLORA_API_KEY` from the environment and sends requests to `https://api.crawlora.net/api/v1`. Missing/invalid key → `401`.
## How it works
1. **Get a productId** — a numeric id taken from a macys.com product page's
`?ID=` query parameter (or otherwise already known/discovered). There is
no search or category endpoint in this skill to find one from a keyword.
2. **Detail** — `/macys/product/{productId}` returns full product content:
name, brand, description, department/division, category b