'init'

2026-01-13 18:59:26 +08:00
commit 7feccf246d
56 changed files with 11596 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,258 @@
+# MIP页广告自动点击服务
+
+基于 AdsPower 的 MIP 页面广告自动化点击系统，支持自动识别商业广告、智能点击策略和数据统计反馈。
+
+## 功能特性
+
+- 自动识别 MIP 页面中的商业广告（排除 AI 健康管家等非商业内容）
+- 智能点击策略：随机点击次数、固定间隔时间、工作时间限制
+- 自动等待广告主回复并记录
+- 完整的数据统计和反馈机制
+- RESTful API 接口，支持运营人员提交链接
+- 持久化存储，支持断点续传
+
+## 系统要求
+
+- Python 3.8+
+- AdsPower 浏览器客户端
+- Chrome/Chromium 浏览器
+
+## 安装步骤
+
+### 1. 克隆或下载项目
+
+```bash
+cd d:\project\Work\ai_mip
+```
+
+### 2. 创建虚拟环境（推荐）
+
+```bash
+python -m venv venv
+venv\Scripts\activate  # Windows
+```
+
+### 3. 安装依赖
+
+```bash
+pip install -r requirements.txt
+```
+
+### 4. 配置环境变量
+
+复制 `.env.example` 为 `.env` 并修改配置：
+
+```bash
+copy .env.example .env
+```
+
+编辑 `.env` 文件，配置以下关键参数：
+
+```env
+# AdsPower配置
+ADSPOWER_API_URL=http://local.adspower.net:50325
+ADSPOWER_USER_ID=your_user_id_here
+
+# 点击策略配置
+MIN_CLICK_COUNT=1
+MAX_CLICK_COUNT=10
+CLICK_INTERVAL_MINUTES=30
+WORK_START_HOUR=9
+WORK_END_HOUR=21
+REPLY_WAIT_TIMEOUT=30
+```
+
+## 使用说明
+
+### 启动服务
+
+```bash
+python app.py
+```
+
+服务默认运行在 `http://localhost:5000`
+
+### API 接口
+
+#### 1. 健康检查
+
+```bash
+GET /health
+```
+
+#### 2. 添加单个 URL
+
+```bash
+POST /api/urls
+Content-Type: application/json
+
+{
+  "url": "https://example.com/mip-page"
+}
+```
+
+#### 3. 批量添加 URL
+
+```bash
+POST /api/urls
+Content-Type: application/json
+
+{
+  "urls": [
+    "https://example.com/mip-page-1",
+    "https://example.com/mip-page-2"
+  ]
+}
+```
+
+#### 4. 获取所有 URL 列表
+
+```bash
+GET /api/urls
+```
+
+响应示例：
+```json
+{
+  "success": true,
+  "data": [
+    {
+      "url": "https://example.com/mip-page",
+      "status": "active",
+      "target_clicks": 5,
+      "click_count": 2,
+      "reply_count": 1,
+      "created_time": "2026-01-12T10:00:00",
+      "last_click_time": "2026-01-12T11:30:00"
+    }
+  ]
+}
+```
+
+#### 5. 获取 URL 详细信息
+
+```bash
+GET /api/urls/{url}
+```
+
+#### 6. 删除 URL
+
+```bash
+DELETE /api/urls/{url}
+```
+
+#### 7. 重置 URL（重新开始点击）
+
+```bash
+POST /api/urls/{url}/reset
+```
+
+#### 8. 获取统计数据
+
+```bash
+GET /api/statistics
+```
+
+响应示例：
+```json
+{
+  "success": true,
+  "data": {
+    "total_urls": 10,
+    "active_urls": 5,
+    "completed_urls": 4,
+    "failed_urls": 1,
+    "total_clicks": 35,
+    "total_replies": 28,
+    "reply_rate": "80.00%"
+  }
+}
+```
+
+#### 9. 调度器控制
+
+启动调度器：
+```bash
+POST /api/scheduler/start
+```
+
+停止调度器：
+```bash
+POST /api/scheduler/stop
+```
+
+查看调度器状态：
+```bash
+GET /api/scheduler/status
+```
+
+## 点击策略说明
+
+系统会根据以下策略自动执行点击任务：
+
+1. **随机点击次数**：每个 URL 的目标点击次数在 1-10 次之间随机生成
+2. **点击间隔**：同一 URL 两次点击之间至少间隔 30 分钟
+3. **工作时间**：仅在 09:00-21:00 之间执行点击任务
+4. **回复等待**：点击广告后等待 30 秒检测广告主回复
+
+## 广告识别逻辑
+
+系统会自动识别 MIP 页面中的商业广告：
+
+- ✅ **点击**：带有"广告"标识的商业广告
+- ❌ **跳过**：无广告的页面
+- ❌ **跳过**：AI 健康管家等非商业内容
+
+## 数据存储
+
+所有数据存储在 `./data/urls_data.json` 文件中，包括：
+
+- URL 列表和状态
+- 点击统计
+- 回复统计
+- 点击历史记录
+
+## 日志
+
+日志文件存储在 `./logs/` 目录下，包含详细的运行日志和错误信息。
+
+## 项目结构
+
+```
+ai_mip/
+├── app.py                  # Flask 应用主入口
+├── config.py               # 配置管理
+├── adspower_client.py      # AdsPower API 客户端
+├── ad_automation.py        # 广告自动化操作
+├── scheduler.py            # 点击任务调度器
+├── data_manager.py         # 数据存储管理
+├── requirements.txt        # Python 依赖
+├── .env.example            # 环境变量示例
+├── .gitignore              # Git 忽略配置
+├── README.md               # 项目文档
+└── data/                   # 数据目录（自动创建）
+    └── urls_data.json      # URL 数据文件
+└── logs/                   # 日志目录（自动创建）
+```
+
+## 注意事项
+
+1. **AdsPower 配置**：确保 AdsPower 客户端已安装并运行，正确配置 `ADSPOWER_USER_ID`
+2. **页面结构适配**：如果实际 MIP 页面结构与预期不同，需要修改 `ad_automation.py` 中的元素选择器
+3. **网络环境**：确保网络稳定，能够正常访问目标 MIP 页面
+4. **浏览器驱动**：AdsPower 会自动管理 ChromeDriver，无需手动配置
+
+## 常见问题
+
+### Q: 启动服务后无法连接 AdsPower？
+A: 检查 AdsPower 是否正在运行，API 地址是否正确（默认：http://local.adspower.net:50325）
+
+### Q: 无法识别广告？
+A: 需要根据实际页面结构调整 `ad_automation.py` 中的广告识别逻辑和选择器
+
+### Q: 如何查看点击记录？
+A: 调用 `/api/statistics` 接口查看整体统计，或使用 `/api/urls/{url}` 查看单个 URL 的详细点击历史
+
+## 技术支持
+
+如有问题，请查看日志文件或联系开发团队。