# ResValueMiner

**Repository Path**: aiden61/res-value-miner

## Basic Information

- **Project Name**: ResValueMiner
- **Description**: ResValueMiner 是一款二手房数据挖掘与智能分析工具，聚焦二手房市场数据采集、清洗、分析与房价估值，支持本地化部署与对话式 AI 交互，可快速完成指定区域二手房市场研究。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 二手房数据挖掘工具

用于二手房市场分析的数据挖掘工具集，支持三种不同方式完成二手房市场分析与房价估值。

## 子项目

| 目录 | 说明 |
|---|---|
| `homework/` | 数据流水线，针对上海杉达学院 10km 范围内的二手房市场分析与房价估值 |
| `ai_agent/` | 对话式智能体，基于大语言模型的交互式分析工具 |
| `skills/` | Skill 文件，可直接加载到 Claude Code 进行二手房价相关分析 |

## 环境配置

子项目各自维护自己的 `.env`，互不共享。使用前先将示例文件复制为 `.env` 并填入真实密钥：

**homework：**

```bash
cd homework
cp .env.example .env   # 然后编辑 .env，填入 AMAP_KEY
```

**ai_agent：**

```bash
cd ai_agent
cp .env.example .env   # 然后编辑 .env，填入 AMAP_KEY 和 DEEPSEEK_API_KEY
```

`.env` 已在 `.gitignore` 中排除，不会提交到仓库。

## 密钥申请

- **高德地图 API Key**（homework、ai_agent 均需要）：前往 [高德开放平台](https://console.amap.com/dev/key/app) 注册，创建「Web 服务」类型 Key，免费额度足够日常使用
- **DeepSeek API Key**（仅 ai_agent 需要）：前往 [DeepSeek 开放平台](https://platform.deepseek.com) 注册

## 快速开始

```bash
# 数据流水线
cd homework
pip install -r requirements.txt
python spider_dynamic.py

# AI 智能体界面
cd ai_agent
pip install -r requirements.txt
python app.py                 # 浏览器访问 http://127.0.0.1:7860
```

`skills/` 无需安装，可由 Claude Code/OpenClaw 等工具直接加载使用。

## 项目结构

```
.
├── homework/                 # 数据流水线模块
│   ├── spider_anjuke_deep.py # 安居客数据爬虫
│   ├── enricher.py           # 数据 enrichment 工具
│   ├── analysis.ipynb        # 数据分析 Notebook
│   └── requirements.txt      # 依赖
│
├── ai_agent/                  # AI 智能体模块
│   ├── agent.py              # DeepSeek 智能体实现
│   ├── app.py               # Web 界面入口
│   ├── tools.py             # 工具函数集
│   ├── trainer.py           # 房价预测模型训练
│   ├── enricher.py          # POI 数据 enrichment
│   ├── report.py           # 报告生成
│   ├── spider_dynamic.py    # 动态网页爬虫
│   ├── requirements.txt     # 依赖
│   └── data/               # 数据目录
│
└── skills/                   # Claude Code Skill
    └── data-mining-agent/   # 数据挖掘智能体 Skill
        └── SKILL.md         # Skill 定义文件
```

## 主要功能

### 数据流水线 (homework)
- 安居客二手房数据爬取
- 基于高德地图 POI 的数据 enrichment
- 距离学校 10km 范围内的房屋筛选

### AI 智能体 (ai_agent)
- 对话式交互分析
- 房价预测模型训练
- 数据可视化报告生成
- 支持爬虫、数据查询、地理编码等多种工具

### Skill 文件 (skills)
- 可加载到 Claude Code 的数据挖掘智能体
- 自主制定分析计划并执行
- 包含爬虫编写指南和最佳实践