Skip to content

MCP server

FishClaw MCP

MCP server that automates Xianyu (Goofish) listings via Playwright, letting an AI client publish products, manage listings, and search competitor prices.

  • Community
  • Runs locally
  • API key

Repository and documentation last checked Built from public product pages and documentation. Sources

ecommerceguide summary

FishClaw MCP drives Xianyu (Goofish) through a Playwright browser session so an MCP client can search the marketplace, fill a product draft, publish it, list items on sale and delist or delete them. It runs locally over stdio from a cloned Python repo started with uv or python, signs in by QR code scan, and needs an Alibaba Cloud DashScope API key for copy and cover image generation.

Why it stands out

Community MCP server that automates Xianyu through a visible Playwright browser and QR code login rather than a marketplace API.

What FishClaw MCP does

ecommerceguide editorial
  • Tools cover draft_item, publish_item, get_selling_items and manage_item
  • search_market collects Xianyu titles, prices and links by keyword
  • Generates product descriptions and cover images via DashScope (qwen-max, z-image-turbo)
  • Publishing and deleting items are marked irreversible in the docs
  • Setup steps given for Claude Desktop and Cursor configs
  • Community project by TnoobT, Python with FastMCP and Playwright stealth
  • Optional simulate_farming tool only registers when ENABLE_FARMING=true
  • No licence file; README states it is for learning use only

How ecommerce teams could use it

ecommerceguide editorial

Illustrative scenarios written by ecommerceguide from the product's documented capabilities. They are not customer case studies.

  1. Xianyu seller working from Claude Desktop

    Preparing a new listing, including cover image, description, category and price, then publishing it

    Intended outcomeFishClaw generates the description and cover image through DashScope, fills the draft form, screenshots it for confirmation, then publishes on a separate instruction.

  2. Xianyu seller checking competitor pricing from Cursor

    Researching how similar items are priced before setting a price

    Intended outcomesearch_market collects titles, prices and links for a keyword so the client can summarise current listings.

  3. Xianyu seller tidying up active listings

    Reviewing what is currently on sale and removing items that have sold elsewhere

    Intended outcomeget_selling_items returns the active listings and manage_item delists or permanently deletes a chosen item.

Who it suits

ecommerceguide editorial

Best for

You sell on Xianyu, work in Claude Desktop or Cursor, and can run a local Python server with a DashScope API key.

Probably not for

You need a marketplace other than Xianyu, a hosted endpoint, a licence, or a tool the author permits for commercial use.

Business size
Any stageA self-run community repo with no pricing and no stated audience size.
Verticals
Marketplaces

Technical details

From the vendor's own pages

From the server's repository, documentation and MCP directory listings.

What an agent can do
Manage products, Product content, Analytics
Transport
stdio (local)
Authentication
API keyEdit .env and set AGENT_LLM_API_KEY (DashScope API key); Xianyu login via QR code scan in browser.
Package
fishclaw-mcp
Language
Python
Repository last updated
6 Mar 2026

Connect FishClaw MCP

Third-party data

Setup documented for

Install command
git clone https://github.com/your-username/fishclaw-mcp.git && uv sync

Command as listed on the repository README, not tested by ecommerceguide. Check the repository README (opens in a new tab) for configuration and credentials before running it.

Categories and use cases