taobao-connector — Claude Code skill: search and setup
The taobao-connector Claude Code skill searches Taobao listings and reads product pages. It activates for requests about Taobao items, prices, or shops.
MIT ★ 203 updated 2026-10-19
npx skills add Vladimir-Human/ru-marketplace-mcp --skill taobao-connector -a claude-codeWhat taobao-connector does
The skill searches Taobao with Chinese or English text and fetches an item's page. Use taobao_search(query, page) for listings and taobao_card(item_id_or_url) for a product card. The card tool accepts a 9–13 digit item ID as a string or a Taobao item URL.
Prices are returned in yuan, with no currency conversion. When a listing hides its price, price_cny is None, not zero. The operator's Chrome must be running with CDP and logged in to Taobao; start it with uvx ru-marketplace-mcp browser start or scripts/start_chrome_cdp.sh, then use uvx ru-marketplace-mcp unblock taobao to log in. A CAPTCHA or login wall returns challenge_required and requires user action. In DeepSeek Harness, the connector's tools require RU_MARKETPLACE_MCP_FULL=1 and a profile restart.
What it helps with
- search Taobao listings by Chinese or English text
- read a product's price and description
- identify the shop and sales label
- retrieve images from a product description
Example prompts for the agent
- Search Taobao for leather bags
- Find the price and shop for item ID
123456789 - Read this Taobao product page and list its description images
How to install taobao-connector
1Skills CLI (Vercel)
npx skills add Vladimir-Human/ru-marketplace-mcp --skill taobao-connector -a claude-code2Manually: put the files in place
~/.claude/skills/taobao-connector/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/taobao-connector/
1Skills CLI (Vercel)
npx skills add Vladimir-Human/ru-marketplace-mcp --skill taobao-connector -a codex2Manually: put the files in place
.agents/skills/taobao-connector/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Vladimir-Human/ru-marketplace-mcp --skill taobao-connector -a cursor2Manually: put the files in place
.cursor/skills/taobao-connector/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Vladimir-Human/ru-marketplace-mcp skills/taobao-connector2Manually: put the files in place
.github/skills/taobao-connector/SKILL.md1Skills CLI (Vercel)
npx skills add Vladimir-Human/ru-marketplace-mcp --skill taobao-connector -a gemini-cli2Platform CLI
gemini skills install https://github.com/Vladimir-Human/ru-marketplace-mcp --path skills/taobao-connectorManually: put the files in place
.devin/skills/taobao-connector/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Vladimir-Human/ru-marketplace-mcp --skill taobao-connector -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about taobao-connector
How do I install taobao-connector in Claude Code?
Run npx skills add Vladimir-Human/ru-marketplace-mcp --skill taobao-connector -a claude-code. The skill file is at ~/.claude/skills/taobao-connector/SKILL.md.
What does taobao-connector do?
It searches Taobao listings and retrieves product-card details, including price, shop, sales label, and description images. Prices remain in yuan.
What does taobao-connector need to run?
It needs the operator's Chrome running with CDP and logged in to Taobao. Start Chrome with uvx ru-marketplace-mcp browser start or scripts/start_chrome_cdp.sh, then log in with uvx ru-marketplace-mcp unblock taobao.
Source text
SKILL.md · MIT
--- name: taobao-connector description: Use this skill when the operator needs Taobao marketplace data — search Chinese listings or read an item card. Trigger on Chinese or English queries like "taobao", "淘宝", "найди на таобао", "цена taobao". Always needs the operator's Chrome over CDP (signed mtop API). Skip for non-Taobao tasks. --- # Taobao Connector Reads Taobao inside the operator's own Chrome over CDP. The search page is a client-side React app whose data layer is the signed mtop API — every XHR wants a `sign` computed from the `_m_h5_tk` cookie, and unsigned probes answer `FAIL_SYS_TOKEN_EMPTY`. There is no anonymous tier; the site's own JS signs requests natively in a real browser. ## When to use - Search Taobao by Chinese or English text - One item's price, shop, sales label, description images ## Tools available - `taobao_search(query, page)` — listings. Prices are in YUAN (CNY), never converted: price_cny is None when hidden — never 0. - `taobao_card(item_id_or_url)` — one item card. item ids are 9-13 digit strings; pass a bare id or an item.taobao.com URL. **Not an MCP tool:** `taobao_selfcheck()` is a tri-state canary that renders one live search page. It is CLI-only — `marketplace-mcp doctor` runs every connector's canary at once. ## Gotchas - Prices stay in yuan. Comparing against ruble sources needs an explicit rate; a baked-in one would go silently stale. - A detected login/CAPTCHA wall returns `challenge_required` and `requires_user_action=true`. Complete it in the scraping profile before retrying the same operation. Failed payloads are not cached; a retry reads the browser again. Successful results still use the normal TTL cache. - With `CHROME_CHALLENGE_HANDOFF_S` enabled, `handoff_expires_at` confirms that the challenged search/card tab is retained. Complete its interaction, then repeat the same tool arguments in the same MCP session before expiry. No new navigation is issued for that resume; expiry never extends on retries. - The operator's Chrome must be running with CDP (`uvx ru-marketplace-mcp browser start` or `scripts/start_chrome_cdp.sh`; use `uvx ru-marketplace-mcp unblock taobao` to log in). ## DSH activation In DeepSeek Harness the default profile mounts `compare-mcp`, which exposes exactly 4 tools: `compare_prices`, `compare_sources`, `compare_verify_offer` and `compare_browser_snapshot`. The middle `decision-mcp` profile adds `decision_inspect` (5 tools). This connector's own tools and `marketplace_sources` need `RU_MARKETPLACE_MCP_FULL=1` and a profile restart; do not call them in the default mode.
© Vladimir-Human · MIT · Vladimir-Human/ru-marketplace-mcp