Agent skill

Taobao Keyword Search

by browser-act in browser-act/skills

Search Taobao and Tmall product listings by keyword, returning paginated product cards with title, price, shop, image, sales, and tags.

MITAuto-check passedSales & Support

Install Taobao Keyword Search

skills CLI
$ npx skills add browser-act/skills --skill taobao-keyword-search -a claude-code

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

GitHub CLI
$ gh skill install browser-act/skills taobao-keyword-search --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-keyword-search .claude/skills/taobao-keyword-search && 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-keyword-search
GitHub stars
6.1k
Token cost
~1.6k tokens
SKILL.md length
696 words
Files
2 (incl. scripts)
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

Search Taobao and Tmall product listings by keyword, returning paginated product cards with title, price, shop, image, sales, and tags.

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

What it does

Taobao Keyword Search is an agent skill from browser-act/skills. Search Taobao and Tmall product listings by keyword, returning paginated product cards with title, price, shop, image, sales, and tags. Use when user asks to search Taobao, find products on Taobao/Tmall, scrape Taobao search results, get product listings from Taobao, collect Taobao items by keyword, 搜索淘宝, 淘宝关键词搜索, 采集淘宝商品, 抓取淘宝搜索结果, 淘宝天猫商品列表. Also applies to bulk keyword searches, price monitoring across keywords, and competitive product research on Taobao.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/search-products.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 search Taobao
  • Find products on Taobao/Tmall
  • Scrape Taobao search results
  • Get product listings from Taobao

Example prompts

  • “/taobao-keyword-search”

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:

    • s.taobao.com
    • taobao.com
    • item.taobao.com
    • img.alicdn.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 Keyword Search loads about 1.6k tokens when it runs. Until then it costs about 121 tokens; SKILL.md has 696 words of instructions outside code blocks.

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

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). 696 words, ~1,583 tokens.

Download SKILL.mdSave it as .claude/skills/taobao-keyword-search/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
taobao-keyword-search
description
Search Taobao and Tmall product listings by keyword, returning paginated product cards with title, price, shop, image, sales, and tags. Use when user asks to search Taobao, find products on Taobao/Tmall, scrape Taobao search results, get product listings from Taobao, collect Taobao items by keyword, 搜索淘宝, 淘宝关键词搜索, 采集淘宝商品, 抓取淘宝搜索结果, 淘宝天猫商品列表. Also applies to bulk keyword searches, price monitoring across keywords, and competitive product research on Taobao.

keyword + optional filters → paginated product listing (itemId, title, price, shop, image, sales)

Language

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

Objective

Search Taobao/Tmall for products by keyword and extract product cards from search results pages.

Prerequisites

  • Target page is already open in the browser: https://s.taobao.com/search
  • 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 (e.g., "心林vs妞妞") → logged in, continue execution
  • "亲,请登录" or 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: product search results (data extraction)

Navigate to search results URL, then extract:

  1. navigate "https://s.taobao.com/search?q={keyword}&page={page}&ie=utf8"
  2. wait stable
  3. eval "$(python scripts/search-products.py '{keyword}' --page {page} --sort '{sort}' --tab '{tab}' --start-price {startPrice} --end-price {endPrice})"

URL Parameters:

  • q: URL-encoded keyword
  • page: page number, 1-based, default 1
  • sort: sort order — empty string (default/recommended), sale-desc (by sales), price-asc (price low→high), price-desc (price high→low)
  • tab: mall for Tmall-only results; omit for all results
  • startPrice / endPrice: price range filter in yuan (e.g., startPrice=100&endPrice=500)

Output example:

json
[
  {
    "itemId": "694593508978",
    "itemUrl": "https://item.taobao.com/item.htm?id=694593508978",
    "title": "蓝牙耳机2025新款官方",
    "subTitle": "AI耳机热卖榜第1名",
    "priceYuan": 79.9,
    "priceDesc": "券后价",
    "imageUrl": "https://img.alicdn.com/imgextra/...",
    "salesCount": "40万+人付款",
    "shopName": "金运旗舰店",
    "location": "广东",
    "rating": null,
    "tags": ["政府补贴15%", "官方立减26元"]
  }
]

Notes:

  • priceYuan is the displayed price (may be post-coupon price, not pre-coupon)
  • priceDesc indicates price type: 券后价 (after coupon), 补贴价 (subsidized price), etc.
  • rating is rarely shown on search cards; null is expected
  • Sponsored/ad items have itemUrl pointing to click.simba.taobao.com — they will have itemId extracted from query params

Enum Parameters

[collection failed] sort values: confirmed values are empty string (default), sale-desc, price-asc, price-desc; no API for enumeration, values are hardcoded constants.

Pagination

URL Pagination: URL pattern https://s.taobao.com/search?q={keyword}&page={N}&ie=utf8, increment page from 1. Each page returns ~47 items. Termination: when result count < 10 or returned items duplicate previous page.

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

Success Criteria

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

Known Limitations

  • Requires Taobao login; unauthenticated sessions redirect to login page
  • Prices shown are displayed prices (may be post-coupon), not pre-discount prices
  • Sponsored/ad items appear at unpredictable positions in results
  • Price filter (startPrice/endPrice) filters on pre-coupon prices, so post-coupon prices displayed may fall outside the requested range near boundaries
  • Taobao may return different result counts across pages; page count is approximate

Execution Efficiency

  • Batch orchestration: Write a bash script to loop through keywords serially within a single session; do not parallelize within one browser (prone to triggering anti-scraping restrictions). Add 2–3 second intervals between page navigations. To increase throughput, open multiple stealth browser sessions and distribute keywords across them.
  • Test before batch execution: After writing a batch script, you must first test with 1–2 keywords to verify the script runs correctly; only then run the full batch. Never skip testing and execute in batch directly.
  • Reduce redundant pre-operations: When scraping multiple pages for one keyword, navigate page 2, 3 etc. within the same session without re-login checks.
  • Error resumption: Save results item by item during batch processing; on failure, resume from the breakpoint rather than starting over.

Experience Notes

Path: {working-directory}/browser-act-skill-forge-memories/taobao-keyword-search.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-keyword-search of browser-act/skills.

  • SKILL.md
  • scripts/search-products.py

Open the folder on GitHubat commit 11c057b

Compare with similar skills

Taobao Keyword Search 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 Keyword Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Taobao Keyword Search this skillbrowser-act/skills6.1k—~1.6kAutomated 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 Keyword Search

What does Taobao Keyword Search do?

Search Taobao and Tmall product listings by keyword, returning paginated product cards with title, price, shop, image, sales, and tags. Taobao Keyword Search is an agent skill from browser-act/skills. Search Taobao and Tmall product listings by keyword, returning paginated product cards with title, price, shop, image, sales, and tags.

When should I use Taobao Keyword Search?

Taobao Keyword Search fits situations like: user asks to search Taobao; find products on Taobao/Tmall; scrape Taobao search results; get product listings from Taobao.

How do I install Taobao Keyword Search in Claude Code?

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

How do I install Taobao Keyword Search in Codex?

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

Can I use Taobao Keyword Search 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-keyword-search -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-keyword-search, .gemini/skills/taobao-keyword-search, .github/skills/taobao-keyword-search and .opencode/skills/taobao-keyword-search in your project.

What does Taobao Keyword Search need to run?

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

Does Taobao Keyword Search access the network?

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

Is Taobao Keyword Search 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 Keyword Search use?

Taobao Keyword Search 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 Keyword Search use?

About 1.6k tokens (SKILL.md is roughly 6.3k 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 Keyword Search?

Skills that share tags, products or a category with Taobao Keyword Search: 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 Keyword Search?

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.