1688-product-detail
Extracts comprehensive wholesale product data from 1688.com product detail pages: title, tiered pricing, SKU variants with dimensions/weight, product images, seller info, shop scores, buyer protection, cross-border flags, product attributes, coupon/promotion data, and review stats
Install / Use
npx skills add browser-act/skills --skill 1688-product-detailInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of 1688-product-detail
1688-product-detail scores 96/100 on our quality scale, 231st of 4,698 Development & Engineering skills we index (top 5%).
Its SKILL.md is 13 KB long, well organised into 20 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.
With 6,001 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so 1688-product-detail is actively maintained.
- Our last check on 2026-11-15 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-28. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
1688-product-detail compared with similar skills
All 4 of these similar skills score higher than 1688-product-detail; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| 1688-product-detail (this skill)by browser-act | 96 | 6.0k | 3mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install 1688-product-detail?
- Run
npx skills add browser-act/skills --skill 1688-product-detail. The install tabs above show the steps for each supported agent. - Which AI agents does 1688-product-detail work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is 1688-product-detail safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is 1688-product-detail still maintained?
- The repository was last updated about 3 months ago, so 1688-product-detail is actively maintained.
Skill content
View source on GitHubname: 1688-product-detail description: "Extracts comprehensive wholesale product data from 1688.com product detail pages: title, tiered pricing, SKU variants with dimensions/weight, product images, seller info, shop scores, buyer protection, cross-border flags, product attributes, coupon/promotion data, and review stats. Use when user mentions 1688, 1688.com, wholesale China, alibaba wholesale, B2B China sourcing, Chinese wholesale scraper, 1688 product scrape, 1688 offer, 1688 detail, extract 1688 data, pull 1688 listings, get wholesale price, 1688 supplier info, factory stats 1688, 1688 SKU variants, 1688 product attributes, 1688 shop score, DSR score 1688, 1688 buyer protection, 1688 cross-border, 1688 dropship. Also applies to: scraping bulk product data from 1688 by offer ID list, monitoring 1688 supplier metrics, extracting 1688 pricing tiers for resale analysis."
1688.com — Product Detail Extraction
Navigate to a 1688 product page → extract 50+ fields including pricing tiers, SKU variants, seller stats, attributes, promotions
Language
All process output to user (progress updates, process notifications) follows the user's language.
Objective
Extract complete wholesale product data from a 1688.com offer detail page using embedded page data and network capture for supplier metrics.
Prerequisites
- Target product detail page is open in the browser:
https://detail.1688.com/offer/{offer_id}.html - No login required for product detail pages (data is publicly accessible)
Pre-execution Checks
1. Tool Readiness
If browser-act has been confirmed available in the current session → skip this step.
Invoke browser-act via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.
Capability Components
This Skill's operational boundary = what the user can manually do in their browser. It only reads data already displayed to the user on the page, never bypassing authentication or access controls. JS code is encapsulated in Python files under the
scripts/directory, invoked viaeval "$(python scripts/xxx.py {params})".$(...)is bash syntax; it is recommended to use the bash tool for execution.
DOM: Extract core product data (title, pricing, images, seller, flags)
After navigating to the product page and waiting for page load:
eval "$(python scripts/extract-product-detail.py '{offer_id}')"
Parameters:
- offer_id: Numeric 1688 offer/product ID (e.g.,
927875250705)
Output example:
{
"offerId": "927875250705",
"title": "新款苹果18promax手机壳磁吸...",
"unit": "个",
"category": { "topCategoryId": 7, "postCategoryId": 132918005 },
"pricing": {
"tiers": [
{ "minQty": "30", "price": "7.99" },
{ "minQty": "100", "price": "7.79" }
],
"priceDisplayType": "range",
"minOrderQty": 30,
"currency": "CNY"
},
"sales": {
"totalSold": 308417,
"displaySaleNum": "10万+",
"saleCountLabel": "全网销量"
},
"images": ["https://cbu01.alicdn.com/img/ibank/...jpg"],
"attributes": {
"材质": "优质TPU",
"款式": "后盖款",
"功能": "防震,磁吸,防磨,防摔",
"适用型号": "iPhone17,iphone17pro..."
},
"skuCount": 339,
"skuWeightData": [
{ "weight": 40, "length": 17, "width": 7, "height": 1, "volume": 119 }
],
"seller": {
"companyName": "佛山市南海区三丰手机配件有限公司",
"loginId": "fssf06",
"memberId": "b2b-2850655109d72ea",
"userId": 2850655109,
"shopUrl": "https://shop1460393846166.1688.com",
"cardType": "cjgc",
"isPmPlus": true,
"serviceScore": "4.5分",
"buyerRepeatRate": "65.82%"
},
"offerFlags": {
"isSkuOffer": true,
"isPreSell": false,
"isConsignMarketOffer": true,
"isDistribution": true,
"isChtOffer": true,
"isBuyerProtection": true
},
"crossBorder": {
"foreignLanguagePackageAvailable": true,
"boxMarkAvailable": true,
"fbaLabelAvailable": true
},
"guarantees": ["买家保障", "正品保障"],
"descriptionUrl": "https://detail.1688.com/...",
"offerMemberTags": [4336705, 519170],
"sellerWinportUrlMap": {}
}
DOM: Extract SKU variants (color/model combinations with weight/dimensions)
eval "$(python scripts/extract-sku-details.py '{offer_id}')"
Parameters:
- offer_id: Numeric 1688 offer/product ID
Output example:
{
"offerId": "927875250705",
"skuCount": 339,
"skuRangePrices": [
{ "price": "7.99", "beginAmount": "30" },
{ "price": "7.79", "beginAmount": "100" }
],
"skus": [
{
"skuId": 5833485852524,
"specId": "...",
"attrs": { "颜色": "黑色", "适用型号": "iPhone17" },
"saleCount": 0,
"canBookCount": 9999,
"isPromotionSku": false,
"packInfo": { "weight": 40, "length": 17, "width": 7, "height": 1, "volume": 119 }
}
],
"skuImageMap": {}
}
DOM: Extract coupon and promotion data
eval "$(python scripts/extract-promotions.py '{offer_id}')"
Parameters:
- offer_id: Numeric 1688 offer/product ID
Output example:
{
"offerId": "927875250705",
"coupons": [
{ "couponType": "INTERACT", "couponContent": "满100减5券" }
],
"promotionModel": {
"buttonName": "领券",
"promotionList": [
{
"type": "INTERACT",
"name": "互动优惠券",
"summary": "入会有礼券",
"promotionItems": [
{
"label": "满100减5券",
"availablePeriod": "有效期:2026.05.28 00:00:00-2026.11.24 23:59:59",
"canApply": true
}
]
}
]
},
"activity": {
"activityType": null,
"activityName": null,
"activityUrl": null,
"countdown": null,
"activityId": null
},
"bannerImage": ""
}
DOM: Extract seller params (for shopcard network capture)
eval "$(python scripts/extract-seller-params.py '{offer_id}')"
Parameters:
- offer_id: Numeric 1688 offer/product ID
Output example:
{
"offerId": "927875250705",
"seller": {
"companyName": "佛山市南海区三丰手机配件有限公司",
"loginId": "fssf06",
"memberId": "b2b-2850655109d72ea",
"userId": 2850655109,
"shopUrl": "https://shop1460393846166.1688.com",
"cardType": "cjgc",
"serviceScore": "4.5分",
"buyerRepeatRate3m": "65.82%"
},
"shopcardParams": {
"offerId": "927875250705",
"userId": 0,
"offerMemberTags": [4336705, 519170, "..."],
"sellerUserId": 2850655109,
"sellerMemberId": "b2b-2850655109d72ea",
"topCategoryId": 7,
"offerModelSign": { "isBuyerProtection": true, "isDistribution": true },
"sellerIdentity": "cjgc",
"sellerWinportUrlMap": { "indexUrl": "...", "defaultUrl": "..." },
"winportUrl": "https://shop1460393846166.1688.com"
}
}
Network Capture: Get shop scores and metrics (shopcard API)
The shopcard API uses dynamic sign tokens — let the page JS handle it, read from network traffic.
After the product detail page loads fully (wait stable), the shopcard request fires automatically:
wait stablenetwork requests --type xhr,fetch --filter h5api.m.1688.com- Find request with URL containing
mtop.1688.moga.pc.shopcard network request <id>
Endpoint characteristic: URL contains mtop.1688.moga.pc.shopcard
If the shopcard request is not in traffic (navigated away or cleared), reload the product page:
navigate https://detail.1688.com/offer/{offer_id}.htmlwait stable- Repeat steps 2–4 above
Error handling: If request not found after page reload, check if the product page loaded correctly (screenshot), then retry once. If still unavailable, shopcard data is unavailable for this offer.
Output example:
{
"api": "mtop.1688.moga.pc.shopcard",
"data": {
"model": {
"shopName": "佛山市南海区三丰手机配件有限公司",
"shopType": "cjgc",
"iconType": "cjgc",
"mainCategoryName": "手机配件",
"shopUrl": "https://shop1460393846166.1688.com",
"tpYear": 11,
"shopData": [
{ "dataKey": "店铺回头率", "dataValue": "66%" },
{ "dataKey": "店铺服务分", "dataValue": "4.5", "unit": "分" },
{ "dataKey": "准时发货率", "dataValue": "- %" },
{ "dataKey": "店铺好评率", "dataValue": "99.9%" }
],
"shopButton": {
"fuzzyFavCount": "8.6k粉丝",
"attentionRelation": false
}
}
}
}
Network Capture: Get DSR review summary (queryDsrRateDataV2 API)
After page load, the DSR scores request fires automatically alongside shopcard:
wait stablenetwork requests --type xhr,fetch --filter h5api.m.1688.com- Find request with URL containing
querydsrratedatav2 network request <id>
Endpoint characteristic: URL contains mtoprateservice.querydsrratedatav2
Error handling: Same as shopcard — if not found, navigate to the product page and retry. The DSR API fires with the POST param loginId = seller loginId and offerId; both come from extract-seller-params.py output.
Output example:
{
"data": {
"model": {
"goodRates": 99.9,
"goodsGrade": 5.0,
"fulfillmentDataList": [
{ "name": "商品好评", "value": "100%" },
{ "name": "按时发货" },
{ "name": "商品退款" }
],
"commonTagNodeList": [
{ "name": "全部", "count": 2497 },
{ "name": "有图", "count": 6 },
{ "name": "好评", "count": 2494 }
],
"impressionTagNodeList": [
{ "name": "价格很便宜", "count": 6 },
{ "name": "质量很好", "count": 5 }
]
}
}
}
Composite: Full product data extraction
Combines DOM extraction with network capture for complete data. For each offer ID:
navigate https://detail.1688.com/offer/{offer_id}.htmlwait stableeval "$(python scripts/extract-product-detail.py '{offer_id}')"→ core dataeval "$(python scripts/extract-sku-details.py '{offer_id}')"→ SKU variantseval "$(python scripts/extract-promotions.py '{offer_id}')"→ coupons/activitynetwork requests --type xhr,fetch --filter h5api.m.1688.com→ locate shopcard and DSR requestsnetwork request <shopcard_request_id>→ shop scoresnetwork request <dsr_request_id>→ review stats- Merge all results by offerId
Enum Parameters
shop type [collection failed]: cardType values (e.g., cjgc, cht) come from page data but no separate enumeration API found; values depend on seller registration type
Pagination
Not applicable — this is a single-product detail extraction capability. For bulk processing, see Execution Efficiency below.
Success Criteria
extract-product-detail.py output has no error field AND title is non-null AND pricing.tiers length >= 1
Known Limitations
- Search functionality (
s.1688.com) requires login/CN IP — this Skill covers detail pages only (publicly accessible by offer ID) - Shopcard API (
mtop.1688.moga.pc.shopcard) may return emptyshopDatafor some offer types or if the session has expired; navigate to the product page to refresh productAttributesDOM module has a server-side rendering bug (JSONArray cast error in page metadata) — attributes are extracted from DOM fallback selectors insteadfreightInfo.totalCost(shipping cost) comes from the freight API which requiressendAddressCodeandreceiveAddressCode; defaults to sender's registered address; not included in composite extraction due to address dependency- Review list detail (
queryItemRatedListV2) returns paginated individual reviews but is not included in composite — use the DSR summary instead
Execution Efficiency
- Batch orchestration: Write a bash script to loop through offer IDs serially within a single session; do not parallelize within one browser (prone to triggering anti-scraping restrictions). Add 2–3 second intervals between products. To increase throughput, open multiple stealth browser sessions and distribute offers across them.
- Test before batch execution: After writing a batch script, first test with 1–2 offer IDs to verify script runs correctly; only then run the full batch.
- Reduce redundant pre-operations: When processing multiple offers, keep the session o
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
