# zh-opc-monitor

Adopt this skill: https://proskills.md/skills/other/huangyaling658-creator-zh-opc-monitor

Page: https://proskills.md/skills/other/huangyaling658-creator-zh-opc-monitor
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 7030
upstream: https://github.com/huangyaling658-creator/zh-opc-monitor/blob/HEAD/SKILL.md

````text
---
name: zh-opc-monitor
description: 中国OPC一人公司政策信息监控技能。定期监控国家市场监管总局、广东省、珠海等政府网站关于OPC一人公司/公司登记/市场准入的最新公告和政策更新，发现变化即推送。
---

# 中国 OPC 一人公司政策监控技能

本技能定期监控**国家、省、市三级政府网站**上关于"OPC 一人公司 / 公司登记 / 市场准入"的相关政策、公告和信息更新。引擎为配置驱动——只要在 `config/config.json` 的 `monitor_sites` 里加一条（网址 + 关键词），即可监控任意政府网站，不必改代码。

## 功能特点

- **自动监控**：每2天自动检查指定政府网站
- **关键词过滤**：专注于"OPC一人公司"相关内容
- **变化检测**：智能识别新发布或更新的信息
- **即时通知**：发现新内容时立即推送通知
- **历史记录**：保存检查记录，避免重复通知

## 监控网站（国家 / 省 / 市 三级）

**🇨🇳 国家级**
1. **国家市场监管总局·登记注册局·政策法规**
   - 网址：https://www.samr.gov.cn/djzcj/zcfg/index.html
   - 监控范围：企业登记注册相关政策法规（一人公司政策的源头）

**🏛️ 省级（广东）**
2. **广东省市场监管局·政策文件**
   - 网址：https://amr.gd.gov.cn/zwgk/zcfg/index.html
3. **广东省市场监管局·通知公告**
   - 网址：https://amr.gd.gov.cn/zwgk/tzgg/index.html

**🏙️ 市级（深圳 / 珠海）**
4. **深圳市市场监管局·通知公告**
   - 网址：https://amr.sz.gov.cn/xxgk/qt/tzgg/index.html
5. **珠海香洲区政府门户**
   - 网址：https://www.zhxz.gov.cn/
6. **珠海香洲区政府信息公开平台**
   - 网址：https://www.zhxz.gov.cn/zhxztzzx/gkmlpt/index
7. **珠海市政府规章文件**
   - 网址：https://www.zhuhai.gov.cn/zw/fggw/gfxwj/xzq/

> 想加更多城市/省份：复制 `config.json` 里任一条目，改 `name`/`url`/`keywords` 即可，引擎自动适配。

## 安装要求

### 系统依赖
- Python 3.8+
- 以下Python包：
  - `requests` >= 2.28.0
  - `beautifulsoup4` >= 4.11.0
  - `lxml` >= 4.9.0

### 安装依赖
```bash
pip install requests beautifulsoup4 lxml
```

或使用技能内置的安装脚本：
```bash
python scripts/install_deps.py
```

## 配置说明

技能配置文件位于 `config/config.json`：

```json
{
  "monitor_sites": [
    {
      "name": "珠海香洲区政府门户",
      "url": "https://www.zhxz.gov.cn/",
      "check_interval_hours": 48,
      "keywords": ["OPC一人公司", "一人公司", "OPC", "个人独资企业"]
    },
    {
      "name": "香洲区政府信息公开",
      "url": "https://www.zhxz.gov.cn/zhxztzzx/gkmlpt/index",
      "check_interval_hours": 48,
      "keywords": ["OPC一人公司", "一人公司", "OPC"]
    },
    {
      "name": "珠海市政府规章",
      "url": "https://www.zhuhai.gov.cn/zw/fggw/gfxwj/xzq/",
      "check_interval_hours": 48,
      "keywords": ["OPC一人公司", "一人公司", "OPC", "公司登记"]
    }
  ],
  "notification": {
    "method": "openclaw",
    "channel": "webchat"
  },
  "storage": {
    "data_dir": "data",
    "history_file": "check_history.json"
  }
}
```

### 配置参数说明

- **monitor_sites**：监控网站列表
  - `name`：网站名称
  - `url`：监控网址
  - `check_interval_hours`：检查间隔（小时）
  - `keywords`：关键词列表，用于过滤相关内容

- **notification**：通知设置
  - `method`：通知方式，支持 `openclaw`、`stdout`
  - `channel`：OpenClaw通知渠道

- **storage**：数据存储设置
  - `data_dir`：数据存储目录
  - `history_file`：检查历史记录文件

## 使用方法

### 1. 手动运行检查
```bash
python scripts/monitor.py --config config/config.json
```

### 2. 设置定时任务（推荐）
使用OpenClaw的cron功能设置每2天自动检查：

```json
{
  "name": "OPC一人公司信息监控",
  "schedule": {
    "kind": "every",
    "everyMs": 172800000  // 48小时 = 2天
  },
  "payload": {
    "kind": "agentTurn",
    "message": "运行zh-opc-monitor技能，检查政府网站关于OPC一人公司的最新信息"
  },
  "sessionTarget": "isolated",
  "delivery": {
    "mode": "announce",
    "channel": "webchat"
  }
}
```

### 3. 查看监控日志
```bash
cat logs/monitor.log
```

## 工作原理

1. **内容抓取**：使用HTTP请求获取网页内容
2. **内容解析**：使用BeautifulSoup解析HTML，提取文本内容
3. **关键词过滤**：筛选包含关键词的相关内容
4. **变化检测**：计算内容哈希值，与历史记录比较
5. **通知发送**：发现新内容时发送通知

### 变化检测算法

- 对每个网页计算内容哈希值（MD5）
- 比较当前哈希值与上次检查的哈希值
- 如果哈希值不同且包含关键词，则判断为有更新
- 记录新的哈希值到历史文件

## 输出格式

发现新内容时的通知格式：

```
🔍 OPC一人公司信息监控发现更新！

📌 网站：珠海香洲区政府门户
🔗 网址：https://www.zhxz.gov.cn/
📅 发现时间：2026-03-28 14:30:00

📋 内容摘要：
[提取的相关内容摘要...]

📊 匹配关键词：OPC一人公司、一人公司

⚠️ 注意：请访问原网站查看完整信息。
```

## 故障排除

### 常见问题

1. **无法连接网站**
   - 检查网络连接
   - 验证网址是否正确
   - 检查防火墙设置

2. **未检测到更新**
   - 确认关键词设置是否正确
   - 检查网页内容结构是否变化
   - 查看监控日志获取详细信息

3. **重复通知**
   - 清除历史记录文件重新开始监控
   - 调整关键词过滤条件

### 查看详细日志
```bash
tail -f logs/monitor.log
```

## 文件结构

```
zh-opc-monitor/
├── SKILL.md                  # 技能说明文件
├── config/
│   ├── config.json          # 主配置文件
│   └── config.example.json  # 配置示例文件
├── scripts/
│   ├── monitor.py           # 监控主程序
│   ├── install_deps.py      # 依赖安装脚本
│   └── utils.py             # 工具函数
├── data/
│   └── check_history.json   # 检查历史记录
├── logs/
│   └── monitor.log          # 监控日志
└── README.md                # 项目说明文档
```

## 开发说明

### 扩展监控网站
1. 在`config/config.json`中添加新的网站配置
2. 确保网站支持HTTP访问
3. 设置适当的关键词和检查间隔

### 修改关键词
编辑配置文件中的`keywords`字段，添加或删除关键词。

### 调整检查频率
修改`check_interval_hours`参数，单位为小时。

## 许可证

MIT License

## 贡献指南

欢迎提交Issue和Pull Request来改进本技能。

## 更新日志

### v1.0.0 (2026-03-28)
- 初始版本发布
- 支持三个政府网站监控
- 实现关键词过滤和变化检测
- 集成OpenClaw通知功能
````

## File: README.md
upstream: https://github.com/huangyaling658-creator/zh-opc-monitor/blob/HEAD/README.md

````text
# 珠海政府网站OPC一人公司信息监控技能

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

一个用于监控珠海市政府网站关于"OPC一人公司"相关政策、公告和信息更新的自动化监控技能。

## 功能特性

- 🕵️ **自动监控**：定期检查珠海市政府相关网站
- 🔍 **关键词过滤**：专注"OPC一人公司"相关内容
- 📊 **智能检测**：基于内容哈希值的变化检测
- 🔔 **即时通知**：发现更新时立即发送通知
- 📁 **历史记录**：保存检查记录，避免重复通知
- ⚙️ **可配置**：支持自定义监控网站、关键词和检查频率

## 监控网站

本技能监控以下政府网站：

1. **珠海香洲区政府门户网站** - https://www.zhxz.gov.cn/
2. **香洲区政府信息公开平台** - https://www.zhxz.gov.cn/zhxztzzx/gkmlpt/index
3. **珠海市政府规章文件** - https://www.zhuhai.gov.cn/zw/fggw/gfxwj/xzq/

## 快速开始

### 1. 克隆仓库
```bash
git clone https://github.com/huangyaling658-creator/zh-opc-monitor.git
cd zh-opc-monitor
```

### 2. 安装依赖
```bash
python scripts/install_deps.py
```

或者手动安装：
```bash
pip install requests beautifulsoup4 lxml
```

### 3. 配置监控
复制示例配置文件：
```bash
cp config/config.example.json config/config.json
```

编辑配置文件 `config/config.json`：
```json
{
  "monitor_sites": [
    {
      "name": "珠海香洲区政府门户",
      "url": "https://www.zhxz.gov.cn/",
      "keywords": ["OPC一人公司", "一人公司", "OPC"],
      "check_interval_hours": 48
    }
  ]
}
```

### 4. 运行监控
单次检查：
```bash
python scripts/monitor.py --config config/config.json
```

连续监控（每48小时检查一次）：
```bash
python scripts/monitor.py --config config/config.json --continuous --interval 48
```

## OpenClaw集成

### 作为技能使用
1. 将本技能目录复制到OpenClaw技能目录：
   ```bash
   cp -r zh-opc-monitor ~/.openclaw/workspace/skills/
   ```

2. 在OpenClaw中运行：
   ```
   运行zh-opc-monitor技能，检查政府网站关于OPC一人公司的最新信息
   ```

### 设置定时任务
使用OpenClaw的cron功能设置每2天自动检查：

```json
{
  "name": "OPC一人公司信息监控",
  "schedule": {
    "kind": "every",
    "everyMs": 172800000  // 48小时 = 2天
  },
  "payload": {
    "kind": "agentTurn",
    "message": "运行zh-opc-monitor技能，检查政府网站关于OPC一人公司的最新信息"
  },
  "sessionTarget": "isolated",
  "delivery": {
    "mode": "announce",
    "channel": "webchat"
  }
}
```

## 配置说明

### 主要配置项

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| `monitor_sites` | 监控网站列表 | 必填 |
| `notification.method` | 通知方式 (`openclaw`/`stdout`) | `openclaw` |
| `storage.data_dir` | 数据存储目录 | `data` |
| `request.timeout` | 请求超时时间（秒） | `30` |

### 网站配置示例
```json
{
  "name": "网站名称",
  "url": "https://example.com",
  "keywords": ["关键词1", "关键词2"],
  "check_interval_hours": 48,
  "content_selector": "body",
  "enabled": true
}
```

## 输出示例

发现更新时的通知格式：

```
🔍 OPC一人公司信息监控发现更新！

📌 网站：珠海香洲区政府门户
🔗 网址：https://www.zhxz.gov.cn/
📅 发现时间：2026-03-28 14:30:00

📋 内容摘要：
根据最新政策，OPC一人公司的注册流程已简化...
企业可通过在线平台提交申请...

📊 匹配关键词：OPC一人公司、一人公司

⚠️ 注意：请访问原网站查看完整信息。
```

## 文件结构

```
zh-opc-monitor/
├── SKILL.md                  # 技能说明文档
├── README.md                 # 项目说明文档
├── config/
│   ├── config.json          # 主配置文件
│   └── config.example.json  # 配置示例文件
├── scripts/
│   ├── monitor.py           # 监控主程序
│   ├── install_deps.py      # 依赖安装脚本
│   └── utils.py             # 工具函数
├── data/
│   └── check_history.json   # 检查历史记录
└── logs/
    └── monitor.log          # 监控日志
```

## 技术细节

### 监控原理
1. **内容抓取**：使用HTTP请求获取网页内容
2. **文本提取**：使用BeautifulSoup解析HTML并提取文本
3. **关键词过滤**：筛选包含关键词的相关内容
4. **变化检测**：计算内容MD5哈希值，与历史记录比较
5. **通知发送**：发现新内容时发送通知

### 变化检测算法
- 对每个网页的文本内容计算MD5哈希值
- 与上次检查的哈希值进行比较
- 如果哈希值不同且包含关键词，则判断为有更新
- 更新历史记录中的哈希值

## 故障排除

### 常见问题

1. **无法连接到网站**
   - 检查网络连接
   - 验证网址是否正确可访问
   - 检查防火墙设置

2. **未检测到更新**
   - 确认关键词设置是否正确
   - 检查网页内容结构是否变化
   - 查看监控日志获取详细信息

3. **重复通知**
   - 清除 `data/check_history.json` 文件重新开始监控
   - 调整关键词过滤条件

### 查看日志
```bash
tail -f logs/monitor.log
```

### 调试模式
```bash
# 修改配置中的日志级别
"logging": {
  "level": "DEBUG"
}
```

## 扩展开发

### 添加新的监控网站
1. 在 `config/config.json` 中添加新的网站配置
2. 设置适当的URL和关键词
3. 调整检查频率

### 自定义通知格式
修改 `scripts/utils.py` 中的 `format_notification` 函数。

### 支持更多通知方式
扩展 `OPCMonitor.send_notification` 方法，添加新的通知渠道。

## 许可证

本项目基于 MIT 许可证开源。详见 [LICENSE](LICENSE) 文件。

## 贡献指南

欢迎提交Issue和Pull Request来改进本技能！

### 开发流程
1. Fork本仓库
2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 创建Pull Request

## 更新日志

### v1.0.0 (2026-03-28)
- 初始版本发布
- 支持三个政府网站监控
- 实现关键词过滤和变化检测
- 集成OpenClaw通知功能

## 联系方式

如有问题或建议，请通过以下方式联系：

- GitHub Issues: [提交问题](https://github.com/huangyaling658-creator/zh-opc-monitor/issues)
- 邮箱: [通过GitHub个人资料查看]

---

**注意**：本工具仅用于信息监控目的，请遵守相关网站的使用条款和 robots.txt 规定。
````
