xianyu-buyer-mcp

闲鱼（Goofish）MCP-Server für Preisabfragen auf der Käuferseite. Unterstützt die Suche nach Artikeln, das Massensenden von Preisabfragen und das automatische Abrufen der Verkäuferantworten.

Funktionen

Related MCP server: Goofish MCP Server

Installation

Voraussetzungen

• Python 3.11+

• 闲鱼/淘宝-App (zum Scannen des QR-Codes für die Anmeldung)

• 闲鱼-Webversion / 淘宝-Desktop (zum Empfangen und Beantworten von Nachrichten)

Schritte

# 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

Optionale Konfiguration

Umgebungsvariablenvorlage kopieren und nach Bedarf anpassen:

cp .env.example .env

In MCP-Clients verwenden

Claude Desktop / Cursor / QoderWork

In die MCP-Konfigurationsdatei einfügen:

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

Erste Verwendung

1. Im KI-Assistenten das Tool login aufrufen.

2. Im Browser öffnet sich automatisch die Anmeldeseite von 闲鱼.

3. Den QR-Code mit der App von 闲鱼 oder 淘 Gutslernt? Original says "闲鱼或淘宝 App". Yes.

4. Die Cookies werden automatisch unter ~/.xianyu-buyer-mcp/cookies.json gespeichert.

5. Bei der weiteren Verwendung ist kein erneutes Scannen erforderlich.

Typischer Ablauf

# 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")

Technik-Highlights

• Anti-Erkennung: Verwendet playwright-stealth + benutzerdefinierte UAadaption + navigator-Spoofing, um das Risiko zu verringern, als Bot erkannt zu werden.

• CAPTCHA-Umgehung: Die Abfrage der Verkäuferdaten läuft über das lib.mtop.request SDK der IM-Seite, wodurch auf der Produktdetailseite kein Schieberegler-CAPTCHA ausgelöst wird.

• Geschwindigkeitskontrollierung: Beim Batch-Versenden werden Nachrichten in einem Abstand von 2 Sekunden gesendet, um die Risikokontrolle der Plattform zu vermeiden.

• Thread-Sicherheit: Alle Browseroperationen werden in einem Single-Thread-Executor serialisiert ausgeführt.

Lichtung ? No. Use "Hinweise".

Hinweise

• 闲鱼 verfügt über Anti-Scraping-Mechanismen; bitte nicht mit hoher Frequenz aufrufen oder für großangelegte Datensammlung verwenden.

• Nach der Gültigkeit der Cookies ablaufen, bitte neu scannen.

• Dieses Projekt dient ausschließlich Lern- und Forschungszwecken; beachten Sie die Nutzungsbedingungen der 闲鱼-Plattform.

Lizenz

MIT