Goofish (Xianyu) Marketplace

io.github.zen-studio-labs由 GitHub 账号 zen-studio-labs 发布v0.1.0更新于 Oct 31, 2026

Goofish (Xianyu, 闲鱼) second-hand listings, item details, seller reviews, comments, image search.

已验证Streamable HTTP可网页运行网页搜索与抓取商业与电商

概览

AI 生成的概览

托管型 MCP 服务器，让助手搜索闲鱼（Goofish）二手商品、查看商品详情、卖家评价、留言以及以图搜图。

可以做什么
  • 按关键词搜索商品，支持价格、地区、发布时间、个人闲置、包邮、全新、验货宝等筛选
  • 读取商品完整详情，包括描述、全部图片、成色、浏览与想要数、运费和卖家资料
  • 查询卖家资料、信用标识、含已售出的商品分组以及交易评价
  • 根据提供的图片查找外观相似的商品，可按品牌或型号缩小范围
  • 读取商品下的公开留言、卖家回复和“问大家”问答
适用场景
适合二手价格调研、转卖或代购前的核查、品牌保护、市场调研，以及在下单前了解卖家情况。适合需要结构化闲鱼商品数据、但不想使用闲鱼账号或 Cookie 的助手。
运行要求
使用 mcp.apify.com 上的远程 streamable HTTP 端点，无需安装。需要一个免费的 Apify 账号并在浏览器中完成 Apify OAuth 登录；若无法登录，可在 Authorization 请求头中提供 Apify 令牌。需要网络访问。
安装前请注意
每条返回的商品都会计入你的 Apify 账户费用，测试时请保持小规模并使用 maxItems 等结果上限；免费套餐对运行次数和单次结果数有限制。Apify 登录页会提示该客户端为动态注册且未经 Apify 验证，并请求账户的完整 API 访问权限，可在 Apify 控制台随时撤销。Authorization 请求头中的 Apify 令牌属于机密，请勿共享。所有工具均为只读，不会下单、联系卖家或发布商品。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Goofish (Xianyu) Marketplace，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.zen-studio-labs%2Fgoofish-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "goofish-xianyu-marketplace": {
      "type": "http",
      "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"
    }
  }
}

README

[Zen Studio logo]

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.

[Apify Store users] [Remote MCP server] [Validate] [License: MIT]

[Install in Cursor] [Install in VS Code] [Install in VS Code Insiders] [Claude Code plugin]

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.

[Claude Code finds used Sony A7 III cameras on Goofish and shows five options in a table]

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:
    text
    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
  3. 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 "<server URL>", then codex mcp login goofish.
    • VS Code: code --add-mcp '{"name":"goofish","type":"http","url":"<server URL>"}'.
    • Cursor and other clients: add {"mcpServers": {"goofish": {"url": "<server URL>"}}} to the client's MCP config file (Cursor: ~/.cursor/mcp.json).
  4. 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.
  5. 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.
  6. 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.
Goofish MCPTypical self-hosted Xianyu tools
Goofish account or cookiesNot neededUsually required
SetupOne URL and an Apify sign-inPython or Node, a local browser, exported cookies
Web assistants (claude.ai, ChatGPT)SupportedUsually desktop clients only
Image search and buyer Q&AIncludedRarely available

Tools

ToolWhat you getStore page
Listing searchListings for any keyword with price, condition, location, photos and seller stats. Filters for price, region, recency, personal sellers, free shipping, brand new and inspection verified.goofish-xianyu-search-scraper
Item details150+ fields per listing: full description, every image, condition grade, views and wants, shipping, seller profile.goofish-xianyu-item-detail-scraper
Seller profileSeller stats, credit badges, every listing tab including sold items, and transaction reviews.goofish-xianyu-seller-scraper
Image searchListings that look like a photo you provide, optionally narrowed by brand or model.goofish-xianyu-visual-search-scraper
Comments and Q&AThe public comment thread under a listing, seller replies, and buyer Q&A (问大家).goofish-xianyu-item-comments-scraper

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

Quick start

  1. Create a free Apify account 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:

text
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):

text
/plugin marketplace add zen-studio-labs/goofish-mcp/plugin install goofish@goofish-mcp

Server only:

bash
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.

Codex
bash
codex mcp add goofish --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"codex mcp login goofish

Or copy examples/codex-config.toml into ~/.codex/config.toml.

Other clients, or a token instead of sign-in

Most clients that support remote MCP servers accept:

json
{  "mcpServers": {    "goofish": {      "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"    }  }}

If your client cannot complete the Apify sign-in, send your Apify token as a header instead, see examples/bearer-token-mcp.json. Copy the token from your Apify Console integrations page and keep it out of shared files. Clients that only run local servers can bridge with mcp-remote, see examples/claude-desktop-config.json.

Use it from code

Each tool is also an Apify Actor with a REST API, so you can call it from your own code, a pipeline or an automation, without an assistant. Copy your API token from the Apify Console integrations page. The input fields are the same ones the assistant uses; each Store page has an API tab with ready-made code and the full input reference.

Python
bash
pip install apify-client
python
import osfrom apify_client import ApifyClient
client = ApifyClient(os.environ["APIFY_TOKEN"])run = client.actor("zen-studio/goofish-xianyu-search-scraper").call(    run_input={"keyword": "iPhone 15 Pro", "maxItems": 20, "sortBy": "priceAsc"})for item in client.dataset(run["defaultDatasetId"]).iterate_items():    print(item["price"], item["title"], item["url"])
JavaScript and TypeScript
bash
npm install apify-client
js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });const run = await client.actor('zen-studio/goofish-xianyu-search-scraper').call({    keyword: 'iPhone 15 Pro',    maxItems: 20,    sortBy: 'priceAsc',});const { items } = await client.dataset(run.defaultDatasetId).listItems();console.log(items);
HTTP

Start a run and get its results in one request:

bash
curl -X POST "https://api.apify.com/v2/acts/zen-studio~goofish-xianyu-search-scraper/run-sync-get-dataset-items" \  -H "Authorization: Bearer $APIFY_TOKEN" \  -H "Content-Type: application/json" \  -d '{"keyword": "iPhone 15 Pro", "maxItems": 20}'

This waits up to 300 seconds. For bigger runs, start the run asynchronously and read its dataset when it finishes, see the Apify API reference.

n8n, Make and Zapier

Use Apify's official integration for n8n, Make or Zapier, choose the Actor (for example zen-studio/goofish-xianyu-search-scraper) and pass the same JSON input.

Other tools: replace the Actor ID with zen-studio/goofish-xianyu-item-detail-scraper, zen-studio/goofish-xianyu-seller-scraper, zen-studio/goofish-xianyu-visual-search-scraper or zen-studio/goofish-xianyu-item-comments-scraper.

Example prompts

Tip: write search terms the way sellers write titles. Use Chinese for Chinese brands and categories (小米, 乐高, 手机); international names such as iPhone 15 Pro work as they are.

Use cases

  • Used-price research. Typical asking prices for a model by condition and city, before you buy or sell.
  • Reselling and cross-border buying (代购). Spot underpriced listings and check the seller before you commit.
  • Brand protection. Find listings of your products, including look-alikes, by keyword or by photo.
  • Market research. Read demand from views and wants across a category or a set of models.
  • Seller checks. Credit level, sales count, response rate and recent reviews in one answer.

Example output

One search row, abridged. Your assistant reads rows like this and answers in plain language.

json
{  "id": "1000000000001",  "title": "索尼 A7M3 单机身 快门1.2万 几乎全新 带原装电池",  "price": 6280,  "currency": "CNY",  "city": "上海",  "condition": { "label": "几乎全新" },  "postedAt": "2026-10-28T19:42:11+08:00",  "freeShipping": true,  "stats": { "views": 412, "wants": 23 },  "seller": {    "name": "摄影器材闲置",    "creditLabel": "极好",    "zhimaVerified": true,    "stats": { "totalSold": 37, "goodReviewRate": "99%" }  },  "url": "https://www.goofish.com/item?id=1000000000001"}

Each tool's Store page lists every field.

How long requests work

Each tool call returns within about 45 seconds. Bigger requests keep running on Apify after that, and your assistant checks back until the results are ready, then reads them in pages. You may see a few "still running" updates; that is expected. The Goofish skill teaches assistants this flow, along with input recipes for each tool. Claude Code gets it with the plugin.

Pricing

Pay per result, billed to your Apify account. There is no subscription to this repository. Current prices, including volume discounts, are on each tool's pricing page:

Your assistant controls cost through result caps such as maxItems. Ask for a small number first, then scale up.

Free Apify plan: each tool allows a limited number of runs and caps the results per run (a search returns up to 30 listings). Your assistant tells you when a run hit the cap. Any paid Apify plan removes these limits.

Troubleshooting

  • /mcp says the server is not authenticated, or its tools could not be fetched. Select the server and choose Authenticate. Other clients show a Connect or Sign in button.
  • A search returns nothing. Use Chinese for Chinese brands (小米, not xiaomi), widen the price range, or remove filters.
  • A search stops at 30 listings. That is the free Apify plan cap. Any paid plan removes it.
  • Your assistant says a run is still going. That is normal for bigger requests. Ask it to keep checking the same run; a new search for the same question is billed again.
  • Your client cannot complete the sign-in. Use an Apify token header instead, see Other clients.

FAQ

What is Goofish? Goofish (goofish.com) is the web name of Xianyu (闲鱼), Alibaba's second-hand marketplace, also known as Idlefish. People buy and sell used phones, cameras, consoles, collectibles, fashion and almost anything else on it.

Do I need a Goofish account or a Chinese phone number? No. You only need an Apify account, which takes a minute to create.

Can I use it outside China? Yes, from any country. Listings are mostly in Chinese and priced in CNY; ask your assistant to translate titles and convert prices.

Which AI assistants work with it? Any client that supports remote MCP servers, including Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, Codex, Cursor, VS Code with GitHub Copilot and many more.

Is there a Goofish API? Yes. Every tool can be called over a REST API or with Apify's Python and JavaScript clients, see Use it from code.

Is it free? You can try it on Apify's free plan, with a limited number of runs per tool. After that you pay per result; see Pricing.

Can I track prices over time? Yes. Ask your assistant to repeat a search and compare, or schedule the search on Apify and compare its runs.

Is this an official Goofish product? No. Goofish MCP is an independent product by Zen Studio and is not affiliated with Goofish, Xianyu or Alibaba.

Privacy

Requests go to Apify's hosted MCP server and run on your Apify account. Apify's privacy policy applies. This repository contains configuration and instructions only; it collects nothing.

中文说明

闲鱼 (Goofish / Xianyu) 数据，直接在 AI 助手里使用。 支持 Claude、Claude Code、ChatGPT、Codex、Cursor、VS Code 等所有支持远程 MCP 服务器的客户端。

无需闲鱼账号，无需登录，无需 Cookie，无需安装。 只需登录一次 Apify 账号，按结果计费。

可以做什么：

  • 商品搜索：按关键词搜索闲鱼商品，返回价格、成色、地区、图片和卖家数据；支持价格、地区、发布时间、个人闲置、包邮、全新、验货宝等筛选。
  • 商品详情：每个商品 150+ 字段，包括完整描述、全部图片、成色、浏览和想要数、卖家信息。
  • 卖家信息：卖家资料、信用、全部商品分组（含已售出）及交易评价。
  • 以图搜图：上传或提供图片链接，找到外观相似的闲鱼商品。
  • 留言与问大家：商品下的公开留言、卖家回复和“问大家”。

所有工具均为只读，不会下单、联系卖家或发布商品。

三步开始：

  1. 注册免费的 Apify 账号。
  2. 点击上方的安装按钮，或在客户端中添加以下服务器地址：
    text
    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
  3. 客户端提示时登录 Apify，然后直接提问，例如：“在闲鱼上搜索 5000 到 8000 元的二手索尼 A7 III 机身，只看个人卖家，用表格列出五个最值得考虑的。”

提示：搜索关键词请使用卖家在标题中的写法。中国品牌请用中文（如 小米、华南金牌），拼音无法匹配。

登录说明：Apify 授权页面会提示该应用为“动态注册、未经 Apify 验证”，并请求完整的 API 访问权限。所有以这种方式登录的 AI 助手都会看到这一提示。授权可随时在 Apify 控制台集成页面 撤销。

价格：按结果计费，详见上方各工具的 Apify 定价页面。Apify 免费套餐下，每个工具的运行次数有限，且每次运行的结果数有上限（搜索最多返回 30 条）；任何付费套餐均无此限制。

代码调用：每个工具都是 Apify Actor，可通过 REST API、Python 或 JavaScript 客户端以及 n8n、Make、Zapier 直接调用，示例见上方 Use it from code。

常见问题：

  • 需要闲鱼账号或中国手机号吗？ 不需要，只需一个 Apify 账号。
  • 在中国以外可以使用吗？ 可以，任何国家和地区均可使用。
  • 可以追踪价格变化吗？ 可以。让 AI 助手重复同一搜索并对比，或在 Apify 上设置定时任务。
  • 这是闲鱼官方产品吗？ 不是。Goofish MCP 由 Zen Studio 独立开发，与闲鱼、Goofish 及阿里巴巴无关联。

More from Zen Studio

Goofish MCP is built on Zen Studio's Apify Actors. You can also run each tool directly on Apify, from its API, or on a schedule.

License

MIT. Goofish, Xianyu and Alibaba are trademarks of their respective owners.

来源：README.md，提交 4c69965

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.1.0最新Oct 31, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分