# QQ群消息获取

**Repository Path**: changsong/grab_qq_msg

## Basic Information

- **Project Name**: QQ群消息获取
- **Description**: 提供QQ群消息的实时获取与处理。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-13
- **Last Updated**: 2025-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QQ群聊消息自动抓取工具

本项目基于 `pyautogui`，自动化操作QQ（9.9+），通过顶部搜索框批量搜索指定关键字，抓取群聊消息并导出为CSV文件。支持首次截图模板采集，后续全自动运行。

## 功能特性
- 支持多个关键字批量搜索
- 支持过滤包含指定关键字的消息
- 首次运行自动截图，后续全自动
- 结果导出为CSV文件

## 环境依赖

建议使用 Python 3.7 及以上版本。

安装依赖：
```bash
pip install -r requirements.txt
```

## 配置说明

编辑 `config.py`，配置如下内容：

```python
SEARCH_KEYWORDS = [
    "示例关键字1",
    "示例关键字2",
]

FILTER_KEYWORDS = [
    "过滤词1",
    "过滤词2",
]

SCREENSHOT_DIR = "screenshots"  # 截图模板保存目录
CSV_OUTPUT = "output.csv"       # 结果保存文件
```

- `SEARCH_KEYWORDS`：需要批量搜索的关键字列表
- `FILTER_KEYWORDS`：消息中包含这些词将被过滤
- `SCREENSHOT_DIR`：截图模板保存目录
- `CSV_OUTPUT`：结果导出文件名

## 首次运行（截图采集）

1. 启动QQ并登录，确保主窗口在最前。
2. 运行主程序：
   ```bash
   python main.py
   ```
3. 按提示依次截图：
   - QQ主窗口
   - 顶部搜索框
   - 群列表区域
   - 聊天记录区域
   （后续可根据需要完善截图步骤）
4. 截图模板将保存在 `screenshots/` 目录。

## 自动化运行

- 首次截图后，后续运行 `python main.py` 即可全自动批量搜索、抓取消息、过滤并导出结果。
- 结果文件为 `output.csv`，可用Excel等工具打开。

## 注意事项
- 请确保QQ主窗口始终在最前，且分辨率/缩放比例与截图时一致。
- 若界面有变化或自动化失效，可删除 `screenshots/` 目录重新截图。
- 若需抓取更多内容或支持OCR识别，可在 `qq_automation.py` 中完善相关逻辑。

---
如有问题或需定制功能，请联系开发者。