shopee-connector

Connects to Shopee Open Platform API v2 to read orders, products, analytics, and update listings.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill shopee-connector-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shopee-connector
Source: https://github.com/tapway/shogun-os/tree/main/skills/retail/shopee-connector
Command: npx skills add https://github.com/tapway/shogun-os --skill shopee-connector-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Managing a Shopee store programmatically requires handling HMAC-SHA256 request signing, OAuth tokens, and region-specific endpoints, which is error-prone to implement from scratch. This Skill provides a ready-made Python adapter for the Shopee Open Platform API v2 so agents can read orders, manage listings, and pull analytics without writing integration code. ## Core Features & Use Cases - Order Management: Retrieve orders filtered by status (e.g., READY_TO_SHIP) or creation date for fulfillment workflows. - Listing Updates: Update product price, stock, and descriptions, including per-variation updates, via a single method call. - Analytics & Returns: Pull shop performance data by period and read return/refund requests for customer service operations. - Use Case: A retail operations agent runs python shopee_connector.py orders READY_TO_SHIP each morning to list all orders awaiting shipment, then updates stock levels after fulfillment using the update command. ## Quick Start Set the SHOPEE_PARTNER_ID, SHOPEE_API_KEY, SHOPEE_ACCESS_TOKEN, and SHOPEE_SHOP_ID environment variables, then ask the agent to test the Shopee connection and list all ready-to-ship orders.

Frequently Asked Questions about shopee-connector

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

FAQPage Schema
How do I connect to the Shopee Open Platform API in Python?

Create a ShopeeAdapter with your partner ID, API key, access token, and shop ID, then call connect() to verify access by fetching shop info. Credentials can also be supplied through the SHOPEE_PARTNER_ID, SHOPEE_API_KEY, SHOPEE_ACCESS_TOKEN, and SHOPEE_SHOP_ID environment variables.

How do I read Shopee orders by status or date?

Call read_orders with a status filter such as READY_TO_SHIP, SHIPPED, COMPLETED, or CANCELLED, and optionally a since date in YYYY-MM-DD format. From the CLI, run python shopee_connector.py orders READY_TO_SHIP 2025-06-01.

Does the Shopee connector require external Python packages?

No external packages are required. The connector uses only the Python standard library (urllib.request, hmac, hashlib) for HTTP requests and HMAC-SHA256 signing, and works with Python 3.8 or later.

Which Shopee regions are supported by the API connector?

Twelve regions are supported: Thailand, Singapore, Malaysia, Indonesia, Philippines, Vietnam, Taiwan, Brazil, Mexico, Colombia, Chile, and Poland. Pass the two-letter region code (e.g., my, sg, br) when creating the adapter.

Why am I getting 401 Unauthorized errors from the Shopee API?

A 401 error usually means the access token has expired, since Shopee tokens last roughly four hours. Refresh the token via the OAuth flow and confirm SHOPEE_API_KEY matches the partner key, as a mismatch also causes signature failures.

When should I not use the Shopee connector?

Do not use it for other marketplaces such as Lazada or TikTok Shop, which need their own connectors. Also avoid bulk operations without rate-limit handling, because Shopee throttles API calls aggressively and requires retry with backoff.