SKILL.md for wechat-video-search
Description
微信视频号视频搜索技能，通过调用 TikHub 官方 API 来获取搜索结果。支持关键词搜索，返回视频下载链接、点赞数、播放量等分析数据。
Configuration
本技能需要一个有效的 TikHub API Token 才能工作。请在您的 ~/.openclaw/config.json 文件中添加以下配置项。
{
"tikhub_api_token": "YOUR_TIKHUB_API_TOKEN"
}
您可以在 TikHub 官网 注册免费获取 Token。
How to Use
命令行调用
python3 scripts/wechat_video_search.py "美食"
参数说明
| 参数 | 说明 | 默认值 |
|---|---|---|
| keyword | 搜索关键词（必填） | - |
| --raw | 输出原始 JSON 数据 | 否 |
示例
# 简单搜索
python3 scripts/wechat_video_search.py "餐饮 鸡鸭鹅"
# 输出原始 JSON
python3 scripts/wechat_video_search.py "熟食" --raw
重要笔记：Windows 环境下的调用
此脚本在 Windows 环境下运行时，可能会因为默认的 GBK 编码无法处理 API 返回的特殊字符（如 emoji）而导致 UnicodeEncodeError。
为了确保脚本能正确执行，必须在调用时使用 -X utf8 参数强制 Python 解释器使用 UTF-8 编码。
正确调用示例 (PowerShell):
& "F:\python 3.10\python.exe" -X utf8 "C:\Users\EDY\.openclaw\skills\wechat-video-search-1.0.0\scripts\wechat_video_search.py" "你的关键词"
API 端点
- 域名: https://api.tikhub.dev（中国大陆用户）
- 路径: /api/v1/wechat_channels/fetch_search_latest
- 方法: GET
- 参数: keywords（URL 编码）
- 认证: Authorization: Bearer <token>
返回数据
{
"code": 200,
"data": [
{
"video_id": "视频 ID",
"desc": "视频描述",
"author": {
"nickname": "作者昵称"
},
"statistics": {
"play_count": 播放量,
"digg_count": 点赞数
},
"video": {
"play_addr": {
"url_list": ["视频下载链接"]
}
}
}
]
}
注意事项
- 中国大陆用户必须使用
api.tikhub.dev域名，不要用api.tikhub.io（被墙） - Token 可与 douyin-video-search、douyin-downloader 等其他 TikHub 系技能共用
- 返回的视频链接可直接下载或用于分析