xianyu-buyer-mcp

闲鱼（Goofish）の買い手向け価格問い合わせ MCP Server。商品検索、問い合わせメッセージの一括送信、売り手からの返信の自動収集をサポートします。

機能

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. AI アシスタントで login ツールを呼び出します。

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 回避: 売り手情報の取得は IM ページの lib.mtop.request SDK を介して行い、商品詳細ページでのスライダー認証の発動を回避します。

• 頻度制御: メッセージの一括送信間隔を2秒にして、プラットフォームのリスク管理機能が発動しないようにします。

• スレッドセーフ: すべてのブラウザ操作はシングルスレッドの executor で直列実行されます。

注意事項

• 闲鱼にはアンチクローリング機構があるため、高頻度の呼び出しや大規模なデータ収集には使用しないでください。

• Cookies の有効期間は限られているため、失効後は再度をスキャンする必要があります。

• このプロジェクトは学習・研究目的のみで提供されています。闲鱼プラットフォームの利用規約を順守してください。

License

MIT