1688 Product Upload Assistant

The Pain Point of Bulk Listing on 1688

For merchants operating on the 1688 platform, especially those sourcing products from suppliers, manually uploading numerous product listings to their own store is a time-consuming and error-prone process. This involves repetitive tasks like copying and pasting, verifying link validity, and configuring identical shipping addresses and freight templates. The 1688 Product Upload Assistant is designed to solve this specific problem: automating the bulk identification of product links and orchestrating the listing process from link validation to product information submission via platform APIs.

How the Skill Works: From Link to Listed

The skill is built around a conversational interface, leveraging a series of backend MCP (Model Context Protocol) tool calls for automation. Its workflow is structured into several key phases:

Intelligent Authorization & Account Management

The primary prerequisite for operation is authorization. The skill employs sToken for authentication, following a strict security flow:
- Token Validation: The token must adhere to the regex rule ^st[a-zA-Z0-9]{32}$ to ensure its validity.
- Persistent Storage: Upon successful authorization, the sToken and its associated username are securely stored in a local sTokens.json file.
- Multi-Account Switching: It supports managing multiple 1688 accounts. Before execution, users can specify which account to use via the keyword 查看登录账号 (View Logged-in Account) or during an interactive selection step. All operations explicitly target the selected account via the --account parameter.

Product Link Identification & Validation

Users simply need to paste one or more product links. The skill will automatically:
1. Extract URLs: Use regex to identify all links starting with http:// or https://.
2. Invoke Identification API: Batch-validate the links using the url_identify MCP tool.
3. Segment Results: Display the links split into two lists: ‘Valid Links’ and ‘Invalid Links’. The process only proceeds if at least one valid link is identified.

Configurable Listing Template Setup

Before submitting the task, the skill fetches the account’s current listing template (get_copy_rule_config) and clearly displays 5 core settings:
- Product Type: Spot Goods (copyWay=0) or Factory Goods (copyWay=1)
- Listing Status: On Sale, Draft, or Pending Listing
- Shipping Address: Selected from the account’s address library
- Freight Setting: Supports guide templates, standard templates, freight instructions, or seller-paid
- Price Type: Original Price or Promotional Price, with optional multiplication rules

If any setting is empty, the user is guided through each configuration step. The configured template is saved for future reuse, ensuring accuracy and consistency in listing information.

Batch Execution & Status Feedback

After template confirmation, the skill calls the copy_by_agent interface to submit the batch listing task. It constructs the request parameters using the successful link information (including productId, offerSource, etc.) identified in the previous phase. Upon successful submission, it attempts to retrieve a listing record URL and provides it to the user for tracking progress in the 1688 backend.

Applicable Boundaries & Key Considerations

• Environment Dependency: The skill requires access to the specified MCP service endpoints and correctly configured authorization credentials in sTokens.json. Network issues or invalid credentials will halt the process.
• Link Type Restriction: It only supports standard HTTP/HTTPS links. Non-standard formats or links with complex parameters may fail to be extracted correctly.
• Platform Specificity: This tool is designed exclusively for the 1688 platform. Its API interactions and business logic are based on 1688’s rules and are not applicable to other e-commerce platforms.
• Operational Risk: The one-click listing function directly impacts the store’s inventory. Please verify all template settings and link content for accuracy before execution. It is recommended to familiarize yourself with the workflow in a test environment first.