Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Goofish

FreeNot checked

MCP server for Goofish (闲鱼/Xianyu) - search listings, get item details, monitor keywords via Playwright + mtop API

GitHubEmbed

About

MCP server for Goofish (闲鱼/Xianyu) - search listings, get item details, monitor keywords via Playwright + mtop API

README

独立的 Goofish / 闲鱼 MCP server,使用 Node.js + Playwright,并通过页面上下文里的 window.lib.mtop.request(...) 获取搜索数据。

当前状态

  • search_items:已按真实 Goofish 页面 + mtop 路线实现
  • get_item_detail:已接入 mtop.taobao.idle.pc.detail,可结构化返回价格、卖家、地区、图片、属性、描述
  • monitor_keyword:复用 search_items
  • ✅ 浏览器登录态持久化:使用 Playwright persistent context

安装

cd goofish-mcp-server
npm install

运行

npm start

默认使用:

  • 浏览器 profile 目录:./.profiles/goofish
  • 非 headless

可选环境变量:

GOOFISH_PROFILE_DIR=/path/to/profile
GOOFISH_HEADLESS=1

第一次登录

首次启动时会打开浏览器 profile。 你需要在这个 profile 里手动登录 Goofish 一次。 后续 session 会复用该登录态。

MCP tools

1. search_items

输入:

{
  "keyword": "iphone 15 pro",
  "limit": 10
}

2. get_item_detail

输入:

{
  "item_id": "1234567890"
}

或:

{
  "url": "https://www.goofish.com/item?id=1234567890"
}

3. monitor_keyword

输入:

{
  "keyword": "iphone 15 pro",
  "max_items": 20,
  "dedupe_key": "item_id"
}

Claude / OpenClaw 接入思路

把这个进程作为 stdio MCP server 挂进去即可。

配置示例文件:

  • mcp-config-examples.json

Claude Desktop 核心思路:

{
  "mcpServers": {
    "goofish": {
      "command": "node",
      "args": ["/absolute/path/to/goofish-mcp-server/index.js"],
      "env": {
        "GOOFISH_PROFILE_DIR": "/absolute/path/to/goofish-mcp-server/.profiles/goofish",
        "GOOFISH_HEADLESS": "0"
      }
    }
  }
}

下一步建议

  1. 补强 get_item_detail 的真实结构化字段
  2. 增加 cookie/export/import 管理
  3. 增加自动登录检测和错误提示
  4. 增加 remote/http transport

from github.com/mercy719/goofish-mcp-server

Installing Goofish

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/mercy719/goofish-mcp-server

FAQ

Is Goofish MCP free?

Yes, Goofish MCP is free — one-click install via Unyly at no cost.

Does Goofish need an API key?

No, Goofish runs without API keys or environment variables.

Is Goofish hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Goofish in Claude Desktop, Claude Code or Cursor?

Open Goofish on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Goofish with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All browse MCPs