Wenmai Alpha Etsy Scraper

Name: Wenmai Alpha Etsy Scraper
Author: wenmai-ai

ASecurity

Etsy 商品采集接口，用于研究手作、设计、小众和个性化商品，返回接口支持的商品与市场结果数据。当用户提到 Etsy 搜品、手工品选品、小众产品、个性化商品、Etsy 竞品、价格研究或 Etsy scraper 时触发此技能。即使用户未明确提及 Etsy API，只要需要基于 Etsy 商品数据开展市场或竞品研究，也应触发此技能。

3 stars

0 votes

0 copies

0 views

Added 10/5/2026

developmentpythongobashgitapi

Works with

api

Security Analysis

A100/100

Pro scans all 6 files and shows the line behind each finding

Scanned 10/5/2026

$npx -y skills add wenmai-ai/wenmai-skills --skill wenmai-alpha-etsy-scraper --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Wenmai Alpha Etsy Scraper?

Add the live security badge to your README — it updates automatically with every re-scan.

Security grade badge for Wenmai Alpha Etsy Scraper

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/wenmai-ai-wenmai-alpha-etsy-scraper/badge)](https://www.skillsdirectory.com/skills/wenmai-ai-wenmai-alpha-etsy-scraper)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

Files

SKILL.md

---
name: wenmai-alpha-etsy-scraper
description: "Etsy 商品采集接口，用于研究手作、设计、小众和个性化商品，返回接口支持的商品与市场结果数据。当用户提到 Etsy 搜品、手工品选品、小众产品、个性化商品、Etsy 竞品、价格研究或 Etsy scraper 时触发此技能。即使用户未明确提及 Etsy API，只要需要基于 Etsy 商品数据开展市场或竞品研究，也应触发此技能。"
metadata:
  author: wenmai-ai
  version: "1.0.0"
---

# Wenmai Alpha Etsy Scraper

## Purpose
Use this Skill to fetch Etsy Scraper data through Wenmai standard API. It is useful for Etsy 手作/小众商品.

The Skill calls exactly one fixed standard API endpoint:

- Endpoint: `POST /wmapi/v1/alpha/etsy-scraper`
- Auth: Header `secret-key: $WENMAI_API_KEY`
- Script: `scripts/alpha_etsy_scraper.py`

## How To Run

请参考 https://skill.wenmai-ai.com/wenmaiskills/use_guide.html 获取 `secret-key`；额度或余额不足时，按该指南完成充值。运行脚本前，把复制的 key 导出为 `WENMAI_API_KEY`（或 `WENMAI_SECRET_KEY`）。

```bash
export WENMAI_API_KEY=sk-...
python3 scripts/alpha_etsy_scraper.py '{"sort": "most_relevant", "locale": "en-US", "onSale": false, "category": "jewelry-and-accessories", "currency": "USD", "maxItems": 3, "maxPrice": 3, "minPrice": 10, "searchQuery": "handmade necklace", "freeShipping": false, "excludeKeywords": ["digital", "download"], "includeKeywords": ["handmade"], "excludeDigitalDownloads": false}'
```

The script prints the raw Wenmai API response as formatted JSON. Read `references/api.md` when you need parameter details, field meanings, allowed values, defaults, request examples, or response fields.

## Parameter Rules

Required top-level fields: `searchQuery`.

Default assumptions: preserve the user's requested marketplace, country, language, URL list, keyword list, IDs, filters, pagination, and result limits. For scraper-style endpoints, avoid expanding result limits unless the user asks for a broader scrape.

## Response Rules

Present returned data in compact tables when the user asks for inspection or comparison. For long arrays, summarize the most decision-relevant rows first, then offer to continue with more rows. Keep raw numbers and source URLs traceable to response fields.

If the API response contains an `error` or a non-`OK` `code`, report the message and `requestId` if present, then suggest parameter corrections. Never invent missing data.

Attribution

wenmai-ai

View source See grades on GitHub More from wenmai-ai →

SSkills DirectorySkills Directory

Ship a skill? Prove it's safe.

Free 120-pattern security scan, letter grade, and an embeddable README badge.

Submit a skill

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments (0)

No comments yet. Be the first to comment!

--- name: wenmai-alpha-etsy-scraper description: "Etsy 商品采集接口，用于研究手作、设计、小众和个性化商品，返回接口支持的商品与市场结果数据。当用户提到 Etsy 搜品、手工品选品、小众产品、个性化商品、Etsy 竞品、价格研究或 Etsy scraper 时触发此技能。即使用户未明确提及 Etsy API，只要需要基于 Etsy 商品数据开展市场或竞品研究，也应触发此技能。" metadata: author: wenmai-ai version: "1.0.0" --- # Wenmai Alpha Etsy Scraper ## Purpose Use this Skill to fetch Etsy Scraper data through Wenmai standard API. It is useful for Etsy 手作/小众商品. The Skill calls exactly one fixed standard API endpoint: - Endpoint: `POST /wmapi/v1/alpha/etsy-scraper` - Auth: Header `secret-key: $WENMAI_API_KEY` - Script: `scripts/alpha_etsy_scraper.py` ## How To Run 请参考 https://skill.wenmai-ai.com/wenmaiskills/use_guide.html 获取 `secret-key`；额度或余额不足时，按该指南完成充值。运行脚本前，把复制的 key 导出为 `WENMAI_API_KEY`（或 `WENMAI_SECRET_KEY`）。 ```bash export WENMAI_API_KEY=sk-... python3 scripts/alpha_etsy_scraper.py '{"sort": "most_relevant", "locale": "en-US", "onSale": false, "category": "jewelry-and-accessories", "currency": "USD", "maxItems": 3, "maxPrice": 3, "minPrice": 10, "searchQuery": "handmade necklace", "freeShipping": false, "excludeKeywords": ["digital", "download"], "includeKeywords": ["handmade"], "excludeDigitalDownloads": false}' ``` The script prints the raw Wenmai API response as formatted JSON. Read `references/api.md` when you need parameter details, field meanings, allowed values, defaults, request examples, or response fields. ## Parameter Rules Required top-level fields: `searchQuery`. Default assumptions: preserve the user's requested marketplace, country, language, URL list, keyword list, IDs, filters, pagination, and result limits. For scraper-style endpoints, avoid expanding result limits unless the user asks for a broader scrape. ## Response Rules Present returned data in compact tables when the user asks for inspection or comparison. For long arrays, summarize the most decision-relevant rows first, then offer to continue with more rows. Keep raw numbers and source URLs traceable to response fields. If the API response contains an `error` or a non-`OK` `code`, report the message and `requestId` if present, then suggest parameter corrections. Never invent missing data.