marketplace-integration-helper_skill

Overview

This skill generates production-ready boilerplate for e-commerce marketplace integrations. It scaffolds API clients, rate limiting and retry logic, webhook verification and routing, and basic product/order sync handlers for Shopify, WooCommerce, Bol.com, and Etsy. Use it to accelerate building reliable marketplace connectors.

How this skill works

The skill creates a BaseMarketplaceClient with configurable rate limits, retry/exponential backoff, and a queued request processor to respect platform limits. It produces platform-specific clients (Shopify, WooCommerce, Bol.com, Etsy) that implement auth headers and common product/order methods. It also scaffolds webhook verification, a lightweight router, Next.js API route examples, and idempotent handlers that persist orders and updates to a local store.

When to use it

• You need a starting point for Shopify or WooCommerce API integration
• You must implement webhook verification and secure routing for marketplace events
• You want rate-limited, retryable API clients to avoid 429s and transient failures
• You are building product or order synchronization between marketplaces and a local database
• You need idempotent webhook handlers and example Next.js routes

Best practices

• Identify target marketplace first and apply the platform-specific auth flow (OAuth, API keys, or OAuth2).
• Configure rate limits per platform and prefer small batches with backoff on 429 responses.
• Implement idempotency for webhook handlers to avoid duplicate records from retries.
• Store secrets and webhook signing keys in environment variables or a secrets manager, never in source control.
• Add robust logging and metrics around retries, rate-limit hits, and webhook processing failures.

Example use cases

• Sync product catalog from Shopify to a central inventory service and push stock updates back to Shopify and WooCommerce.
• Implement webhook handlers to create local orders from Shopify order created events with idempotency checks.
• Create a rate-limited Bol.com client for periodic product pushes and order polling using OAuth2 client credentials.
• Build Next.js API routes that verify webhook signatures, route topics to registered handlers, and produce safe 401/500 responses on failure.