Skip to content
cccskills
FreePublished on GitHub

ecommerce.etsy-product-query

Query Etsy products with multi-dimensional filters (keyword/URL, price, sales, favorites, reviews, listing date, category, handmade/vintage types, Pick/Bestseller/Raving tags). Trigger when user mentions Etsy products, Etsy listings, Etsy product sourcing, Etsy bestsellers, Etsy handmade, Etsy vintage, Etsy items, or Etsy product query — even if the tool name is not mentioned, as long as the need is to search products, view sales/price/tags, or filter items on Etsy.

The English summary is being prepared. Showing the original description.

See how to install

Files included (4)

  • SKILL.md2.1 KB
  • manifest.json323 B
  • references/api.md6.6 KB
  • scripts/etsy_product_query.py6.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Etsy Product Query (_ehunt_productQuery)

Key Points

  • Pagination: page starts at 1; pageSize defaults to 20, maximum 100 (recommended <= 50).
  • Range Parameters: Same approach as the store interface — begin* / end* pairs.
  • Sorting: sortBy is 1~6 (upstream sort_by). sortDesc: 1=descending, 2=ascending (different from _ehunt_storeQuery which uses 1/0).
  • Product Type productType: 1 Handmade, 2 Vintage, 3 Digital, 4 Custom, 9 Other, use commas for multiple selection.
  • Currency: currencyCode defaults to USD.
  • Category ID: category is a single category ID; use the category search skill to find the ID first.

Script (Optional)

Command-line debugging: python scripts/etsy_product_query.py ''<JSON>'' (requires NEXSCOPE_API_KEY). See references/api.md for details.

Reference

Input/output parameter tables are in references/api.md.

Authentication

Set the NEXSCOPE_API_KEY environment variable. If authentication fails (401/402) or you see insufficient balance errors, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to get an API Key or top up credits.

Credit Consumption

Dynamic pricing: credits consumed = number of products returned x 1.8. Billed per page of results returned; fetching the next page is essentially a new request, billed again based on the new page''s result count.

Important: This skill''s cost scales dynamically and may consume a significant number of credits in a single call. You must warn the user and let them decide whether to continue.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills96Updated Oct 15, 2026

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.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills96Updated Oct 15, 2026

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.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills96Updated Oct 15, 2026

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.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills96Updated Oct 15, 2026

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.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills96Updated Oct 15, 2026

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.

The English summary is being prepared. Showing the original description.

nexscope-ai/nexscope-ecommerce-skills96Updated Oct 15, 2026

See all skills by nexscope-ai

Report a problem with this skill