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