Agent skill

Linkfox Etsy Product Detail

by linkfox-ai in linkfox-ai/linkfox-skills

查询单个 Etsy Listing 的公共商品详情。输入 Etsy 商品直链,返回商品标题与描述、价格区间、币种、主图与图片集、变体、库存上限、类目、发货地与预计送达、店铺资料、评论数量、评分及买家反馈标签等数据。当用户提到 Etsy 商品详情、Etsy listing 解析、Etsy 商品链接查询、竞品 Listing 拆解、价格图片提取、店铺与评论概况、Etsy product…

MITAuto-check passed

Install Linkfox Etsy Product Detail

skills CLI
$ npx skills add linkfox-ai/linkfox-skills --skill linkfox-etsy-product-detail -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install linkfox-ai/linkfox-skills linkfox-etsy-product-detail --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/linkfox-ai/linkfox-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/linkfox-etsy-product-detail .claude/skills/linkfox-etsy-product-detail && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
linkfox-etsy-product-detail
GitHub stars
107
Token cost
~1.6k tokens
SKILL.md length
705 words
Files
5 (incl. scripts, references)
Skills in repo
177
Repo updated
First seen
Licence
MIT

At a glance

查询单个 Etsy Listing 的公共商品详情。输入 Etsy 商品直链,返回商品标题与描述、价格区间、币种、主图与图片集、变体、库存上限、类目、发货地与预计送达、店铺资料、评论数量、评分及买家反馈标签等数据。当用户提到 Etsy 商品详情、Etsy listing 解析、Etsy 商品链接查询、竞品 Listing 拆解、价格图片提取、店铺与评论概况、Etsy product…

  • Works in 8 steps: Lead with title, listing ID, shop name,… → Show the primary image inline and offer… → Present variants and quantity only when… → …
  • SKILL.md covers Core Concepts, Data Fields, Parameter Guide and 调用方式, plus 6 more sections
  • Runs Python scripts from its folder; calls python; reaches etsy.com; needs LINKFOX_AGENT_API_KEY and LINKFOXAGENT_API_KEY

What it does

Linkfox Etsy Product Detail is an agent skill from linkfox-ai/linkfox-skills. 查询单个 Etsy Listing 的公共商品详情。输入 Etsy 商品直链,返回商品标题与描述、价格区间、币种、主图与图片集、变体、库存上限、类目、发货地与预计送达、店铺资料、评论数量、评分及买家反馈标签等数据。当用户提到 Etsy 商品详情、Etsy listing 解析、Etsy 商品链接查询、竞品 Listing 拆解、价格图片提取、店铺与评论概况、Etsy product details、Etsy listing lookup 时触发。即使用户未明确说“商品详情”,只要提供带数字 listing ID 的 Etsy 商品直链并希望读取当前公开商品页信息,也应触发此技能。

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/api.md`, `references/onboarding.md` and `scripts/etsy_product_detail.py`).

The licence is MIT.

Example prompts

  • “/linkfox-etsy-product-detail”

Requirements

  • Python 3
  • A credential in LINKFOX_AGENT_API_KEY
  • A credential in LINKFOXAGENT_API_KEY

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Lead with title, listing ID, shop name, category, price range, and currency.
  2. Show the primary image inline and offer the remaining image count rather than rendering every image by default.
  3. Present variants and quantity only when returned; an empty variants list is a valid result.
  4. Keep listing reviews and shop reviews distinct, and label buyer-feedback tags as aggregate signals.
  5. Show delivery estimates only when both source values are meaningful; preserve nulls as unavailable.
  6. Do not normalize or convert price strings without an explicit user request.
  7. Treat missing, empty, or implausible shop fields as extraction uncertainty; do not silently repair them.
  8. For long descriptions and image arrays, summarize first and extract exact content from the saved JSON on demand.

What it can do on your machine

Read from SKILL.md and the folder at commit 38fef04. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • etsy.com

    Also links to:

    • skill.linkfox.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • LINKFOX_AGENT_API_KEY
    • LINKFOXAGENT_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Linkfox Etsy Product Detail loads about 1.6k tokens when it runs, and up to ~3.8k if it reads all its reference files. Until then it costs about 80 tokens; SKILL.md has 705 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from linkfox-ai/linkfox-skills at commit 38fef04, republished under its MIT licence (© linkfox-ai). 705 words, ~1,640 tokens.

Download SKILL.mdSave it as .claude/skills/linkfox-etsy-product-detail/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
linkfox-etsy-product-detail
description
查询单个 Etsy Listing 的公共商品详情。输入 Etsy 商品直链,返回商品标题与描述、价格区间、币种、主图与图片集、变体、库存上限、类目、发货地与预计送达、店铺资料、评论数量、评分及买家反馈标签等数据。当用户提到 Etsy 商品详情、Etsy listing 解析、Etsy 商品链接查询、竞品 Listing 拆解、价格图片提取、店铺与评论概况、Etsy product details、Etsy listing lookup 时触发。即使用户未明确说“商品详情”,只要提供带数字 listing ID 的 Etsy 商品直链并希望读取当前公开商品页信息,也应触发此技能。

Etsy Product Detail Lookup

Fetch the current public detail of one Etsy listing from its direct product URL for listing research and competitor-page audits.

Core Concepts

  • Direct listing URL required: use an Etsy HTTPS URL whose path is /listing/<numeric-id> or /listing/<numeric-id>/<one-slug-segment>, with an optional trailing slash and query string.
  • One listing per call: this is a detail lookup, not Etsy keyword search or bulk screening.
  • Structured public-page data: the response groups listing, price, media, shop, delivery, and review-summary fields.
  • Current snapshot: values reflect what the public listing exposes when queried and may be absent or inconsistent.

Data Fields

FieldDescription
productId / productUrlEtsy listing ID and canonical/product URL
title / descriptionListing title and description sections
image / imagesPrimary image and full image list
price / lowPrice / highPrice / oldPriceCurrent, range, and previous price strings when available
currencyReturned currency code
maxQuantity / variantsReported maximum quantity and variation options
categoryEtsy category breadcrumb
countryShippingFromShipping origin country
deliveryDaysMin / deliveryDaysMaxEstimated delivery window; may be null or omitted
shopId / shopName / shopUrl / shopSalesShop identity and public sales data
reviews / star / shopReviewsListing review count, rating, and shop review count
highlightsTags / reviewsTagsBuyer-feedback highlights and tag frequencies
reviewsScoresDynamic review-score breakdown; keys vary by listing
yearsOnEtsyPublic shop tenure
hasRatingsBadge / hasConvosBadge / hasShippingBadgePublic shop/listing badge flags
moreLikeUrl / searchPositionRelated-link or source-position fields when available

The tool returns aggregate review signals, not individual review records.

Parameter Guide

ParameterRequiredDefaultDescription
productUrlYes-Public HTTPS Etsy listing URL on etsy.com or a subdomain, without embedded credentials, using the default HTTPS port; the path is /listing/<numeric-id> with at most one slug segment, and an optional trailing slash/query string

Search pages, shop pages, non-Etsy hosts, and listing URLs without a numeric listing ID are not valid inputs.

调用方式

  • API 端点:POST /etsy/product/detail(完整参数/响应/错误码见 references/api.md)
  • Python 脚本:python scripts/etsy_product_detail.py '<JSON 参数>' [--inline]
  • 成本约束:本工具会消耗算力;同一会话同一参数组合默认只调用一次,脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探;需要继续检索时先向用户说明会产生额外消耗。

输出策略(脚本默认行为):

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-etsy-product-detail-<timestamp>.json(<cwd> 为脚本执行时的工作目录,在 Claude Code 里即当前项目目录;<session> 取自环境变量 SESSION_ID,按用户任务自动聚合;禁止写入 /tmp,当前目录不可写则报错)
  • 响应体 ≤ 8 KB:落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB:落盘后 stdout 只输出摘要(顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本)
  • 加 --inline 强制全量打印到 stdout(同样落盘)

读数据建议:先看摘要判断是否足够;需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。

解决认证和算力问题

发生以下异常情况时,采用 references/onboarding.md 引导解决问题:

异常情况
  • 未配置 API Key:环境变量未配置 LINKFOX_AGENT_API_KEY,也未配置 LINKFOXAGENT_API_KEY。
  • 响应 401 或 402 状态码。
  • 响应提示算力或余额不足:消息含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义。

Usage Examples

bash
python scripts/etsy_product_detail.py '{"productUrl":"https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"}'
Show full SKILL.md (345 more words)Show less

Display Rules

  1. Lead with title, listing ID, shop name, category, price range, and currency.
  2. Show the primary image inline and offer the remaining image count rather than rendering every image by default.
  3. Present variants and quantity only when returned; an empty variants list is a valid result.
  4. Keep listing reviews and shop reviews distinct, and label buyer-feedback tags as aggregate signals.
  5. Show delivery estimates only when both source values are meaningful; preserve nulls as unavailable.
  6. Do not normalize or convert price strings without an explicit user request.
  7. Treat missing, empty, or implausible shop fields as extraction uncertainty; do not silently repair them.
  8. For long descriptions and image arrays, summarize first and extract exact content from the saved JSON on demand.

Important Limitations

  1. Public Etsy page structure changes can cause fields to be absent, empty, or occasionally misidentified.
  2. star, price fields, delivery estimates, shop metadata, and badges are not guaranteed for every listing.
  3. The response includes review counts, tags, and aggregate scores, but not individual buyer reviews.
  4. This tool does not provide historical prices, Etsy keyword rankings, or guaranteed sales estimates.
  5. This tool does not search Etsy; use the Etsy product-query skill when the user needs keyword or multi-filter discovery.

User Expression & Scenario Quick Reference

Applicable — one known Etsy listing URL:

User SaysScenario
“查这个 Etsy 商品链接的详情”Listing detail lookup
“提取这个 Etsy Listing 的标题、描述和图片”Listing-content extraction
“看看它的价格区间、变体和发货信息”Offer and delivery audit
“这个 Etsy 商品的店铺和评论概况如何?”Shop and review-summary lookup

Not applicable:

  • Etsy keyword search, category discovery, or multi-product screening
  • Etsy shop search/ranking without a specific listing URL
  • Individual review retrieval or sentiment analysis from full review text
  • Listing creation, editing, order management, or other seller-account operations

算力消耗规则

消耗 6 算力。

用户会因算力消耗而支付费用。重复查询其他 Listing 会分别计费;继续调用前应让用户知晓额外消耗。

Feedback:

Auto-detect and report feedback via the Feedback API when the described capability differs from actual behavior, results miss the user's intent, the user expresses praise or dissatisfaction, or the skill can be improved. Follow references/api.md without interrupting the user's flow.


For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.

© linkfox-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in skills/linkfox-etsy-product-detail of linkfox-ai/linkfox-skills.

  • SKILL.md
  • references/api.md
  • references/onboarding.md
  • scripts/etsy_product_detail.py
  • scripts/onboarding.py

Open the folder on GitHubat commit 38fef04

Compare with similar skills

Linkfox Etsy Product Detail next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Linkfox Etsy Product Detail compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linkfox Etsy Product Detail this skilllinkfox-ai/linkfox-skills107—~1.6kAutomated safety check: PassMIT
Etsy Search Listingssickn33/agentic-awesome-skills47k1 repos~1.2kAutomated safety check: PassMIT
Etsy Product Detailbrowser-act/skills6.1k—~2.3kAutomated safety check: PassMIT
Airbnb Listing Detail Fetcherbrowser-act/skills6.1k—~1.4kAutomated safety check: PassMIT
Etsy Category Listingbrowser-act/skills6.1k—~2kAutomated safety check: PassMIT
Etsy Listing Photographynexscope-ai/eCommerce-Skills1.1k—~444Automated safety check: PassMIT

Similar skills

  • Etsy Search Listings

    sickn33/agentic-awesome-skills

    Fetch live Etsy search listing rows for a keyword, market phrase, or category via Apify Actor publicrecords/etsy-search-scraper (MCP).

    47k GitHub starsUsed in 1 repo~1.2k tokens
    Data & AnalyticsAuto-check passed
  • Etsy Product Detail

    browser-act/skills

    Etsy product detail scraper: given an Etsy listing URL, returns full product detail including listingId, title, priceCurrent, priceOriginal, currency, images (all), description, shopName, shopUrl…

    6.1k GitHub stars~2.3k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • Fetches full Airbnb listing details for a numeric listing ID, including amenities, photos, house rules and ratings, through the site's internal GraphQL API.

    6.1k GitHub stars~1.4k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • Etsy Category Listing

    browser-act/skills

    Etsy category page scraper: given an Etsy category URL (e.g.

    6.1k GitHub stars~2k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Etsy Listing Photography

    nexscope-ai/eCommerce-Skills

    Product photography for Etsy — composition, lighting, backgrounds, editing, lifestyle shots, 360 views

    1.1k GitHub stars~444 tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Music List

    ruvnet/ruflo

    List the account's saved music productions with metadata and audiourl

    74k GitHub stars~332 tokensUpdated yesterday
    Auto-check passed

More from linkfox-ai/linkfox-skills

All 177 skills in this repo
  • Linkfox 1688 Search By Image

    linkfox-ai/linkfox-skills

    1688平台以图搜图,通过商品图片精准检索外观相似或同款的1688货源,返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by…

    107 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Linkfox Aba Intelligent Query

    linkfox-ai/linkfox-skills

    亚马逊ABA(品牌分析)搜索词数据的查询与分析,涵盖15个站点近3年的周维度数据。当用户提到ABA数据、亚马逊搜索词分析、关键词挖掘、搜索排名趋势、市场机会分析、季节性关键词、高点击低转化分析、蓝海词发现、竞品关键词分析、ABA data, search term report, keyword mining, search ranking trends, blue ocean…

    107 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Linkfox Amazon Alexa Search

    linkfox-ai/linkfox-skills

    通过亚马逊前台的 Alexa 购物助手发起自然语言问答,获取与问题相关的导购回答、推荐商品分组、ASIN 列表,以及可继续追问的问题。每次调用仅支持 1 条 prompt,如需追问须由 agent 总结上下文后拼接新问题发起新请求。可用 url 补充亚马逊页面上下文。当用户提到亚马逊 Alexa、Alexa 购物助手、亚马逊智能助手、AI…

    107 GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • 亚马逊反向选品:基于历史商业洞察报告沉淀的指标数据池,按 30+ 项商业维度(市场规模与增长、价格区间与档位份额、竞争密度与头部集中度、人群画像如年龄/性别/收入、评论卖点与痛点等)反向筛选亚马逊赛道与关键词。当用户提到反向选品、指标筛选、细分市场反查、蓝海赛道挖掘、低竞争赛道、新人友好赛道、品牌分散市场、痛点切入、卖点反查、定价档位机会、人群画像选品、Amazon niche reverse…

    107 GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • Linkfox Amazon Product Detail

    linkfox-ai/linkfox-skills

    通过ASIN获取亚马逊商品详细信息,包括标题、图片、五点描述、规格参数、A+页面、价格、评分评论、变体等;可在取得原始HTML时尝试提取Item Highlights(商品亮点)。当用户提到亚马逊商品详情、ASIN查询、商品页面数据、Listing分析、五点描述提取、Item…

    107 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Linkfox Amazon Reviews List

    linkfox-ai/linkfox-skills

    按ASIN获取并分析亚马逊商品评论,支持15个站点(含美国站),按星级筛选评论。当用户提到亚马逊评论、美国站评论、商品评价、买家投诉、差评、好评、星级评分、评论分析、评论情感、产品改良建议、Vine评论、已验证购买评论、竞品评论研究、Amazon reviews, US reviews, Amazon.com reviews, product feedback, negative review…

    107 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed

Questions about Linkfox Etsy Product Detail

What does Linkfox Etsy Product Detail do?

查询单个 Etsy Listing 的公共商品详情。输入 Etsy 商品直链,返回商品标题与描述、价格区间、币种、主图与图片集、变体、库存上限、类目、发货地与预计送达、店铺资料、评论数量、评分及买家反馈标签等数据。当用户提到 Etsy 商品详情、Etsy listing 解析、Etsy 商品链接查询、竞品 Listing 拆解、价格图片提取、店铺与评论概况、Etsy product…. Linkfox Etsy Product Detail is an agent skill from linkfox-ai/linkfox-skills.

How do I install Linkfox Etsy Product Detail in Claude Code?

Run `npx skills add linkfox-ai/linkfox-skills --skill linkfox-etsy-product-detail -a claude-code`. Or copy the skill folder (skills/linkfox-etsy-product-detail in linkfox-ai/linkfox-skills) into .claude/skills/linkfox-etsy-product-detail in your project. Claude Code loads it when a task matches its description.

How do I install Linkfox Etsy Product Detail in Codex?

Run `npx skills add linkfox-ai/linkfox-skills --skill linkfox-etsy-product-detail -a codex`. Or copy the skill folder (skills/linkfox-etsy-product-detail in linkfox-ai/linkfox-skills) into .agents/skills/linkfox-etsy-product-detail in your project. Codex loads it when a task matches its description.

Can I use Linkfox Etsy Product Detail in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add linkfox-ai/linkfox-skills --skill linkfox-etsy-product-detail -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/linkfox-etsy-product-detail, .gemini/skills/linkfox-etsy-product-detail, .github/skills/linkfox-etsy-product-detail and .opencode/skills/linkfox-etsy-product-detail in your project.

What does Linkfox Etsy Product Detail need to run?

Going by SKILL.md and its folder, Linkfox Etsy Product Detail needs Python for the scripts in its folder, the command-line tools its instructions call (python) and credentials named LINKFOX_AGENT_API_KEY and LINKFOXAGENT_API_KEY. Our summary lists: Python 3; A credential in LINKFOX_AGENT_API_KEY; A credential in LINKFOXAGENT_API_KEY.

Does Linkfox Etsy Product Detail access the network?

SKILL.md names 2 domains. In commands or code: etsy.com; the agent is likely to contact it when it follows the instructions. As links in the text: skill.linkfox.com. This is read from the text; nothing was executed.

Is Linkfox Etsy Product Detail safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Linkfox Etsy Product Detail use?

Linkfox Etsy Product Detail is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Linkfox Etsy Product Detail use?

About 1.6k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.2k tokens, read only when the agent opens those files.

What are the alternatives to Linkfox Etsy Product Detail?

Skills that share tags, products or a category with Linkfox Etsy Product Detail: Etsy Search Listings (sickn33/agentic-awesome-skills, 47k stars), Etsy Product Detail (browser-act/skills, 6.1k stars), Airbnb Listing Detail Fetcher (browser-act/skills, 6.1k stars) and Etsy Category Listing (browser-act/skills, 6.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linkfox Etsy Product Detail?

linkfox-ai (a GitHub user) maintains it in linkfox-ai/linkfox-skills, which has 107 GitHub stars. The repository holds 177 skills in this directory. The repository was last updated on September 14, 2026.

Source: linkfox-ai/linkfox-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.