店铺健康巡检 Skill

何时使用

• - 用户说：检查店铺健康度、巡检店铺、帮我监控店铺是否宕机、店铺健康报告
• 作为定时任务（Cron / Heartbeat）定期执行，异常时推送到飞书

前置条件

• - Python 3.8+，需要 requests、beautifulsoup4、urllib3、python-dateutil 库
• 配置好多店铺信息（config/shops.conf）
• 飞书 Webhook 已配置（环境变量 FEISHU_WEBHOOK，或脚本内配置）

配置文件 config/shops.conf

ini
[DEFAULT]

默认阈值（可被店铺级别覆盖）

response_timeout = 3 # 响应时间阈值（秒）
sslwarningdays = 14 # SSL 剩余天数警告阈值
checksamplesize = 5 # 分类页抽检商品数量

[shop1]
name = 店铺1
domain = www.example.com
base_url = https://www.example.com

站点可用性检查的页面路径（逗号分隔，留空则用默认）

check_paths = /, /c/best-sellers, /cart, /checkout

要检查的分类页路径（用于抽检商品页）

category_paths = /c/best-sellers, /c/new-arrivals, /c/sale

可选：覆盖全局阈值

response_timeout = 5
sslwarningdays = 30

[shop2]
name = 店铺2
domain = shop2.example.com
base_url = https://shop2.example.com
check_paths = /, /products, /collections/all
category_paths = /collections/all

使用提醒：首次使用前，请先配置 config/shops.conf，填入真实的店铺域名和路径。

工作流程

脚本按以下顺序执行：

1. 1. checksites.py — 检查站点可用性和响应时间
2. checkssl.py — 检查 SSL 证书过期和状态
3. check_404.py — 爬取分类页 → 抽检商品页 → 检测404和错误内容
4. report.py — 汇总所有结果，判定告警，推送到飞书

命令示例

完整巡检

bash
cd ~/.openclaw/skills/shop-health-check
python3 scripts/report.py

指定店铺巡检

bash
python3 scripts/report.py --shop shop1

查看帮助

bash
python3 scripts/report.py --help

输出示例（正常）

✅ 店铺健康巡检报告 | 2026-03-30 11:00

📦 shop1 (www.example.com)
✅ 站点可用性：全部正常（2/2 检查点）
- / : 200 (1.2s)
- /c/best-sellers : 200 (0.9s)
✅ SSL证书：正常（剩余 89 天）
🔍 商品页抽检：全部正常（5 个商品）

📦 shop2 (shop2.example.com)
✅ 站点可用性：全部正常（3/3 检查点）
✅ SSL证书：正常（剩余 45 天）
🔍 商品页抽检：全部正常（5 个商品）

🎉 所有店铺健康，无异常。

告警示例（有问题时）

🚨 店铺健康巡检告警 | 2026-03-30 11:00

📦 shop1 (www.example.com)
❌ 站点可用性：
- /checkout : 超时（>3s）
⚠️ SSL证书：剩余 12 天，请尽快续期
❌ 商品页抽检：
- /products/12345 : 404

📦 shop2 (shop2.example.com)
✅ 无异常

⚡ 共 3 个问题需要处理

告警规则

检查项	告警条件
站点可用性	HTTP状态码非200，或响应时间超过阈值
SSL证书

剩余有效期 < 警告天数（默认14天），或证书无效/自签名 | | 商品页404 | 被抽检的商品页返回404 | | 商品页内容 | 页面包含此商品已下架、Page Not Found、404等错误文本 |

定时任务配置

bash
openclaw cron add \
--name shop-health-check-hourly \
--cron 0 \
--session isolated \
--message 运行店铺健康巡检：cd ~/.openclaw/skills/shop-health-check && python3 scripts/report.py \
--announce \
--channel feishu

依赖安装

bash
pip3 install requests beautifulsoup4 urllib3 python-dateutil