본문으로 건너뛰기
cccskills
무료GitHub에 공개

ecommerce.1688-product-billboard

Query 1688 product bestseller billboard data for sourcing discovery and wholesale product research. Trigger when the user mentions 1688 product rankings, 1688 bestseller lists, wholesale hot products, domestic sourcing rankings, dropshipping product selection, 1688 trending products, bulk purchase popular items, supplier product rankings, 1688 billboard, 1688 bestsellers, sourcing rankings, wholesale hot products, trending product rankings, supplier rankings, 1688 trends. Even if the user does not explicitly mention "1688 billboard", if their need involves discovering hot-selling wholesale products or sourcing opportunities on the 1688 platform, this skill should also be triggered.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(4)

  • SKILL.md9.6 KB
  • manifest.json295 B
  • references/api.md8.0 KB
  • scripts/1688_product_billboard.py6.6 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

DLD Product Billboard (1688 Bestseller Rankings)

This skill guides you on how to query 1688 platform product bestseller billboard data, helping sellers discover hot-selling wholesale products and sourcing opportunities on China's largest B2B marketplace.

Core Concepts

The DLD Product Billboard provides access to 1688 platform's product ranking data, covering both weekly and monthly bestseller lists. It enables users to discover trending wholesale products, compare suppliers, and identify sourcing opportunities in the domestic Chinese wholesale market.

Billboard types:

  • Weekly Billboard (pageType=2): Date parameter should be the Sunday of the target week (e.g., 2025-06-15). Data available for the last 90 days.
  • Monthly Billboard (pageType=3): Date parameter should be the first day of the target month (e.g., 2025-06-01). Data available for the last 12 months.

Default behavior: Monthly billboard, sorted by order count descending, 20 results per page.

Parameter Guide

Core Parameters

ParameterTypeRequiredDefaultDescription
keyWordstringNo—Product search keyword (must be in Chinese; translate first if not)
datestringNo—Query date. Weekly: Sunday date (e.g., 2025-06-15); Monthly: first of month (e.g., 2025-06-01)
pageTypeintegerNo3Billboard type: 2 = weekly, 3 = monthly
pageIndexintegerNo1Page number (starts from 1)
pageSizeintegerNo20Results per page (10-100)

Sorting

ParameterTypeDefaultDescription
sortFieldstringorderCountSort field: orderCount (orders), saleCount (units sold), saleVolume (est. revenue), offerCreateTime (listing date), price (wholesale price), consignPrice (dropship price)
sortTypestringdescSort order: desc (descending), asc (ascending)

Price & Volume Filters

ParameterTypeDescription
beginPrice / endPricenumberWholesale price range
beginConsignPrice / endConsignPricenumberDropship price range
beginOrderCount / endOrderCountintegerOrder count range
beginSaleCount / endSaleCountintegerUnits sold range
beginSaleVolume / endSaleVolumenumberEstimated revenue range
beginStartQuantity / endStartQuantityintegerMinimum order quantity range

Product & Seller Filters

ParameterTypeDescription
searchTypeintegerKeyword match mode: 1 = fuzzy (default), 3 = exact
offerTypeintegerProduct tag: 0 = any, 2 = new product, 3 = 1688 Select, 4 = cross-border, 5 = customizable, 6 = store treasure
companyTypeintegerCompany type: 0 = any, 1 = store, 2 = factory
shiLiTypestringSeller tier (comma-separated): superFactory, Power, TrustPass
beginTpYear / endTpYearintegerTrustPass membership years range

Logistics & Service Filters

ParameterTypeDescription
sendTimestringShipping time in hours (comma-separated): 24, 48, 72
proxyRightsstringDropship benefits (comma-separated): 4360897 (free shipping dropship), 449154 (buy-first-pay-later)
shopServicestringSeller services (comma-separated): 4057409 (worry-free purchase), 888777 (deep verification report)
buyerProtectionsstringBuyer protections (comma-separated values in Chinese)
faceToFaceSupportstringShipping label support (comma-separated): 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou)

Other

ParameterTypeDescription
productIdsstringProduct IDs separated by Chinese comma, max 20
goodsUrlstringDirect product URL for lookup
beginOfferCreateTime / endOfferCreateTimestringListing date range (format: YYYY-MM-DD)

Usage Examples

1. Monthly bestsellers for a keyword

"Show me the top-selling phone cases on 1688 this month"

{"keyWord": "phone case", "pageType": 3, "date": "2026-03-01", "sortField": "orderCount", "sortType": "desc"}

2. Weekly billboard sorted by revenue

"What products had the highest revenue last week in the yoga mat category?"

{"keyWord": "yoga mat", "pageType": 2, "date": "2026-03-22", "sortField": "saleVolume", "sortType": "desc"}

3. Factory-direct products with price filter

"Find factory-direct earphone products on 1688 priced between 5 and 30 yuan"

{"keyWord": "earphones", "companyType": 2, "beginPrice": 5, "endPrice": 30, "sortField": "saleCount", "sortType": "desc"}

4. Cross-border tagged products with fast shipping

"Show cross-border tagged LED light products that ship within 24 hours"

{"keyWord": "LED lights", "offerType": 4, "sendTime": "24", "sortField": "orderCount", "sortType": "desc"}

5. New products from super factories

"Find newly listed products from super factories in the pet supplies category"

{"keyWord": "pet supplies", "offerType": 2, "shiLiType": "superFactory", "sortField": "offerCreateTime", "sortType": "desc"}

6. Dropship-friendly products with buyer protections

"Show me dropship-friendly bag products with free shipping and return support"

{"keyWord": "handbags", "proxyRights": "4360897", "buyerProtections": "free shipping, 7-day returns", "sortField": "orderCount", "sortType": "desc"}

7. High-volume products in a price range

"Find products with more than 1000 orders and wholesale price under 50 yuan in the toy category"

{"keyWord": "toys", "beginOrderCount": 1000, "endPrice": 50, "sortField": "orderCount", "sortType": "desc"}

8. Browse by product IDs

"Look up these specific 1688 product IDs: 123456、789012"

{"productIds": "123456、789012"}

Display Rules

  1. Present data clearly: Show product results in well-organized tables including product title, wholesale price, dropship price, order count, units sold, estimated revenue, supplier name, and listing date
  2. Image display: When imageUrl is available, display product images to help users visually identify products
  3. Link provision: Include product links (asinUrl) and shop links (shopUrl) so users can navigate directly to the 1688 listing
  4. Price formatting: Always show prices with the currency (CNY/RMB) and clarify whether the price is wholesale or dropship
  5. Volume context: When presenting sales data, clearly label whether it is weekly or monthly data based on the dataType field
  6. Pagination guidance: When total results exceed the current page, inform the user of the total count and offer to fetch more pages
  7. Keyword translation: If the user provides a keyword in a non-Chinese language, translate it to Chinese before querying, and inform the user of the translated keyword
  8. Error handling: When a query fails, explain the issue and suggest adjusting parameters (e.g., broadening filters, checking date format)

Important Limitations

  • Keyword language: The keyWord parameter must be in Chinese. Always translate non-Chinese keywords before querying.
  • Date format matters: Weekly billboard dates must be a Sunday; monthly billboard dates must be the 1st of the month.
  • Weekly data range: Last 90 days only.
  • Monthly data range: Last 12 months only.
  • Page size cap: Maximum 100 results per request.
  • Product ID limit: Maximum 20 product IDs per lookup.

User Expression & Scenario Quick Reference

Applicable -- 1688 wholesale product discovery and sourcing:

User SaysScenario
"What's hot on 1688", "1688 trending products"Bestseller discovery
"Find cheap suppliers for XX", "wholesale source for XX"Sourcing by keyword
"Factory-direct products", "OEM suppliers"Factory filtering
"Cross-border sourcing", "products for export"Cross-border tag filtering
"Dropshipping products on 1688"Dropship-enabled product search
"New products on 1688", "recently listed items"New product discovery
"Compare suppliers for XX"Multi-result comparison
"1688 product ranking", "bestseller list"Billboard browsing

Not applicable -- Needs beyond 1688 product billboard data:

  • Amazon product research or keyword analysis (use ABA tools instead)
  • 1688 store/shop-level analytics (shop rankings, shop scores)
  • Alibaba.com (international) data
  • Price negotiation or order placement
  • Product quality reviews or certifications
  • Logistics cost calculation or freight forwarding

Authentication

Set the NEXSCOPE_API_KEY environment variable. If credentials are missing or expire, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to top up credits.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Analyze Amazon traffic gaps between an owned product and competitors using Nexscope keyword, traffic, listing and review evidence. Use for missing keyword coverage, organic-versus-paid traffic structure, variant-aware rank comparisons and evidence-based listing priorities. Produces a local HTML report; does not execute advertising changes.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nexscope-ai/nexscope-ecommerce-skills952026년 10월 15일 업데이트

Find similar design-registration candidates from a product image using Nexscope. Use for image-based design patent candidate screening with region, jurisdiction, Locarno and legal-status filters. Returns evidence for review, never an infringement or freedom-to-operate verdict.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nexscope-ai/nexscope-ecommerce-skills952026년 10월 15일 업데이트

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nexscope-ai/nexscope-ecommerce-skills952026년 10월 15일 업데이트

Search and analyze products on the Chinese 1688 wholesale platform (Alibaba domestic B2B market) for sourcing, supplier discovery, and product selection. Trigger when the user mentions 1688 product search, finding suppliers on 1688, wholesale product queries, factory sourcing, dropshipping supplier search, 1688 keyword product selection, wholesale price comparison, filtering by sales volume, any product research on the 1688 platform, 1688 search, 1688 product selection, find suppliers, factory lookup, wholesale pricing, supplier search, domestic sourcing, 1688 products. Even if the user does not explicitly say "1688", if their need involves searching for wholesale products, finding domestic suppliers, or sourcing from the domestic Chinese market, this skill should also be triggered.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nexscope-ai/nexscope-ecommerce-skills952026년 10월 15일 업데이트

Perform image-based product search on the 1688 platform. Use an image URL to find visually similar supplier products, returning title, price, minimum order quantity, monthly sales, repurchase rate, trade score, and seller identity. Triggered when users mention 1688 image search, 1688 visual search, find supplier by image, reverse image search 1688, 1688 product sourcing by image, or Alibaba 1688 image search. Even if the user does not explicitly mention "image search," this skill should be triggered whenever a user provides an image URL and wants to find matching or similar products on the 1688 wholesale platform.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nexscope-ai/nexscope-ecommerce-skills952026년 10월 15일 업데이트

Authorize Amazon Ads accounts and inspect safe connection and profile metadata.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nexscope-ai/nexscope-ecommerce-skills952026년 10월 15일 업데이트

nexscope-ai의 스킬 모두 보기

이 스킬의 문제 신고