Goofish (Xianyu) Marketplace

Goofish MCP 服务

通过 Claude、ChatGPT、Cursor、VS Code、任何 MCP 客户端或你自己的代码，搜索 Goofish（Xianyu，闲鱼），中国最大的二手交易平台。

快速开始 · Agent 设置 · 工具 · 客户端设置 · 通过代码使用 · 定价 · 常见问题 · 中文说明

Goofish MCP 将你的 AI 助手连接到 Goofish，也称为 Xianyu（闲鱼）和 Idlefish 的交易平台。你可以用英文或中文提问：助手会搜索商品信息、比较二手价格、读取完整商品详情、查看卖家历史记录和评价、读取买家提问，还能根据照片查找匹配的商品。结果会以结构化数据行的形式返回，便于排序、筛选、翻译和汇总。

使用 AI Agent 进行设置

将此仓库的 URL 粘贴到 Claude Code、Codex、Cursor 或其他 Agent 中，并让它设置 Goofish。以下步骤旨在供 Agent 按照执行。

供安装此服务的 AI Agent 使用：

1. 这是一个托管的远程 MCP 服务（可流式传输的 HTTP）。无需下载或构建。它需要一个免费的 Apify 账户，并需用户在浏览器中通过 Apify 登录（OAuth）；除非登录失败，否则不要索要 API 令牌。
2. 服务名称 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
   

3. 使用客户端自带的命令添加：
   • Claude Code：claude plugin marketplace add zen-studio-labs/goofish-mcp，然后运行 claude plugin install goofish@goofish-mcp（添加服务和 Goofish 技能）。
   • Codex：codex mcp add goofish --url "<server URL>"，然后运行 codex mcp login goofish。
   • VS Code：code --add-mcp '{"name":"goofish","type":"http","url":"<server URL>"}'。
   • Cursor 和其他客户端：将 {"mcpServers": {"goofish": {"url": "<server URL>"}}} 添加到客户端的 MCP 配置文件中（Cursor：~/.cursor/mcp.json）。
4. 请用户完成登录。在 Claude Code 中，用户运行 /mcp，选择 goofish 并选择 Authenticate；其他客户端会自行打开 Apify 登录页面。可能需要重启客户端，工具才会显示。
5. 使用简单搜索检查是否正常，例如 keyword: "iPhone 15 Pro", maxItems: 5。每条返回的商品信息都会计入用户的 Apify 账户费用，因此测试时请控制规模。
6. 进行实际搜索前，请阅读 Goofish 技能：其中说明了长时间运行的任务如何处理，以及哪些输入能获得良好结果。

为什么选择 Goofish MCP

• 无需 Goofish 账户。 无需登录、无需 Cookie，也无需中国手机号。不会涉及你自己的 Goofish 账户。
• 无需安装任何内容。 这是一个托管的远程 MCP 服务：添加一个 URL 并使用 Apify 登录即可。可用于 claude.ai 和 ChatGPT，不限于桌面应用。
• 一个服务包含五种工具。 搜索商品、查看商品详情、卖家和评价、图片搜索，以及包含买家问答（问大家）的评论。
• 丰富的结构化数据。 每条商品信息包含 150 多个字段：价格、成色、地点、浏览量和想要数、配送、卖家信用、销量和回复率。
• 专为助手打造。 内置技能会教助手如何使用有效的输入；长时间运行的请求会持续执行，并定期检查进度。
• 按结果付费。 费用计入你自己的 Apify 账户。可在 Apify 免费套餐上试用。

工具

所有工具均为只读。它们不会购买商品、联系卖家或发布商品。

快速开始

1. 如果您还没有 Apify 账号，请先免费注册。
2. **将服务添加到您的助手。**点击上方按钮，或按照下文中适用于您客户端的步骤操作。
3. **按照助手的提示登录 Apify，**然后提出问题，例如 “在 Goofish 上查找 ¥5,000 到 ¥8,000 之间的二手 Sony A7 III 相机机身，卖家为个人卖家，并用表格展示五个不错的选项。”

**关于 Apify 登录页面。**Apify 提示，您的助手“是动态注册的，未经 Apify 验证”，并要求获得完整 API 访问权限。通过这种方式登录的每个助手都会看到该提示；这让您的助手可以在您的账号上启动运行。您可以随时前往 Apify Console 集成页面撤销访问权限。

适用于任何支持远程 MCP 服务的客户端的服务 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

客户端设置

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

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"

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

{
  "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"
    }
  }
}

每个工具也是一个带有 REST API 的 Apify Actor，因此你可以在自己的代码、流水线或自动化流程中调用它，无需助手。请从 Apify Console integrations page 复制你的 API 令牌。输入字段与助手使用的相同；每个 Store 页面都有一个 API 选项卡，提供现成代码和完整的输入参考。

pip install apify-client

import os
from 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"])

npm install apify-client

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);

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}'

其他工具：将 Actor ID 替换为 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。

示例提示词

• 查找上海地区 30 条二手 Nintendo Switch OLED 商品，价格在 ¥800 到 ¥1,500 之间，仅限个人卖家，并按价格从低到高排序。
• 在闲鱼上搜索 乐高 75313，并根据成色和卖家评分比较价格最低的五件商品。
• 本周，闲鱼上二手 iPhone 15 Pro 256GB 的典型标价是多少？
• 获取此商品的完整详情：https://www.goofish.com/item?id=1045244773159
• 查找这位卖家，并总结其最近 50 条评价：https://www.goofish.com/personal?userId=2215160932230
• 查找外观与这张照片相似的 Goofish 商品：https://example.com/my-jacket.jpg
• 买家在此商品下问了什么，卖家又是如何回答的？https://www.goofish.com/item?id=947872178004

提示：搜索词要尽量贴近卖家编写商品标题的方式。中文品牌和品类请使用中文（小米、乐高、手机）；iPhone 15 Pro 这类国际名称可以直接使用。

使用场景

• 二手价格调研。 购买或出售前，了解某款商品在不同成色和城市的典型标价。
• 转售和跨境代购。 找出定价偏低的商品，并在决定购买前核查卖家。
• 品牌保护。 通过关键词或照片查找你的产品及外观相似的商品。
• 市场调研。 根据某个品类或一系列型号的浏览量和求购信息了解需求。
• 卖家核查。 在一条回答中查看信用等级、销量、回复率和近期评价。

输出示例

一条搜索结果，内容经过删节。你的助手会读取这类结果，并用通俗语言作答。

{
  "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"
}

每个工具的 Store 页面都会列出所有字段。

请求处理时长

每次工具调用约 45 秒内返回。规模更大的请求会在此后继续由 Apify 处理；你的助手会持续查询，直到结果就绪，然后分批读取。你可能会看到几条“仍在运行”的状态更新，这是正常现象。Goofish skill 会向助手讲解这一流程，以及每个工具的输入示例。Claude Code 可通过插件获取该技能。

定价

按结果付费，费用计入你的 Apify 账户。此代码库不收取订阅费。当前价格（包括批量折扣）请见各工具的定价页面：

• 搜索商品列表
• 商品详情
• 卖家主页
• 图片搜索
• 评论和问答

你的助手可通过 maxItems 等结果上限控制费用。先请求少量结果，再逐步增加。

**Apify 免费套餐：**每个工具可运行的次数有限，且每次运行的结果数量有上限（搜索最多返回 30 条商品列表）。如果运行达到上限，你的助手会告知你。任何付费 Apify 套餐都可取消这些限制。

故障排除

• /mcp 提示服务未通过身份验证，或无法获取其工具。 选择该服务，然后选择 Authenticate。其他客户端会显示 Connect 或 Sign in 按钮。
• 搜索没有返回结果。 搜索中文品牌时请使用中文（小米，而不是 xiaomi），扩大价格范围，或移除筛选条件。
• 搜索在 30 条商品列表处停止。 这是 Apify 免费套餐的上限。任何付费套餐都可取消此限制。
• 你的助手提示运行仍在进行。 较大的请求出现这种情况很正常。让它继续检查同一次运行；针对同一问题重新搜索会再次计费。
• 你的客户端无法完成登录。 改用 Apify 令牌标头，参见其他客户端。

常见问题

Goofish 是什么？ Goofish（goofish.com）是闲鱼的网络名称，它是阿里巴巴旗下的二手交易平台，也称为 Idlefish。人们可以在上面买卖二手手机、相机、游戏机、收藏品、时尚商品等各种物品。

我需要 Goofish 账户或中国手机号吗？ 不需要。你只需要一个 Apify 账户，创建只需一分钟。

我可以在中国境外使用吗？ 可以，任何国家都能使用。商品列表大多为中文，价格以 CNY 标示；你可以让助手翻译标题并换算价格。

哪些 AI 助手可以使用它？ 任何支持远程 MCP 服务的客户端都可以，包括 Claude（claude.ai、Claude Desktop、Claude Code）、ChatGPT、Codex、Cursor、带 GitHub Copilot 的 VS Code 等。

Goofish 有 API 吗？ 有。每个工具都可以通过 REST API 或 Apify 的 Python 和 JavaScript 客户端调用，参见在代码中使用。

它免费吗？ 你可以通过 Apify 免费套餐试用，每个工具的运行次数有限。之后按结果付费；参见定价。

我可以跟踪价格变化吗？ 可以。让助手重复搜索并进行比较，或者在 Apify 上安排搜索并比较各次运行的结果。

这是 Goofish 的官方产品吗？ 不是。Goofish MCP 是 Zen Studio 推出的独立产品，与 Goofish、Xianyu 或 Alibaba 均无关联。

隐私

请求会发送到 Apify 托管的 MCP 服务，并在你的 Apify 账户下运行。Apify 的隐私政策适用。此代码库仅包含配置和说明；不会收集任何信息。

中文说明

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

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

可以做什么：

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

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

三步开始：

1. 注册免费的 Apify 账号。
2. 点击上方的安装按钮，或在客户端中添加以下服务器地址：

   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. For Xiaohongshu (小红书) notes, comments and creators, see RedNote MCP.

License

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