Get the OAuth URL the seller opens to grant this app access.

Send the returned URL to the seller. After they approve, the platform redirects to the app's configured callback with a ?code=...; pass that code to alibaba_complete_authorization.

Exchange an OAuth code (from the callback) for an access token and store it.

Complete authorization from the full callback URL the seller landed on.

Handy when the callback is a page like https://www.alibaba.com — paste the whole redirected address (containing ?code=...) and this extracts the code and exchanges it for a token.

Show whether a seller is authorized and when the token expires.

Call any granted API by method name (e.g. alibaba.icbu.product.get).

Escape hatch for testing/verifying methods. It can invoke write APIs, so it is not read-only. Set authorized=False for system/public APIs that need no token.

Inspect a local image or video (type, size, and image dimensions).

The path is confined to the server's allowed directories.

Read prices from a local CSV or JSON file into normalized rows.

The path is confined to the server's allowed directories.

Upload one local image to the photo bank; returns {file_id, url}. The path is confined to the server's allowed directories.

Get the publish schema for a category: fillable fields, types, required flags, and allowed options. Inspect this before publishing.

Get a category's system-defined attributes (for icbuCatProp), including which are required. Public API — no authorization needed. Each attribute's attr_id maps to the publish schema field p-<attr_id>; car_model attributes need the hierarchical-attribute API for their next level.

Publish a product from a manifest file (product.json), creating a new product.

The manifest gives category_id, language, fields, and asset references (main_images/detail_images, price_file, video). Required category attributes (icbuCatProp) are auto-filled from the manifest's product_attributes (keyed by attribute name or id) using the schema's own options/required rules. Set draft=True to create a draft (not listed live) — recommended for verifying a manifest. missing_required in the result lists required attributes still unfilled (a real publish needs them). The manifest and its assets are confined to the server's allowed directories.

Publish a product from a minimal brief — the seller provides only facts; Claude enriches the rest.

Provide brief inline or a brief_path (JSON file, confined to allowed dirs). The brief needs: brief (short description), category_id, images (main 4–6 + detail), price ({unit, moq, tiers}), and facts (place_of_origin, material). Claude writes the title, highlights, detail modules, FAQs, custom parameters, and picks the descriptive category attributes from the schema's allowed options. Returns the draft product_id, missing_required, ai_filled (what was auto-generated), and warnings (e.g. fewer than 4 main images — AI cannot generate real product photos). Defaults to draft=True.

Read back a DRAFT product's saved fields (schema.render.draft). product_id is the plaintext numeric draft id. Useful to verify what a publish stored.

Incrementally update an existing product (schema.update) from a manifest.

Only the fields present in the manifest are changed. Re-applying the same manifest yields the same state (idempotent). Paths are confined to the server's allowed directories.

Get a product group's info (name, parents, child groups). Pass group_id=-1 (default) to list all top-level groups (returned under children).

Associate a video with a product. target: "main" (main-image video) or "detail" (detail video). Numeric ids are auto-converted to the encrypted ids the API needs. Re-relating the same pair is idempotent.

List product ids related to a video. type: "videoId" (main) or "detailVideoId" (detail).

Query the seller's videos (to find video ids). Requires paging params, e.g. params={"current_page": "1", "page_size": "20"}; each item has a video_id.

Generate a structured product detail with Claude (title, highlights, ordered image+text modules, attributes, keywords, FAQs).

The title is normalized to Alibaba title case; pass brands (e.g. ["C01B"]) to preserve casing. version ∈ premium (全能精装版) | lite (经济简装版) | general (通用排版). If save_to is given, the content is written there as JSON (confined to the server's allowed directories). Token usage is recorded (see usage_stats).

Generate platform-tailored social posts for a product with Claude.

Token usage is recorded automatically (see usage_stats). platforms e.g. ["linkedin", "instagram", "x", "facebook", "tiktok", "pinterest"].

Report AI token usage and estimated USD cost (from the local usage log).

Filter by model/label/since_iso (ISO-8601). group_by ∈ day|model|label.