xianyu-buyer-mcp

MCP-сервер для запроса цены на стороне покупателя в 闲鱼 (Goofish). Поддерживает поиск товаров, массовую отправку сообщений с запросом цены и автоматический сбор ответов продавцов.

Возможности

Related MCP server: Goofish MCP Server

Установка

Предварительные требования

• Python 3.11+

• Приложение 闲鱼 / 淘宝 (для входа по QR-коду)

• Веб-версия 闲鱼 / десктоп-версия 淘宝 (для получения и ответа на сообщения)

Шаги

# 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

Дополнительная конфигурация

Скопируйте шаблон переменных окружения и измените его по своему усмотрению:

cp .env.example .env

Использование в MCP-клиентах

Claude Desktop / Cursor / QoderWork

Добавьте в конфигурационный файл MCP:

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

Первое использование

1. Вызовите инструмент login в AI-ассистенте.

2. В браузере автоматически откроется страница входа в 闲鱼.

3. Отсканируйте QR-код с помощью приложения 闲鱼 или 淘宝.

4. Cookies автоматически сохраняются в ~/.xianyu-buyer-mcp/cookies.json.

5. При последующем использовании повторно сканировать QR-код не нужно.

Типовой сценарий

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

Технические детали

• Антидетекция: используются playwright-stealth + собственный UA + подмена navigator — это снижает риск распознавания запросов как ботов.

• Обход CAPTCHA: данные продавцов запрашиваются через SDK lib.mtop.request на странице IM, чтобы избежать слайдер-проверки на странице товара.

• Контроль частоты: между массовыми отправками сообщений выдерживается пауза 2 секонды, чтобы активцровать антифрод-защиту платформы.

• Потокобезопасность: все операции с браузером выпонconnected последовательно в однопоточном executor.

Примечания

• 闲鱼 имель защиту от автоматизированного сбора данн; не вызывай функции с высокой частотой и не используй проект для масштабного сбора.

• Cookies имеют огранченный сок годности — пость скока their.

• Проект предоставлен только для обучения и изучения; соблюдайте условияиспользования платформы 闲鱼.

License

MIT