App Rank Monitor

爬取苹果官方和点点数据应用榜单，自动生成日报报告并通过钉钉发送，支持数据管理和历史清理。

App Rank Monitor - 应用榜单监控 Skill

版本: v5.0
创建时间: 2026-03-17
更新时间: 2026-03-24 (移除下架检测功能)
状态: ✅ 完成

---

📋 技能说明

专注应用榜单爬取和数据统计

核心功能:

• ✅ 榜单爬取（苹果官方 RSS + 点点数据）
• ✅ 钉钉通知（文字 + 文件上传）
• ✅ 自动生成 Markdown 报告
• ✅ 数据管理（自动清理，保留 7 天）

---

📊 支持数据源

数据源	状态	说明
🍎 苹果官方 RSS	✅	免费榜/付费榜/新上架（总榜）
📈 点点数据	⚠️	需 Cookie（官网注册，有效期 24 小时）

---

🚀 使用方法

自然语言触发

直接对钳钳说：

text

- 查看今天的苹果榜单
- 爬取点点榜单
- 发送日报
- 清理过期数据

命令行（高级）

bash

cd ~/.openclaw/workspace/skills/app-rank-monitor

# 爬取苹果榜单
python src/main.py apple-rank

# 爬取点点榜单
python src/main.py rank --platform diandian

# 查看统计
python tools/show_stats.py

---

📁 文件结构

text

app-rank-monitor/
├── src/
│   ├── main.py              # 主入口
│   ├── monitor.py           # 监控调度器
│   ├── rankers/             # 榜单爬虫
│   │   ├── apple_ranker.py  # 苹果 RSS
│   │   ├── diandian.py      # 点点数据
│   │   └── diandian_android.py  # 点点安卓渠道
│   ├── models/              # 数据模型
│   ├── notifiers/           # 通知发送
│   └── reporters/           # 报告生成
├── config/
│   ├── dingtalk.yaml        # 钉钉配置
│   ├── diandian.yaml        # 点点配置
│   └── ios_rank.yaml        # 苹果榜单配置
├── database/
│   └── apps.db              # SQLite 数据库
├── logs/                    # 日志文件
└── docs/                    # 文档

---

🔧 配置说明

钉钉配置

编辑 config/dingtalk.yaml:

yaml

dingtalk:
  client_id: "你的企业应用 client_id"
  client_secret: "你的企业应用 client_secret"
  chat_id: "群聊 ID"
  webhook: "机器人 Webhook"

点点数据配置

编辑 config/diandian.yaml:

yaml

diandian:
  cookie: "你的 Cookie（含 token）"

获取 Cookie:

1. 访问 https://www.diandian.com/
2. 登录账号
3. 按 F12 打开开发者工具
4. 刷新页面
5. 复制 Cookie 字符串

---

📅 定时任务

已配置定时任务：

• 每天 8:00 - 爬取 iOS 榜单并发送日报

查看任务状态：

bash

openclaw cron list

---

🛠️ 常用命令

bash

# 查看定时任务
openclaw cron list

# 手动触发爬取
openclaw cron run <task-id>

# 查看执行日志
cat logs/cron_execution.log

# 查看数据库统计
python tools/show_stats.py

---

📝 更新日志

v5.0 (2026-03-24) - 移除下架检测功能

• ❌ 移除下架检测模块 (src/detectors/)
• ❌ 移除下架数据模型 (OfflineAppRecord, AppleOfflineAlert)
• ❌ 移除 offline 命令
• ❌ 移除 --detect-offline 参数
• ✅ 专注榜单爬取和日报生成

v4.3 (2026-03-23) - 移除七麦数据

• ❌ 移除七麦数据爬虫 (qimai_browser.py)
• ❌ 移除七麦配置文件 (config/qimai.yaml)
• ❌ 移除日报中的七麦板块
• ✅ 专注点点数据和苹果官方 RSS

v4.2 (2026-03-17)

• ✅ 优化定时任务配置
• ✅ 修复 delivery 问题

v4.1 (2026-03-16)

• ✅ 集成点点数据自动登录
• ✅ 支持安卓 8 大渠道

v4.0 (2026-03-15)

• ✅ 精简架构，移除冗余功能
• ✅ 优化日报生成逻辑

---

💡 故障排查

Cookie 过期

症状: 日报无数据，收到告警通知

解决:

1. 重新登录点点数据官网
2. 复制新 Cookie 到 config/diandian.yaml
3. 手动触发：python src/main.py rank --send-report

定时任务未执行

检查:

bash

openclaw cron list
openclaw cron runs --id <task-id>

---

📖 详细文档

• docs/配置说明.md - 详细配置指南
• docs/定时任务配置说明.md - 定时任务设置
• docs/故障排查指南.md - 常见问题解决

---

🦞 有问题？

随时问钳钳！