SkillAgentSearch skills...

etsy-product-detail

Etsy product detail scraper: given an Etsy listing URL, returns full product detail including listingId, title, priceCurrent, priceOriginal, currency, images (all), description, shopName, shopUrl, rating, reviewCount, favorites, inCartCount, variations (with per-option price ranges), highlights, lis…

Install / Use

npx skills add browser-act/skills --skill etsy-product-detail

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

91/100

Supported Platforms

Universal

Our assessment of etsy-product-detail

etsy-product-detail scores 91/100 on our quality scale, 1012th of 4,698 Development & Engineering skills we index (top 22%).

Its SKILL.md is 8.9 KB long, well organised into 13 sections with 1 code example: 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.

Substance
29/30
Structure
17/20
Description
15/15
Adoption
16/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 3 months ago, so etsy-product-detail is actively maintained.
  • Our last check on 2026-10-28 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 found

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.

AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

etsy-product-detail compared with similar skills

All 4 of these similar skills score higher than etsy-product-detail; compare them before choosing.

SkillScoreStarsUpdatedFormat
etsy-product-detail (this skill)by browser-act916.0k3mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install etsy-product-detail?
Run npx skills add browser-act/skills --skill etsy-product-detail. The install tabs above show the steps for each supported agent.
Which AI agents does etsy-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 etsy-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 etsy-product-detail still maintained?
The repository was last updated about 3 months ago, so etsy-product-detail is actively maintained.

name: etsy-product-detail description: "Etsy product detail scraper: given an Etsy listing URL, returns full product detail including listingId, title, priceCurrent, priceOriginal, currency, images (all), description, shopName, shopUrl, rating, reviewCount, favorites, inCartCount, variations (with per-option price ranges), highlights, listedDate, relatedTags. Use when user mentions Etsy product, Etsy listing detail, Etsy item info, Etsy product page, scrape Etsy listing, extract Etsy product data, Etsy price and variations, Etsy product images, Etsy product description, Etsy shop from listing, Etsy favorites count, Etsy sale count, Etsy variations extraction, Etsy listing metadata, single Etsy product scrape, bulk enrich Etsy listing URLs, Etsy product details export. Also applies to competitor product monitoring, price and variation tracking on a specific listing, favorites/wishlist popularity tracking, description mining for SEO analysis, and any per-listing enrichment task."

Etsy — Product Detail

Input an Etsy listing URL → output full product detail including price, variations, images, shop, rating, favorites, and description.

Language

All process output to user (progress updates, process notifications) follows the user's language.

Objective

Extract complete detail data from a single Etsy listing page.

Prerequisites

  • Target page is already open in the browser: https://www.etsy.com/listing/{listing-id}/{slug} (or navigate to it during execution)
  • No login required — listing pages are public
  • Browser session must survive anti-bot verification (DataDome). Best practice: navigate to https://www.etsy.com/ first, then to the listing URL

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.

2. Anti-bot Warm-up

If a fresh browser session was just created:

  1. navigate https://www.etsy.com/ → wait stable
  2. Then navigate {listing URL} → wait stable

On blocked by anti-bot verification page errors, switch to a stealth browser with a different fingerprint / proxy and 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. Its role is equivalent to copy-pasting on the user's behalf — the data is already on screen, automation merely saves time. JS code is encapsulated in Python files under the scripts/ directory, invoked via eval "$(python scripts/xxx.py {params})". $(...) is bash syntax; it is recommended to use the bash tool for execution.

DOM: extract product detail from listing page

Prerequisite: current page is an Etsy listing page (https://www.etsy.com/listing/{listing-id}/...) after wait stable.

Extract (description included): eval "$(python scripts/extract-detail.py)"

Extract (skip description text to reduce output size): eval "$(python scripts/extract-detail.py --include-description false)"

Parameters:

  • --include-description: true (default) to include full description text; false to omit and return description: null

Output example:

{
  "error": false,
  "url": "https://www.etsy.com/listing/870439619/personalized-handmade-leather-mens",  // canonical URL
  "listingId": "870439619",                // Etsy listing id
  "title": "Handmade Personalized Men's Full Grain Leather Wallet…",  // full product title
  "priceCurrent": "Price:$23.26+",         // current display price (raw text as shown; may include '+' for variation min)
  "priceOriginal": null,                   // original / crossed-out price, null when no discount
  "currency": "$",                         // currency symbol, null if not detected
  "imageCount": 50,                        // total unique image URLs discovered on the page (includes user-uploaded review photos)
  "images": [                              // ordered list of image URLs (main product images first, then review photos)
    "https://i.etsystatic.com/22700950/r/il/…/il_fullxfull.….jpg"
  ],
  "description": "** Handwriting Engraved Leather Wallet for Men … **",  // full description text; null when --include-description=false
  "shopName": "CaglarCreations",           // shop / seller display name
  "shopUrl": "https://www.etsy.com/shop/CaglarCreations",  // shop URL, tracking params stripped
  "rating": 4.9,                           // average star rating (numeric)
  "reviewCount": "7.8k",                   // review count as displayed by Etsy (may include k/M suffix)
  "favorites": 27013,                      // favorites count (integer), null when not present
  "inCartCount": null,                     // count of active shoppers with item in cart, null when not present
  "variations": [                          // ordered variation groups (e.g. color, size, engraving)
    {
      "label": "Engraving Options",        // variation group label
      "options": [
        {
          "value": "4124115439",           // Etsy option id
          "text": "NO PERSONALIZATION",    // option display name
          "priceRange": "$23.26 - $38.76"  // per-option price range if shown, null otherwise
        }
      ]
    }
  ],
  "highlights": [],                        // seller-declared highlight bullets (materials, dimensions, etc.); empty when not shown
  "listedDate": "Jul 8, 2026",             // date extracted from 'Listed on ...' text; null when not present
  "relatedTags": [                         // links to related Etsy search / market pages surfaced on the listing
    {"text": "Personalized Wedding Scroll for Sale", "url": "https://www.etsy.com/market/personalized_wedding_scroll"}
  ]
}

Error handling:

  • {"error": true, "message": "blocked by anti-bot verification page"} — DataDome interstitial; retry warm-up
  • {"error": true, "message": "not a listing page"} — URL does not match /listing/{id}/...; check input URL
  • Individual fields being null (e.g. inCartCount, listedDate) is normal — those elements are not always rendered

Success Criteria

result.error === false && result.listingId && result.title && result.imageCount >= 1 && (result.priceCurrent !== null)

Known Limitations

  • DataDome anti-bot: fresh sessions may hit a CAPTCHA interstitial; warm up via / first
  • reviewCount returned as displayed text (e.g. 7.8k) rather than an exact integer, matching what Etsy shows on the page
  • Variations that require dynamic selection to reveal a final price (e.g. color + size combined) return their per-option price range as displayed — combined price for a specific selection is not fetched
  • inCartCount is only shown for listings that exceed Etsy's threshold ("N people have this in their cart"); most listings return null
  • highlights appear on some categories only; when absent the field returns []
  • relatedTags may include tangentially-related Etsy market links that were surfaced in the page's link soup; treat as informational, not curated related-search
  • description may include Unicode formatting characters and inline URLs; consumer code should sanitize if needed
  • Multi-image listings return both product photos and user-uploaded review photos in the same list; the first ~20 URLs matching pattern /il/…/il_fullxfull. are the seller's own images

Execution Efficiency

  • Batch orchestration: Loop through listing URLs serially within a single session; insert 3-8 second sleeps between page navigations. Distribute URL batches across multiple stealth browser sessions for higher throughput
  • Test before batch execution: Verify on 1-2 listings first before running the full batch
  • Reduce redundant pre-operations: Warm-up once per session, then process listings sequentially in the same session
  • Skip description when unused: pass --include-description false to shrink per-record output when descriptions are not needed downstream
  • Error resumption: Save each listing's result to results/{listingId}.json immediately; on failure resume from the missing listing

Experience Notes

Path: {working-directory}/browser-act-skill-forge-memories/etsy-scraper-etsy-product-detail.memory.md (working directory is determined by the Agent running the Skill, typically the project root or current working directory)

Before execution: If the file exists, read it first — it records unexpected situations encountered during past executions (e.g., a strategy has become ineffective); adjust strategy order accordingly.

After execution: If an unexpected situation is encountered (strategy became ineffective, page redesigned, anti-scraping upgraded, better path discovered), append a line: {YYYY-MM-DD}: {what happened} → {conclusion}

Normal execution does not write to the file. Do not record what listings were used or how many results were returned — those are task outputs, not experience.

Related Skills

View on GitHub
GitHub Stars6.0k
CategoryDevelopment
Updated2mo ago
Forks304

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions