# Shop Health Check

> 跨境电商店铺健康度自动巡检 Skill。支持多店铺配置，定时检查站点可用性、响应时间、SSL证书健康度、关键页面404/内容缺失，异常时自动推送到飞书。

- Skill: `lord1egypt/shop-health-check` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/shop-health-check`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/shop-health-check/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/lord1egypt/shop-health-check

---


# 店铺健康巡检 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      # 响应时间阈值（秒）
ssl_warning_days = 14     # SSL 剩余天数警告阈值
check_sample_size = 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
ssl_warning_days = 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. **`check_sites.py`** — 检查站点可用性和响应时间
2. **`check_ssl.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
```