ecommerce-1688-product-detail
Use this skill to query 1688 public product details. Read references/api.md before constructing a request.
Request contract
- Endpoint:
POST /api/v1/tools/research/alibaba1688/productDetail
- Required:
offerId (positive integer string).
- Optional:
currency (three-letter code); omit compatibility-only country.
- Send only documented fields; reject unknown fields before network access.
Minimal example:
{"offerId":"1040473674152"}
Workflow
- Confirm the requested public entity, market, operation, filters, and expected cost.
- Validate parameters against the API reference. Send only documented business fields.
- Run
python scripts/alibaba1688_product_detail.py '<JSON parameters>' --no-cache once. Do not probe alternate products, markets, pages, or operations after a paid failure without user approval.
- Preserve the full response file. Distinguish the Nexscope transport envelope from the inner business response and report
traceId on errors.
- Summarize only returned facts. Preserve missing values as unknown and identify the requested market and operation.
Cost
Do not reuse the source Skill's point value. This operation consumes Nexscope credits. Preserve X-Cost-Token and X-Cost-Credit from the response headers as server-reported billing metadata. The exact charge is unknown before the first live response.
Error and credit handling
- HTTP 401 means Nexscope authentication failed. Verify
NEXSCOPE_API_KEY and NEXSCOPE_PROXY_BASE; do not ask the user to paste credentials into chat or operation JSON.
- HTTP 402 means the account lacks credits. Stop the workflow and direct the user to the access-help page below.
- Marketplace authorization failures require the platform-specific account or token to be renewed. Do not substitute a different store, region, or creator automatically.
- For ambiguous network failures, report whether the attempted operation was a read or mutation. Never repeat a mutation without reconciling its upstream state.
Response handling
For the research HTTP response, require a numeric outer code equal to 0 before using data. Nonzero codes are platform failures; display outer msg without interpreting its wording as a retry instruction. Nexscope preserves upstream messages and translates Chinese to English; successful responses may have msg: null. HTTP 200 alone and nested business code / status do not replace the platform check. See references/api.md for response paths and task-specific states.
Package scripts that unwrap the response keep the platform code and msg under _nexscope; their remaining fields are the business payload. _nexscope.cost is elapsed time, not credits.
Authentication
Set the NEXSCOPE_API_KEY environment variable. For authentication and credits guidance, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS.
Presenting results
- Lead with the requested entity, market, operation, and the most decision-relevant returned fields.
- Preserve source currencies, units, identifiers, dates, and missing values; do not invent conversions or defaults.
- Keep the full JSON artifact and present compact tables for repeated records when useful.
- Report server-provided
X-Cost-Token, X-Cost-Credit, and trace ID when present; do not infer credits from elapsed time.
Boundaries and privacy
- This migration is public-data and read-only. Do not invoke seller-console, store-authorized, favorite-write, or account mutation operations.
- One explicit request per call. Do not silently change entity, market, date, operation, or page after an error.
- Redact credentials, signed URLs, cookies, and internal account identifiers from user-facing output and saved request examples.
- Do not claim live, ZIP-install, or production validation unless the matching evidence exists in
references/testing.md.
References
- Read references/api.md for the complete parameter, response, and error contract.
- Read references/testing.md before executing a live request or claiming a validation level.
User-facing language
Use English for all user-facing explanations, examples, confirmations, results and error guidance. Translate provider-localized product titles, descriptions and business messages into English for presentation. Preserve identifiers, monetary values, units, URLs and original source data in saved artifacts. Keep official buyer, recipient, address and invoice details unchanged in API payloads; do not translate legal names or address records just to change their display language.
API Key request rate
All Nexscope API Keys belonging to the same user share one request-rate allowance for public API execution. The allowance is measured over any rolling 1-second window. Your RPS depends on your account entitlements; do not assume every user has a fixed 1 RPS. A single Skill operation may make multiple public API requests, and each request uses this allowance.
If an execution request returns HTTP 429 with outer code 13012, the request-rate allowance was exceeded. Honor the returned Retry-After before considering another request. Outer code 13013 means the concurrent-request limit was exceeded, not the rate limit; honor its Retry-After when supplied. Inspect the response and reconcile state before retrying. Never automatically replay a write operation or a request whose outcome is unclear.
1---2name: ecommerce-1688-product-detail3description: Query 1688 public product details through the Nexscope research proxy. Use when the user requests this public marketplace or patent data; do not use for seller-console or store-authorized operations.4metadata:5 source: https://skillmd.com/skills/nexscope-ai/ecommerce-1688-product-detail6---78# ecommerce-1688-product-detail910Use this skill to query 1688 public product details. Read [references/api.md](references/api.md) before constructing a request.111213## Request contract1415- Endpoint: `POST /api/v1/tools/research/alibaba1688/productDetail`16- Required: `offerId` (positive integer string).17- Optional: `currency` (three-letter code); omit compatibility-only `country`.18- Send only documented fields; reject unknown fields before network access.1920Minimal example:2122```json23{"offerId":"1040473674152"}24```2526## Workflow27281. Confirm the requested public entity, market, operation, filters, and expected cost.292. Validate parameters against the API reference. Send only documented business fields.303. Run `python scripts/alibaba1688_product_detail.py '<JSON parameters>' --no-cache` once. Do not probe alternate products, markets, pages, or operations after a paid failure without user approval.314. Preserve the full response file. Distinguish the Nexscope transport envelope from the inner business response and report `traceId` on errors.325. Summarize only returned facts. Preserve missing values as unknown and identify the requested market and operation.3334## Cost3536Do not reuse the source Skill's point value. This operation consumes Nexscope credits. Preserve `X-Cost-Token` and `X-Cost-Credit` from the response headers as server-reported billing metadata. The exact charge is unknown before the first live response.3738## Error and credit handling3940- HTTP 401 means Nexscope authentication failed. Verify `NEXSCOPE_API_KEY` and `NEXSCOPE_PROXY_BASE`; do not ask the user to paste credentials into chat or operation JSON.41- HTTP 402 means the account lacks credits. Stop the workflow and direct the user to the access-help page below.42- Marketplace authorization failures require the platform-specific account or token to be renewed. Do not substitute a different store, region, or creator automatically.43- For ambiguous network failures, report whether the attempted operation was a read or mutation. Never repeat a mutation without reconciling its upstream state.4445## Response handling4647For the research HTTP response, require a numeric outer `code` equal to `0` before using `data`. Nonzero codes are platform failures; display outer `msg` without interpreting its wording as a retry instruction. Nexscope preserves upstream messages and translates Chinese to English; successful responses may have `msg: null`. HTTP 200 alone and nested business `code` / `status` do not replace the platform check. See `references/api.md` for response paths and task-specific states.4849Package scripts that unwrap the response keep the platform `code` and `msg` under `_nexscope`; their remaining fields are the business payload. `_nexscope.cost` is elapsed time, not credits.5051## Authentication5253Set the `NEXSCOPE_API_KEY` environment variable. For authentication and credits guidance, visit [https://www.nexscope.ai/help/skills-external-access?co-from=skillNS](https://www.nexscope.ai/help/skills-external-access?co-from=skillNS).5455## Presenting results5657- Lead with the requested entity, market, operation, and the most decision-relevant returned fields.58- Preserve source currencies, units, identifiers, dates, and missing values; do not invent conversions or defaults.59- Keep the full JSON artifact and present compact tables for repeated records when useful.60- Report server-provided `X-Cost-Token`, `X-Cost-Credit`, and trace ID when present; do not infer credits from elapsed time.6162## Boundaries and privacy6364- This migration is public-data and read-only. Do not invoke seller-console, store-authorized, favorite-write, or account mutation operations.65- One explicit request per call. Do not silently change entity, market, date, operation, or page after an error.66- Redact credentials, signed URLs, cookies, and internal account identifiers from user-facing output and saved request examples.67- Do not claim live, ZIP-install, or production validation unless the matching evidence exists in `references/testing.md`.6869## References7071- Read [references/api.md](references/api.md) for the complete parameter, response, and error contract.72- Read [references/testing.md](references/testing.md) before executing a live request or claiming a validation level.7374## User-facing language7576Use English for all user-facing explanations, examples, confirmations, results and error guidance. Translate provider-localized product titles, descriptions and business messages into English for presentation. Preserve identifiers, monetary values, units, URLs and original source data in saved artifacts. Keep official buyer, recipient, address and invoice details unchanged in API payloads; do not translate legal names or address records just to change their display language.7778## API Key request rate7980All Nexscope API Keys belonging to the same user share one request-rate allowance for public API execution. The allowance is measured over any rolling 1-second window. Your RPS depends on your account entitlements; do not assume every user has a fixed 1 RPS. A single Skill operation may make multiple public API requests, and each request uses this allowance.8182If an execution request returns HTTP 429 with outer code `13012`, the request-rate allowance was exceeded. Honor the returned `Retry-After` before considering another request. Outer code `13013` means the concurrent-request limit was exceeded, not the rate limit; honor its `Retry-After` when supplied. Inspect the response and reconcile state before retrying. Never automatically replay a write operation or a request whose outcome is unclear.