Metadata-Version: 2.4
Name: xianyu-detector
Version: 1.0.2
Summary: 闲鱼账号状态检测 MCP Server
Author-email: wave2003 <3518413017@qq.com>
Description-Content-Type: text/markdown
Requires-Dist: mcp
Requires-Dist: playwright

# 🐟 闲鱼账号状态检测 MCP Server

一个基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 的服务器，用于检测闲鱼账号的认证状态、健康度（闲气值）、行为统计和设备环境风险。它可以无缝集成到支持 MCP 的 AI 客户端（如 Cherry Studio）中，让 AI Agent 在发布商品前自动评估账号风险。

## ✨ 功能特性

- 🔐 **账号认证检测**：验证是否完成实名认证、实人认证，检查是否为经营性卖家（“商”标识）。
- 📊 **健康度评估**：获取当前闲气值（0-100 分），判断账号是否处于限权状态，并显示处罚详情。
- 📈 **行为数据分析**：统计在售商品数、年交易笔数、月均成交、品类分布，识别高频经营行为。
- 📱 **设备环境检测**：检测是否使用模拟器/云手机、是否处于公共 WiFi、是否在多账号间频繁切换。
- 🔄 **自动化 Cookie 管理**：首次手动登录后自动保存会话，后续无需重复登录。
- 🛠️ **标准化 MCP 接口**：支持 `detect`、`status`、`login` 三种操作，方便 AI Agent 调用。

## 🚀 快速开始

### 前置要求

- Python 3.10 或更高版本
- 一个有效的闲鱼账号

### 安装方式

#### 方式一：通过 `uvx`（推荐，适用于 MCP 客户端）

如果你使用支持 MCP 的客户端（如 Cherry Studio），可以直接通过 `uvx` 命令运行，无需手动安装：

```json
{
  "mcpServers": {
    "xianyu-detector": {
      "command": "uvx",
      "args": ["xianyu-detector"]
    }
  }
}
