xianyu-buyer-mcp

Servidor MCP de consulta de precios del lado del comprador para 闲鱼（Goofish）. Admite búsqueda de productos, envío de mensajes de consulta en lote y recuperación automática de respuestas de los vendedores.

Funciones

Related MCP server: Goofish MCP Server

Instalación

Requisitos

• Python 3.11+

• Aplicación 闲鱼/淘宝（para iniciar sesión con código QR)

• Versión web de 闲鱼/escritorio de 淘宝（para recibir mensajes)

Pasos

# 1. 克隆项目
git clone https://github.com/<your-username>/xianyu-buyer-mcp.git
cd xianyu-buyer-mcp

# 2. 安装依赖
pip install -e .

# 3. 安装 Chromium 浏览器
playwright install chromium

Configuración opcional

Copia la plantilla de variables de entorno y modifícala según sea necesario:

cp .env.example .env

Uso en clientes MCP

Claude Desktop / Cursor / QoderWork

Añade esto al archivo de configuración MCP:

{
  "mcpServers": {
    "xianyu-buyer": {
      "command": "python",
      "args": ["/path/to/xianyu-buyer-mcp/server.py"]
    }
  }
}

Primer uso

1. Llama a la herramienta login en el asistente de IA.

2. La ventana del navegador mostrará automáticamente la página de inicio de sesión de 闲鱼.

3. Inicia sesión escaneando el código QR con la aplicación de 闲鱼 o 淘宝.

4. Las cookies se guardan automáticamente en ~/.xianyu-buyer-mcp/cookies.json.

5. En los usos siguientes no será necesario volver a escanear el código.

Flujo típico

# 1. 登录
login()

# 2. 搜索商品
search("MacBook Pro M1 16G 512G", max_price=5000)

# 3. 批量询价
batch_send_inquiry(
  items='[{"itemId": "xxx", "sellerId": "yyy"}, ...]',
  message="你好，还在吗？"
)

# 4. 查看回复
get_conversations()

# 5. 查看某个对话详情
get_conversation_detail(item_id="xxx", seller_id="yyy")

Detalles técnicos

• Anti-detección: usa playwright-stealth + UA personalizada + falsificación de navigator para reducir el riesgo de ser identificado como bot.

• Evitar CAPTCHA: la consulta de información del vendedor se realiza mediante el SDK lib.mtop.request de la página IM, lo que evita activar la verificación deslizante en la página de detalles del producto.

• Control de frecuencia: los mensajes en lote se envían con un intervalo de 2 segundos para evitar activar el control de riesgos de la plataforma.

• Seguridad en hilos: todas las operaciones del navegador se ejecutan en serie en un executor de un solo hilo.

Avisos

• 闲鱼 cuenta con mecanismos anti-scraping; evita llamadas de alta frecuencia o su uso para recopilar datos a gran escalera.

• Las cookies tienen una validez limitada. Cuando caduquen, deberás escanear el código QR de nuevo para iniciar sesión.

• Este proyecto es solo para fines de aprendizaje e investigación. Respeta los términos de uso del Carrillón de la plataforma 闲鱼.

Licensing

MIT