Connect Xiaohongshu Store to Your AI Agent

Specify an order time window or SKU ID when asking about shop operations.

36 tools Custom credential

Try a Xiaohongshu Store Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Xiaohongshu Store

Review Shop Orders in a Time Window

Read one page of orders using creation or update time and summarize their returned statuses.

/oo Xiaohongshu Store: List orders using timeType [timeType], startTime [Unix seconds], and endTime [Unix seconds within the allowed window]. Summarize returned statuses.

Inspect SKU Stock

Inspect sellable and occupied stock together with the returned warehouse breakdown.

/oo Xiaohongshu Store: Get stock for SKU [skuId] and explain sellable, occupied, and warehouse quantities returned.

Start Working with Xiaohongshu Store

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Xiaohongshu Store

    Connect with App ID (appId), App Secret (appSecret), Access Token (accessToken).

    Connect Xiaohongshu Store →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • An authorized Xiaohongshu ARK app and shop token; order time windows use Unix seconds.
  • Order responses use milliseconds for returned times. This integration manages shop business data rather than public social-post research.
  • Optionally provide refreshToken to enable token refresh. Order creation-time windows must not exceed 24 hours; update-time windows must not exceed 30 minutes.

Xiaohongshu Store Tools

Read one page of orders using creation or update time and summarize their returned statuses. Inspect sellable and occupied stock together with the returned warehouse breakdown.

Review Shop Orders in a Time Window

List Xiaohongshu orders by creation or update time. startTime and endTime are Unix timestamps in seconds, while the returned order times are in milliseconds. Creation-time windows are limited to 24 hours and update-time windows to 30 minutes.

Inspect SKU Stock

Get the sellable, total, and occupied stock of a Xiaohongshu SKU, including per-warehouse breakdowns.

36 tools

Refresh Token

Refresh the access token using the refresh token stored in the connection credential. Xiaohongshu only issues new tokens when the access token has under 30 minutes left or has expired; otherwise it returns the current ones unchanged. A changed token set must be saved back to the connection, and the old access token stays valid for only 5 more minutes. Access tokens expire after 7 days.

xiaohongshu_store.refresh_token

List Orders

List Xiaohongshu orders by creation or update time. startTime and endTime are Unix timestamps in seconds, while the returned order times are in milliseconds. Creation-time windows are limited to 24 hours and update-time windows to 30 minutes.

xiaohongshu_store.list_orders

Get Order

Get a Xiaohongshu order by its order ID, including SKU, amount, and delivery package details.

xiaohongshu_store.get_order

Get Order Receiver Info

Get receiver addresses for Xiaohongshu orders. Only available while an order is pending shipment; call it right before printing shipping labels.

xiaohongshu_store.get_order_receiver_info

Modify Order Remark

Modify the seller remark and flag of a Xiaohongshu order.

xiaohongshu_store.modify_order_remark

Deliver Order

Ship a Xiaohongshu order with an express tracking number. Supports split shipments by passing the SKU IDs of one package.

xiaohongshu_store.deliver_order

Modify Order Express

Change the express tracking number of a shipped Xiaohongshu order. Only available after shipment and before receipt.

xiaohongshu_store.modify_order_express

Get Order Tracking

Get the logistics tracking records of every package in a Xiaohongshu order.

xiaohongshu_store.get_order_tracking

Get Order Declare Info

Get the customs declaration identity information of a cross-border Xiaohongshu order.

xiaohongshu_store.get_order_declare_info

List Supported Ports

List the customs ports supported by Xiaohongshu for cross-border clearance.

xiaohongshu_store.list_supported_ports

Resend Payment Record

Ask Xiaohongshu to notify the payment company to push the payment record to customs again for a bonded cross-border order.

xiaohongshu_store.resend_payment_record

List After Sales

List Xiaohongshu after-sale records by order or by creation/update time. Pass an order ID, or a time window (24 hours by creation time, 30 minutes by update time).

xiaohongshu_store.list_after_sales

Get After Sale

Get a Xiaohongshu after-sale record by its after-sale ID, including SKUs, amounts, and logistics.

xiaohongshu_store.get_after_sale

Audit After Sale

Audit a Xiaohongshu after-sale request. Only callable while the after-sale is pending seller audit.

xiaohongshu_store.audit_after_sale

Confirm After Sale Receive

Confirm receipt of a buyer-returned package for a Xiaohongshu after-sale. Only callable while the after-sale waits for seller receipt.

xiaohongshu_store.confirm_after_sale_receive

Ship After Sale Exchange

Confirm receipt of the returned package and report the exchange shipment tracking number for a Xiaohongshu exchange after-sale.

xiaohongshu_store.ship_after_sale_exchange

List After Sale Reject Reasons

List the reject reason options available when auditing or confirming receipt of a Xiaohongshu after-sale.

xiaohongshu_store.list_after_sale_reject_reasons

List Items

List Xiaohongshu items with basic fields using ID, time, stock, barcode, or availability filters.

xiaohongshu_store.list_items

Search Items

Search Xiaohongshu items with full publish fields using keywords, item codes, or availability filters.

xiaohongshu_store.search_items

Get Item

Get a Xiaohongshu item by its item ID, including its SKU list.

xiaohongshu_store.get_item

Set Sku Availability

List or delist a Xiaohongshu SKU.

xiaohongshu_store.set_sku_availability

Get Sku Stock

Get the sellable, total, and occupied stock of a Xiaohongshu SKU, including per-warehouse breakdowns.

xiaohongshu_store.get_sku_stock

Sync Sku Stock

Set the total stock of a Xiaohongshu SKU. Xiaohongshu derives the sellable stock from the difference with occupied and channel stock.

xiaohongshu_store.sync_sku_stock

Adjust Sku Stock

Increase or decrease the sellable stock of a Xiaohongshu SKU.

xiaohongshu_store.adjust_sku_stock

List Categories

List the Xiaohongshu item categories under a parent category, or the top-level categories.

xiaohongshu_store.list_categories

Get Category Attributes

Get the attributes and validation rules of a leaf Xiaohongshu category.

xiaohongshu_store.get_category_attributes

List Express Companies

List the express companies supported by Xiaohongshu for order shipment.

xiaohongshu_store.list_express_companies

List Item Skus

List Xiaohongshu items together with their full SKU details such as price, stock, and logistics plan.

xiaohongshu_store.list_item_skus

Create Item

Create a Xiaohongshu item with its SKUs after resolving its category, attributes, brand, freight template, logistics plan, and material URLs.

xiaohongshu_store.create_item

Update Item

Update a Xiaohongshu item and its SKU collection, including adding and removing SKUs.

xiaohongshu_store.update_item

Upload Material

Upload an image or video to the Xiaohongshu material center and return its URL for item media fields.

xiaohongshu_store.upload_material

List Materials

List and filter files in the Xiaohongshu material center.

xiaohongshu_store.list_materials

Search Brands

Search the brands available for a leaf Xiaohongshu category.

xiaohongshu_store.search_brands

List Carriage Templates

List the freight templates configured for the Xiaohongshu shop.

xiaohongshu_store.list_carriage_templates

List Logistics Plans

List shop logistics plans whose IDs can be assigned to item SKUs.

xiaohongshu_store.list_logistics_plans

List Address Records

List shop address records, including return addresses used when accepting after-sale returns.

xiaohongshu_store.list_address_records

Frequently Asked Questions

What can AI help me do with Xiaohongshu Store?

Review Xiaohongshu shop orders by time window and inspect SKU stock before planning operations.

What should I know before using Xiaohongshu Store results?

Order responses use milliseconds for returned times. This integration manages shop business data rather than public social-post research.

What do I need to connect Xiaohongshu Store?

Provide your ARK appId, appSecret, and authorized shop accessToken. You can also supply refreshToken for token refresh.

Connect Xiaohongshu Store

About Xiaohongshu Store ↗