Goofish (Xianyu) Marketplace

Goofish MCP Server

Search Goofish (Xianyu, 闲鱼), China's largest second-hand marketplace, from Claude, ChatGPT, Cursor, VS Code, any MCP client or your own code.

Quick start · Agent setup · Tools · Client setup · Use from code · Pricing · FAQ · 中文说明

Goofish MCP connects your AI assistant to Goofish, the marketplace also known as Xianyu (闲鱼) and Idlefish. Ask in English or Chinese: your assistant searches listings, compares used prices, reads full item details, checks a seller's history and reviews, reads buyer questions, and finds listings that match a photo. Results come back as structured rows it can sort, filter, translate and summarise.

Set up with your AI agent

Paste this repository's URL into Claude Code, Codex, Cursor or another agent and ask it to set up Goofish. The steps below are written so your agent can follow them.

For AI agents installing this server:

1. This is a hosted remote MCP server (streamable HTTP). There is nothing to download or build. It needs a free Apify account and an Apify sign-in (OAuth) in the user's browser; do not ask for an API token unless the sign-in fails.
2. Server name goofish, server URL:

   https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,get-dataset-list,zen-studio/goofish-xianyu-search-scraper,zen-studio/goofish-xianyu-item-detail-scraper,zen-studio/goofish-xianyu-seller-scraper,zen-studio/goofish-xianyu-visual-search-scraper,zen-studio/goofish-xianyu-item-comments-scraper

1. Add it with the client's own command:

• Claude Code: claude plugin marketplace add zen-studio-labs/goofish-mcp, then claude plugin install goofish@goofish-mcp (adds the server and the Goofish skill).
• Codex: codex mcp add goofish --url " ", then codex mcp login goofish.
• VS Code: code --add-mcp '{"name":"goofish","type":"http","url":" "}'.
• Cursor and other clients: add {"mcpServers": {"goofish": {"url": " "}}} to the client's MCP config file (Cursor: ~/.cursor/mcp.json).

1. Ask the user to complete the sign-in. In Claude Code they run /mcp, select goofish and choose Authenticate; other clients open the Apify sign-in page themselves. A client restart may be needed before the tools appear.
2. Check it works with a small search, for example keyword: "iPhone 15 Pro", maxItems: 5. Every returned listing is billed to the user's Apify account, so keep test runs small.
3. Before real searches, read the Goofish skill: it explains how long runs work and which inputs return good results.

Why Goofish MCP

• No Goofish account. No login, no cookies, no Chinese phone number. Your own Goofish account is never involved.
• Nothing to install. A hosted remote MCP server: add one URL and sign in with Apify. Works in claude.ai and ChatGPT, not only in desktop apps.
• Five tools in one server. Listing search, item details, sellers and reviews, image search, and comments with buyer Q&A (问大家).
• Rich, structured data. 150+ fields per listing: price, condition, location, views and wants, shipping, seller credit, sales and response rate.
• Made for assistants. A bundled skill teaches your assistant the inputs that work, and long requests keep running while it checks back.
• Pay per result. Billed to your own Apify account. Try it on Apify's free plan.

Tools

All tools are read-only. They never buy, message sellers or post listings.

Quick start

1. Create a free [Apify account](https://console.apify.com/sign-up) if you do not have one.
2. Add the server to your assistant. Click a button above, or follow the steps for your client below.
3. Sign in with Apify when your assistant asks, then ask a question such as *"Find used Sony A7 III camera bodies on Goofish between ¥5,000 and ¥8,000 from personal sellers and show five good options in a table."*

About the Apify sign-in page. Apify notes that your assistant "was registered dynamically and wasn't verified by Apify" and asks for full API access. Every assistant that signs in this way sees that notice; it lets your assistant start runs on your account. You can remove the access at any time on your Apify Console integrations page.

Server URL, for any client that accepts a remote MCP server:

https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,get-dataset-list,zen-studio/goofish-xianyu-search-scraper,zen-studio/goofish-xianyu-item-detail-scraper,zen-studio/goofish-xianyu-seller-scraper,zen-studio/goofish-xianyu-visual-search-scraper,zen-studio/goofish-xianyu-item-comments-scraper

Client setup

Claude (claude.ai and Claude Desktop)

1. Open Settings > Connectors and select Add custom connector.
2. Name it Goofish and paste the server URL above.
3. Select Connect and sign in with Apify.
4. In a chat, enable the Goofish connector from the tools menu.

The connector syncs between claude.ai and Claude Desktop. Custom connector availability depends on your Claude plan. For better results, also add the Goofish skill: zip the skills/goofish folder and upload it under Skills in Claude's settings.

Claude Code

Plugin (server plus the Goofish skill, recommended):

/plugin marketplace add zen-studio-labs/goofish-mcp

/plugin install goofish@goofish-mcp

Server only:

claude mcp add --transport http goofish "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,get-dataset-list,zen-studio/goofish-xianyu-search-scraper,zen-studio/goofish-xianyu-item-detail-scraper,zen-studio/goofish-xianyu-seller-scraper,zen-studio/goofish-xianyu-visual-search-scraper,zen-studio/goofish-xianyu-item-comments-scraper"

Then sign in: run /mcp, select the goofish server and choose Authenticate. Until you do, /mcp lists the server as not authenticated and may say its tools could not be fetched; both clear once you sign in.

Cursor

Click Install in Cursor above, or add examples/cursor-mcp.json to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Cursor asks you to sign in with Apify on first use.

VS Code and GitHub Copilot

Click Install in VS Code above, or add examples/vscode-mcp.json to .vscode/mcp.json. Start the server from the MCP view and sign in with Apify when prompted. Use the tools in Copilot Chat agent mode.

ChatGPT

1. Open ChatGPT Plugins, select +, then Add custom MCP server.
2. Name it Goofish, paste the server URL above, and choose OAuth authentication.
3. Confirm, create the plugin, and sign in with Apify.
4. In a new chat, type @ and select Goofish.

Business, Enterprise and Edu workspaces may need an admin to enable custom servers. See OpenAI's custom MCP server guide.

<summa