wechat-data-exporter
# SKILL.md for wechat-data-exporter
## Description
一个经过实战检验的、可靠的技能,用于从大麦内部系统 (`boss-ip.da-mai.com`) 导出指定客户(视频号)的数据报告。它通过直接调用后端 API 来获取数据,无需任何浏览器自动化,实现了高效、稳定的数据抓取。
该技能已被重构,具备良好的可移植性,所有输出文件都会被安全地保存在 `workspace/data/wechat-data-exporter` 目录下。
## How to Use
当需要为特定客户下载或导出视频号相关的数据时,应调用此技能。它通常作为其他分析类技能(如 `wechat-video-data-analyzer`)的上游依赖被自动调用。
### Input
核心脚本 (`scripts/export.py`) 接受一个命令行参数:
* **`client_name`** (string): 需要导出数据的客户的完整名称,例如 "峡州国旅"。
### Actions
1. **动态路径**: 脚本会自动查找 `.openclaw` 的根目录,确保输出路径的正确性。
2. **URL编码**: 将输入的 `client_name` 进行URL编码,以作为API请求的 `author` 参数。
3. **API调用 (无签名)**: 脚本会遍历一个预定义的API端点列表,针对短视频、直播、私信等不同数据类型,**仅使用 `author` 参数发起直接的GET请求**。
4. **文件存储**: 将API返回的数据文件(通常是 `.xlsx` 格式)保存到 `C:\Users\EDY\.openclaw\workspace\data\wechat-data-exporter` 目录中。
5. **命名规范**: 文件名遵循 `{client_name}-{data_type}-{timestamp}.xlsx` 的格式。
6. **报告输出**: 所有操作完成后,会生成一个包含所有已下载文件路径的 `.json` 报告,并将其路径以 `REPORT_PATH:` 的标准格式打印出来,供其他工具或上游技能捕获和使用。
### Example Invocation
```powershell
# 直接调用
& "F:\python 3.10\python.exe" "C:\Users\EDY\.openclaw\skills\wechat-data-exporter\scripts\export.py" "峡州国旅"
```
标签
skill
ai