pricing-app-ml-integration

Automate MercadoLibre API integration with OAuth, webhooks, and batch item sync.

1|2|Updated Oct 1, 2025
One-click install
npx skills add https://github.com/sernafernando/pricing-app --skill pricing-app-ml-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pricing-app-ml-integration
Source: https://github.com/sernafernando/pricing-app/tree/main/skills/pricing-app-ml-integration
Command: npx skills add https://github.com/sernafernando/pricing-app --skill pricing-app-ml-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides robust MercadoLibre API integration patterns to handle OAuth flows, webhook processing, item synchronization, and order tracking for pricing apps.

Core Features & Use Cases

  • OAuth & Token Management: Manage access tokens securely with automatic refresh and expiry handling.
  • Webhook Processing: Validate and process MercadoLibre webhooks asynchronously using background tasks.
  • Batch Item Synchronization: Fetch and sync items in batches (max 20 per request) to minimize API calls.
  • Unified API Patterns: Apply consistent patterns for GET, PUT, and batch endpoints across MercadoLibre.

Quick Start

Set up the MercadoLibre integration by configuring environment variables (ML_CLIENT_ID, ML_CLIENT_SECRET, ML_REFRESH_TOKEN, ML_USER_ID) and running the backend service. Ensure the webhook endpoint is reachable and that background tasks are enabled for processing events.

Frequently Asked Questions about pricing-app-ml-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle OAuth token refresh for MercadoLibre API integration?

MercadoLibre API integration handles OAuth token refresh by securely managing access tokens with automatic refresh and expiry handling. This ensures continuous backend service operation without manual token updates.

How do I process MercadoLibre webhooks asynchronously in a backend service?

MercadoLibre webhook processing is handled asynchronously using background tasks. The backend service validates and processes incoming webhook events in the background, ensuring endpoint responsiveness and safe error handling.

What is the maximum batch size for item synchronization with the MercadoLibre API?

MercadoLibre API batch item synchronization supports a maximum of 20 items per request. Fetching and syncing items in these batches minimizes API calls and optimizes backend throughput.

Can I use httpx for asynchronous HTTP calls when integrating with MercadoLibre?

Yes, MercadoLibre integration supports asynchronous HTTP calls with httpx. This allows the backend service to manage token refresh handling, batch endpoints, and background webhook processing concurrently.

What environment variables do I need to set up MercadoLibre integration for a pricing app?

MercadoLibre integration requires configuring ML_CLIENT_ID, ML_CLIENT_SECRET, ML_REFRESH_TOKEN, and ML_USER_ID environment variables. The webhook endpoint must be reachable and background tasks enabled for event processing.

Why does MercadoLibre API integration require background tasks for webhook processing?

Background tasks are required for MercadoLibre webhook processing to validate and process events asynchronously. This prevents blocking the main backend service thread and ensures safe error handling during event-driven syncing.