# 闲鱼 MCP Server 🏪

让 AI Agent（如 OpenCode）能够通过 MCP 协议搜索闲鱼二手商品价格。

## ✨ 核心特性

- **🔍 搜索闲鱼二手价格** — 输入关键词，获取商品标题、价格、地区、链接
- **🍪 Cookie 全自动检测** — 不再需要手动导 Cookie！按优先级自动尝试 4 种方式：
  1. **从 Chrome 浏览器自动提取**（已登录闲鱼时，全自动，无感）
  2. **从已保存的配置文件读取**（之前登录过，自动复用）
  3. **从环境变量读取**（服务器/CI 场景）
  4. **弹出浏览器窗口让您登录**（首次无 Cookie + 有图形界面时，只需一次）
- **🔄 一次登录，永久使用** — 交互式登录成功后，Cookie 自动保存复用
- **⚡ 基于 Playwright** — 可靠渲染闲鱼 SPA 页面，精确提取商品信息

## 📦 安装

```bash
# 1. 安装 Python 依赖
pip install -r /home/hesheng/projects/xianyu-mcp/requirements.txt

# 2. 安装 Playwright Chromium 浏览器
python -m playwright install chromium
```

## 🚀 启动

```bash
# 方式一：直接启动
mcp run /home/hesheng/projects/xianyu-mcp/main.py

# 方式二：配置到 OpenCode
```

在 `opencode.jsonc` 中添加：

```jsonc
{
  "mcpServers": {
    "xianyu-mcp": {
      "command": "mcp",
      "args": ["run", "/home/hesheng/projects/xianyu-mcp/main.py"]
    }
  }
}
```

## 🎯 使用示例

在 OpenCode 中直接问：

> 「帮我搜一下闲鱼上 **iPhone 15 Pro Max 256G** 二手什么价」
> 「**MacBook Air M3** 在闲鱼上大概多少钱」
> 「**索尼 A7M4** 二手行情怎么样」

Agent 会自动调用 `xianyu_search` 工具，返回：

| 标题 | 价格 | 地区 | 链接 |
|------|------|------|------|
| iPhone 15 Pro Max 256G 原色 99新 | ￥8,299 | 上海 | [查看] |
| iPhone 15 Pro Max 256G 国行在保 | ￥7,999 | 深圳 | [查看] |

## 🍪 Cookie 获取方式（按自动化程度排序）

### 方式 1：从 Chrome 自动提取（全自动，推荐 ✅）

如果您的 Chrome 浏览器已经登录过闲鱼，MCP 会自动从 Chrome 的 Cookie 数据库中提取登录态，**无需任何操作**。

> **注意**：此方式需要安装 `keyring` 库以解密 Chrome 的加密 Cookie：
> ```bash
> pip install keyring
> ```
> 如果未安装 `keyring`，MCP 会自动降级到方式 4。

### 方式 2：已保存的配置文件（自动复用）

如果您之前通过方式 4 登录过一次，Cookie 会自动保存到 `~/.config/xianyu/cookies.json`，后续启动时自动复用，无需再次登录。

### 方式 3：环境变量（服务器/无界面环境）

```bash
export XIANYU_COOKIE='[{"name":"_m_h5_tk","value":"xxx"...}]'
```

用 EditThisCookie 插件导出 JSON 后，将内容设为环境变量。

### 方式 4：弹窗登录（首次使用，有图形界面时）

如果以上方式都不可用，且系统有图形界面，MCP 会自动打开一个浏览器窗口，您扫码或登录闲鱼后，Cookie 自动捕获并保存。

## 🔧 自测试

```bash
# 检查语法
python -c "import ast; ast.parse(open('/home/hesheng/projects/xianyu-mcp/main.py').read()); print('Syntax OK')"
python -c "import ast; ast.parse(open('/home/hesheng/projects/xianyu-mcp/cookie_manager.py').read()); print('Syntax OK')"
python -c "import ast; ast.parse(open('/home/hesheng/projects/xianyu-mcp/browser.py').read()); print('Syntax OK')"
python -c "import ast; ast.parse(open('/home/hesheng/projects/xianyu-mcp/search.py').read()); print('Syntax OK')"

# 测试导入（仅测试无外部依赖的部分）
python -c "from cookie_manager import CookieManager; print('CookieManager 导入成功')"
```

## 📁 项目结构

```
xianyu-mcp/
├── main.py              # MCP 服务入口，FastMCP 定义 tools
├── cookie_manager.py    # Cookie 自动检测（4 种方式链式尝试）
├── browser.py           # Playwright 浏览器管理器（headless/headful 双模式）
├── search.py            # 闲鱼搜索逻辑（页面加载 → 滚动 → DOM 解析）
├── __init__.py
├── requirements.txt
└── README.md
```

## ⚠️ 注意事项

- 首次使用时，如果无 Cookie 且有图形界面，会自动弹出浏览器窗口
- 搜索过频繁可能触发闲鱼风控，建议间隔几秒再搜
- Cookie 有效期约 1-3 天，过期后需要重新登录