Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Vladimir-Human/ru-marketplace-mcp --skill taobao-connector -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/taobao-connector/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/taobao-connector/

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

Similar skills

All skills for Browser and scraping →

From the same set16

The whole set →
yandex-connector The yandex-connector Claude Code skill retrieves Yandex Market prices, ratings, and reviews. It activates for requests to compare seller offers or inspect product feedback. CX Codex +1 ★ 203repo stars wb-connector wb-connector is a Claude Code skill that retrieves Wildberries product, seller, and category data. It activates for price checks, review analysis, and SKU comparisons. CX Codex +1 ★ 203repo stars ozon-connector The ozon-connector Claude Code skill retrieves Ozon product cards, prices, ratings, and reviews. It activates for marketplace searches and requests to compare listings. CX Codex +1 ★ 203repo stars mpstats-connector The mpstats-connector Claude Code skill retrieves MPStats sales and stock data for Ozon or Wildberries products. It activates for SKU-level sales questions, including requests about a 30-day period. CX Codex +1 ★ 203repo stars megamarket-connector The megamarket-connector Claude Code skill searches Megamarket listings and reads product pages. It activates for requests about Megamarket, its catalog, or prices. CX Codex +1 ★ 203repo stars marketplace A Claude Code skill for setting up one MCP server across marketplace connectors and routing requests. It sends price-comparison queries to compare-prices and skips single-source tasks. CX Codex +1 ★ 203repo stars lamoda-connector The lamoda-connector Claude Code skill searches Lamoda products and retrieves product-card details. Search uses a Lamoda query; a card lookup takes a SKU or URL. CX Codex +1 ★ 203repo stars dns-connector The dns-connector Claude Code skill searches DNS-Shop’s electronics catalog and reads product pages. It needs the operator’s Chrome connected over CDP. CX Codex +1 ★ 203repo stars

Project sponsors

Companies that keep this analytics open