taobao-keyword-search
Search Taobao and Tmall product listings by keyword, returning paginated product cards with title, price, shop, image, sales, and tags
Install / Use
npx skills add browser-act/skills --skill taobao-keyword-searchInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OperationsSupported Platforms
Our assessment of taobao-keyword-search
taobao-keyword-search scores 91/100 on our quality scale, 256th of 746 Operations skills we index (top 35%).
Its SKILL.md is 6.2 KB long, well organised into 15 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.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so taobao-keyword-search 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 foundOur 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.
taobao-keyword-search compared with similar skills
All 4 of these similar skills score higher than taobao-keyword-search; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| taobao-keyword-search (this skill)by browser-act | 91 | 6.0k | 3mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| LocalAIby mudler | 100 | 50.4k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install taobao-keyword-search?
- Run
npx skills add browser-act/skills --skill taobao-keyword-search. The install tabs above show the steps for each supported agent. - Which AI agents does taobao-keyword-search 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 taobao-keyword-search 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 taobao-keyword-search still maintained?
- The repository was last updated about 3 months ago, so taobao-keyword-search is actively maintained.
Skill content
View source on GitHubname: 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."
Taobao — Keyword Search
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 viaeval "$(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:
navigate "https://s.taobao.com/search?q={keyword}&page={page}&ie=utf8"wait stableeval "$(python scripts/search-products.py '{keyword}' --page {page} --sort '{sort}' --tab '{tab}' --start-price {startPrice} --end-price {endPrice})"
URL Parameters:
q: URL-encoded keywordpage: page number, 1-based, default1sort: sort order — empty string (default/recommended),sale-desc(by sales),price-asc(price low→high),price-desc(price high→low)tab:mallfor Tmall-only results; omit for all resultsstartPrice/endPrice: price range filter in yuan (e.g.,startPrice=100&endPrice=500)
Output example:
[
{
"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:
priceYuanis the displayed price (may be post-coupon price, not pre-coupon)priceDescindicates price type:券后价(after coupon),补贴价(subsidized price), etc.ratingis rarely shown on search cards; null is expected- Sponsored/ad items have
itemUrlpointing toclick.simba.taobao.com— they will haveitemIdextracted 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.
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.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
LocalAI
50.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
