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}/p calls 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
  • simulation POST 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

Workflow

Installs
2
Repository
decocms/blocks
GitHub Stars
5
First Seen
Mar 11, 2026
deco-api-call-dedup — decocms/blocks