1688-marketing-skill

Use the EnrollmentClient with your 1688 API credentials and call submit_enrollment with the activity ID, product IDs, shop ID, and contact details. The response returns an enrollment ID you can poll with check_enrollment_status to track review progress.

Call get_suggested_price on the PricingClient with a product ID to receive a recommended price range, market average, and competitor count. For multiple products, batch_get_suggested_prices processes a list of product IDs in one operation.

You need an app key, app secret, and access token from the 1688 open platform, set as the ALIBABA_1688_APP_KEY, ALIBABA_1688_APP_SECRET, and ALIBABA_1688_ACCESS_TOKEN environment variables. Requests target the gw.open.1688.com API base URL.

Authentication failures usually mean an expired or invalid access token. Verify credentials with the verify_credentials helper, then regenerate the token using refresh_access_token with your app key and secret before retrying the request.

Catch QuotaExceededError to read the quota reset time, then retry with exponential backoff. A RateLimiter utility caps requests per time window, and batching operations like batch price queries reduces total API call volume.