Agent skill

Taobao Shop Catalog

by browser-act in browser-act/skills

Browse a Taobao or Tmall shop's product catalog by shopId, returning paginated product listings with itemId and title.

MITAuto-check passedSales & Support

Install Taobao Shop Catalog

skills CLI
$ npx skills add browser-act/skills --skill taobao-shop-catalog -a claude-code

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

GitHub CLI
$ gh skill install browser-act/skills taobao-shop-catalog --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/browser-act/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/solutions/ecommerce/taobao-shop-catalog .claude/skills/taobao-shop-catalog && 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
taobao-shop-catalog
GitHub stars
6.1k
Token cost
~1.4k tokens
SKILL.md length
662 words
Files
2 (incl. scripts)
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

Browse a Taobao or Tmall shop's product catalog by shopId, returning paginated product listings with itemId and title.

  • Works in 2 steps: Tool Readiness → Login Verification
  • User asks to scrape a Taobao shop
  • SKILL.md covers Language, Objective, Prerequisites and Pre-execution Checks, plus 6 more sections
  • Runs Python scripts from its folder; calls python; reaches taobao.com and img.alicdn.com

What it does

Taobao Shop Catalog is an agent skill from browser-act/skills. Browse a Taobao or Tmall shop's product catalog by shopId, returning paginated product listings with itemId and title. Use when user asks to scrape a Taobao shop, get all products from a store, list items in a Taobao/Tmall shop, fetch shop catalog by userId or shopId, 采集淘宝店铺商品, 抓取淘宝店铺所有商品, 获取天猫店铺商品列表, 淘宝店铺目录, 按店铺ID采集商品. Also applies to shop inventory monitoring, competitor store analysis, and bulk itemId collection from a specific seller.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/extract-catalog.py`).

It sits in Sales & Support, covering E-commerce operations and Web scraping. It works with Python. The repository describes itself as: Browser automation CLI built for AI agents. Break through anti-bot walls, hand off to humans across platforms when stuck. Parallel multi-task execution, independent multi-session… The licence is MIT.

When your agent uses it

  • User asks to scrape a Taobao shop
  • Get all products from a store
  • List items in a Taobao/Tmall shop
  • Fetch shop catalog by userId

Example prompts

  • “/taobao-shop-catalog”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Tool Readiness
  2. Login Verification

What it can do on your machine

Read from SKILL.md and the folder at commit 11c057b. 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 1 file 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:

    • taobao.com
    • img.alicdn.com
    • detail.tmall.com

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Taobao Shop Catalog loads about 1.4k tokens when it runs. Until then it costs about 116 tokens; SKILL.md has 662 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~116
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

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 browser-act/skills at commit 11c057b, republished under its MIT licence (© browser-act). 662 words, ~1,448 tokens.

Download SKILL.mdSave it as .claude/skills/taobao-shop-catalog/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
taobao-shop-catalog
description
Browse a Taobao or Tmall shop's product catalog by shopId, returning paginated product listings with itemId and title. Use when user asks to scrape a Taobao shop, get all products from a store, list items in a Taobao/Tmall shop, fetch shop catalog by userId or shopId, 采集淘宝店铺商品, 抓取淘宝店铺所有商品, 获取天猫店铺商品列表, 淘宝店铺目录, 按店铺ID采集商品. Also applies to shop inventory monitoring, competitor store analysis, and bulk itemId collection from a specific seller.

Taobao — Shop Catalog

shopId → paginated shop product listing (itemId, title, image URL)

Language

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

Objective

Navigate to a Taobao or Tmall shop's catalog page and extract product listings.

Prerequisites

  • Target page is already open in the browser: https://shop{shopId}.taobao.com/category.htm
  • User is logged in to Taobao (user avatar or nickname visible in the page header)

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. Login Verification

If login status for Taobao has been confirmed in the current session → skip this step.

Otherwise: open https://www.taobao.com and observe the page header:

  • User nickname visible → logged in, continue execution
  • Login button visible → not logged in, inform the user that Taobao login is needed first, assist the user in completing the login flow

User refuses or cannot log in → terminate execution.

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. 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: shop catalog product list (data extraction)

Navigate to the shop's catalog page, then extract:

  1. navigate "https://shop{shopId}.taobao.com/category.htm?search=y&pageNo={page}"
    • Note: Tmall shops redirect to https://{shopName}.tmall.com/category.htm?search=y&pageNo={page}
    • The search=y parameter activates the paginated search mode
  2. wait stable
  3. eval "$(python scripts/extract-catalog.py '{shopId}' --page {page})"

Parameters:

  • shopId: numerical shop ID (e.g., 67095450); found in shop URL as shop{shopId}.taobao.com
  • --page: page number, 1-based, default 1

Output example:

json
[
  {
    "itemId": "1041516493508",
    "title": "绿联T8梯形排插插座转换器插线板大间距宿舍桌面充电多孔位插排",
    "imageUrl": "https://img.alicdn.com/imgextra/...",
    "itemUrl": "https://detail.tmall.com/item.htm?id=1041516493508"
  }
]

Notes:

  • price is not included — Taobao shop catalog pages use font-based price obfuscation that cannot be decoded via DOM extraction. Use the taobao-product-detail skill to fetch prices for specific items.
  • imageUrl may be a lazy-loaded URL from data-ks-lazyload-custom attribute when the image has not scrolled into view

Error handling: if result count = 0, check that the page loaded correctly (screenshot), confirm the shopId is valid, and retry. Some shops may be Tmall-only and require following the redirect URL.

Pagination

URL Pagination: URL pattern https://shop{shopId}.taobao.com/category.htm?search=y&pageNo={N} (or https://{shopName}.tmall.com/category.htm?search=y&pageNo={N} after redirect), increment pageNo from 1. Each page returns up to 60 items. Termination: when result count = 0 or next page link href with pageNo={N+1} is absent from the DOM.

Next page link selector: a[href*="pageNo"] (contains the next page number).

Show full SKILL.md (242 more words)Show less

Success Criteria

result count >= 1 and itemId non-null rate = 100%

Known Limitations

  • Prices are font-obfuscated on the shop catalog page and cannot be extracted; fetch individual item prices via taobao-product-detail
  • Some shop categories are not shown in the default category.htm view; category-specific browsing requires clicking category links in the shop nav
  • Shop redirect from shop{id}.taobao.com to {name}.tmall.com changes the URL structure; the script handles both

Execution Efficiency

  • Batch orchestration: Write a bash script to loop through pages serially; add 2–3 second intervals between navigations.
  • Test before batch execution: After writing a batch script, you must first test with 1–2 pages to verify the script runs correctly; only then run the full batch. Never skip testing and execute in batch directly.
  • Reduce redundant pre-operations: Stay in the same session for all pages of one shop without re-login checks.
  • Error resumption: Save results page by page during batch processing; on failure, resume from the last successful page rather than starting over.

Experience Notes

Path: {working-directory}/browser-act-skill-forge-memories/taobao-shop-catalog.memory.md

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 keywords were used or how many results were returned — those are task outputs, not experience.

© browser-act, 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 1 other file (scripts) in solutions/ecommerce/taobao-shop-catalog of browser-act/skills.

  • SKILL.md
  • scripts/extract-catalog.py

Open the folder on GitHubat commit 11c057b

Compare with similar skills

Taobao Shop Catalog 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.

Taobao Shop Catalog compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Taobao Shop Catalog this skillbrowser-act/skills6.1k—~1.4kAutomated safety check: PassMIT
Product Reel Generatorgooseworks-ai/goose-skills1.2k1 repos~2.3kAutomated safety check: NotesMIT
Etsy Shop Sales Historysickn33/agentic-awesome-skills47k1 repos~1.2kAutomated safety check: PassMIT
Extractactionbook/actionbook1.6k2 repos~3.4kAutomated safety check: PassApache-2.0
Agentkeychainbase-labs/Agentkey656—~2.3kAutomated safety check: PassMIT
Apify Ecommercesickn33/agentic-awesome-skills47k2 repos~2.3kAutomated safety check: NotesMIT

Similar skills

  • Product Reel Generator

    gooseworks-ai/goose-skills

    Generates Instagram-ready product reels from any e-commerce product page URL.

    1.2k GitHub starsUsed in 1 repo~2.3k tokens
    Sales & SupportAuto-check: notes
  • Etsy Shop Sales History

    sickn33/agentic-awesome-skills

    Read Etsy shop sales counters, deltas, and breakout flags from Apify Actor publicrecords/etsy-shop-velocity (MCP panel snapshot).

    47k GitHub starsUsed in 1 repo~1.2k tokens
    Sales & SupportAuto-check passed
  • Extract

    actionbook/actionbook

    Extract structured data from websites and produce an executable Playwright script plus extracted data.

    1.6k GitHub starsUsed in 2 repos~3.4k tokens
    Sales & SupportAuto-check passed
  • Agentkey

    chainbase-labs/Agentkey

    PROACTIVELY use whenever the user needs data outside your training set or requires a live network call — web search, URL scraping, news, social media (any platform), market prices…

    656 GitHub stars~2.3k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Apify Ecommerce

    sickn33/agentic-awesome-skills

    Extract product data, prices, reviews, and seller information from any e-commerce platform using Apify's E-commerce Scraping Tool.

    47k GitHub starsUsed in 2 repos~2.3k tokens
    Sales & SupportAuto-check: notes
  • Apify Ecommerce

    apify/awesome-skills

    Official

    Scrape e-commerce data for pricing, reviews, bestsellers, and seller discovery across 30+ platforms including Amazon, Walmart, eBay, Shopify, WooCommerce, and more.

    266 GitHub stars~4.6k tokensUpdated 18 days ago
    Sales & SupportAuto-check: notes

More from browser-act/skills

All 87 skills in this repo
  • Amazon ASIN Lookup

    browser-act/skills

    Fetches structured Amazon product details such as title, price, ratings and availability for a given ASIN through BrowserAct's lookup API template.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Amazon Best Sellers Finder

    browser-act/skills

    Extracts structured Amazon product data for a keyword and marketplace through the BrowserAct API, including titles, prices, ratings, reviews, sales volume and promotions.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Amazon Buy Box Monitor

    browser-act/skills

    Pulls Amazon product details, competing seller prices and seller ratings for a given ASIN through the BrowserAct API, without browser automation.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Analyzes a competitor's Amazon listing by ASIN with BrowserAct data extraction, then reports what it does well, where the market has gaps and opportunity points for your own listing.

    6.1k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Pulls structured Amazon search results (titles, ASINs, prices, ratings, specifications) for a keyword and brand through BrowserAct's Amazon Product API template.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Collects structured product data from Amazon search results for a keyword and optional brand, using a BrowserAct script, for market and competitor research.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Works with

Categories

Questions about Taobao Shop Catalog

What does Taobao Shop Catalog do?

Browse a Taobao or Tmall shop's product catalog by shopId, returning paginated product listings with itemId and title. Taobao Shop Catalog is an agent skill from browser-act/skills. Browse a Taobao or Tmall shop's product catalog by shopId, returning paginated product listings with itemId and title.

When should I use Taobao Shop Catalog?

Taobao Shop Catalog fits situations like: user asks to scrape a Taobao shop; get all products from a store; list items in a Taobao/Tmall shop; fetch shop catalog by userId.

How do I install Taobao Shop Catalog in Claude Code?

Run `npx skills add browser-act/skills --skill taobao-shop-catalog -a claude-code`. Or copy the skill folder (solutions/ecommerce/taobao-shop-catalog in browser-act/skills) into .claude/skills/taobao-shop-catalog in your project. Claude Code loads it when a task matches its description.

How do I install Taobao Shop Catalog in Codex?

Run `npx skills add browser-act/skills --skill taobao-shop-catalog -a codex`. Or copy the skill folder (solutions/ecommerce/taobao-shop-catalog in browser-act/skills) into .agents/skills/taobao-shop-catalog in your project. Codex loads it when a task matches its description.

Can I use Taobao Shop Catalog 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 browser-act/skills --skill taobao-shop-catalog -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/taobao-shop-catalog, .gemini/skills/taobao-shop-catalog, .github/skills/taobao-shop-catalog and .opencode/skills/taobao-shop-catalog in your project.

What does Taobao Shop Catalog need to run?

Going by SKILL.md and its folder, Taobao Shop Catalog needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Taobao Shop Catalog access the network?

SKILL.md names 3 domains. In commands or code: taobao.com, img.alicdn.com and detail.tmall.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Taobao Shop Catalog 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 Taobao Shop Catalog use?

Taobao Shop Catalog 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 Taobao Shop Catalog use?

About 1.4k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Taobao Shop Catalog?

Skills that share tags, products or a category with Taobao Shop Catalog: Product Reel Generator (gooseworks-ai/goose-skills, 1.2k stars), Etsy Shop Sales History (sickn33/agentic-awesome-skills, 47k stars), Extract (actionbook/actionbook, 1.6k stars) and Agentkey (chainbase-labs/Agentkey, 656 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Taobao Shop Catalog?

browser-act (a GitHub organization) maintains it in browser-act/skills, which has 6,126 GitHub stars. The repository holds 87 skills in this directory. The repository was last updated on August 24, 2026.

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