Goofish
FreeNot checkedMCP server for Goofish (闲鱼/Xianyu) - search listings, get item details, monitor keywords via Playwright + mtop API
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"
}
}
}
}
下一步建议
- 补强
get_item_detail的真实结构化字段 - 增加 cookie/export/import 管理
- 增加自动登录检测和错误提示
- 增加 remote/http transport
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-serverFAQ
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
Playwright
Browser automation, scraping, screenshots
by MicrosoftPuppeteer
Browser automation and web scraping.
by modelcontextprotocolopentabs-dev/opentabs
Plugin-based MCP server + Chrome extension that gives AI agents access to web applications through the user's authenticated browser session. 100+ plugins with a
by opentabs-devrobhunter/agentdeals
1,500+ developer infrastructure deals, free tiers, and startup programs across 54 categories. Search deals, compare vendors, plan stacks, and track pricing chan
by robhunterCompare Goofish with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All browse MCPs
