deco-api-call-dedup
Installation
SKILL.md
API Call Deduplication & N+1 Detection
Finds and fixes N+1 / duplicate VTEX (and Shopify) API call patterns in Deco storefront section loaders — the #1 cause of slow SSR on e-commerce sites. These patterns reduced PDP API calls from 40+ to ~8 and PLP spurious calls from 15+ to near-zero on espacosmart-storefront.
When to Use This Skill
- Page loads are slow (SSR > 3s)
- Terminal logs show many sequential/parallel calls to the same endpoint, or duplicate
search/{slug}/pcalls for the same product - VTEX returns 429 (Too Many Requests) errors
- Cross-selling endpoints (
similars,suggestions,showtogether) are called multiple times with the same ID simulationPOST is called once per product instead of batched- PDP/PLP page load triggers 20+ VTEX API calls
- HAR analysis shows a waterfall of sequential API calls
[CMS] Unhandled resolver: site/loaders/...warnings appear- User reports "a troca de pagina ta demorando"
- After migrating loaders or adding new shelf/search sections