shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsAPI key required

微信视频号自媒体数据文案助手

调用 ServiceHub 的微信视频号接口，抓取博主主页资料、单视频详情、作品列表翻页、一级评论、二级回复、微信搜一搜及文案提取。

personAuthor: user_87fed1e5hubcommunity
downloadDownload package

微信视频号媒体助手技能 (skill-wechat-video-media-assistant)

项目简介

skill-wechat-video-media-assistant 是专为 Claude Code / Mavis 打造的微信视频号自动化数据助手技能。通过对接 ServiceHub 平台提供的 10 个视频号全功能后端接口，为用户提供一站式的博主资料抓取、视频元数据解析、主页翻页、评论采集、微信搜一搜以及 ASR 语音转录与大模型文案整理能力。

业务架构与数据流程

flowchart TD
    User([用户自然语言 / 视频号链接]) --> Agent[Claude Code / Agent]
    Agent --> Router{意图识别与参数补齐}
    
    Router -->|博主资料| CLI_Blogger[wechat_video_tool.py blogger]
    Router -->|主页作品翻页| CLI_Videos[wechat_video_tool.py videos]
    Router -->|单视频详情| CLI_Detail[wechat_video_tool.py detail]
    Router -->|评论及回复| CLI_Comment[wechat_video_tool.py comments/replies]
    Router -->|搜一搜| CLI_Search[wechat_video_tool.py search]
    Router -->|文案处理| CLI_Text[wechat_video_tool.py text]
    
    CLI_Blogger --> ServiceHub[ServiceHub 后端 API]
    CLI_Videos --> ServiceHub
    CLI_Detail --> ServiceHub
    CLI_Comment --> ServiceHub
    CLI_Search --> ServiceHub
    CLI_Text --> ServiceHub
    
    ServiceHub --> DB[(MySQL 独立库: servicehub_channels)]
    ServiceHub --> TikHub[TikHub WeChat Channels V2]
    ServiceHub --> ASR_LLM[阿里云 ASR / MiniMax LLM]
    
    DB -.->|历史文案回填融合| ServiceHub
    ServiceHub -->|标准响应 JSON| Agent
    Agent --> Output([结构化呈现 / 文案导出 / 指标分析])

文件目录结构

skill-wechat-video-media-assistant/
├── SKILL.md                 # 核心工作说明书 (符合 ClaudeCode 规范与 8 大小节)
├── README.md                # 项目架构与使用说明
├── INSTALL.md               # 本地安装与配置指引
├── requirements.txt         # 基础依赖 (python-dotenv)
├── .env.example             # 环境变量模板
├── .gitignore               # 凭证隔离与缓存忽略规则
├── commands/
│   └── skill-wechat-video-media-assistant.md  # Slash Command 定义
├── references/
│   └── api_spec.md          # 详细接口字段、请求响应体与计费规则
└── scripts/
    └── wechat_video_tool.py # 确定性命令行调用脚本

获取与安装

1. 依赖安装

cd skill-wechat-video-media-assistant
pip install -r requirements.txt

2. 凭证配置

复制 .env.example 为 .env 并填入 ServiceHub 账号凭证：

cp .env.example .env

或直接在命令行中传入凭证并持久化：

python scripts/wechat_video_tool.py detail --share-text "https://weixin.qq.com/sph/xxx" --username "your_user" --password "your_pass" --save-credentials

凭证安全与隔离规范

  1. 绝不硬编码：源码中严禁出现任何明文密码、passtoken 或私人令牌。
  2. 多层安全隔离：.gitignore 严格忽略 .env、data/ 及 credentials.json，防止凭证泄漏至公开代码仓库。
  3. 多级读取兼容：按 命令行参数 > 专属环境变量 > 共享环境变量 > 本地凭证文件 的优先级智能解析。

核心设计决策

  1. 单入口对话式交互：用户只需发送自然语言或视频号分享链接，Agent 自动推断子命令与参数，无需记忆底层命令。
  2. 0 积分保护优先：默认以 extract（读取缓存）模式运行，仅在用户显式要求“更新/最新/刷新”时切换为 update 模式扣减 12.5 积分。
  3. 数据库历史文案自动融合：update 模式拉取作品时，后端自动查询并回填已入库的 ASR 与大模型文案，增量更新互动数据同时无损保留文案。
  4. 断点游标与反查博主：支持输入视频号任一视频短链自动反查博主开启全量作品抓取，并返回 next_cursor（last_buffer）支持断点续翻。

平台发布指南

1. 腾讯 SkillHub 发布配置

| 配置项 | 推荐填写内容 | 说明 | | :--------- | :--------------------------------------------------------------------------------- | :------------------------------------------ | | 图标 | 推荐选择视频、播放器或微信绿色系图标 | 建议 1:1 正方形图标 | | Slug* | skill-wechat-video-media-assistant | 技能英文标识（唯一命名，系统显示 ✓ 可用） | | 显示名称* | 微信视频号自媒体数据文案助手 | 平台展示名称，中文更清晰直观 | | 版本号* | 1.0.0 | 初始发布版本号 | | 描述 | 基于 ServiceHub 微信视频号接口，一键完成博主资料统计、主页作品翻页、视频互动指标查询、评论与二级回复抓取、微信搜一搜以及语音转写文案提取与智能摘要。 | 可留空自动继承 SKILL.md 的 description，也可手动填入精简介绍 |

2. 腾讯 IMA 知识库发布配置

| 配置项 | 推荐填写内容 | 说明 | | :--- | :--- | :--- | | 名称* | 微信视频号自媒体数据文案助手 | 技能展示名称 | | 分类标签* | 自媒体 | 垂直领域标签 | | 选择文件* | skill-wechat-video-media-assistant.zip | 包含 SKILL.md 及脚本，排除 .git 与敏感文件 | | 使用说明* | 详见下方使用说明模板 | 包含技能能力、ServiceHub 凭证获取与积分规则说明 | | 使用示例 | 详见下方提示例句 | 自然语言交互例句 | | 原创声明 | 开启 🟢 | 填写作者名并勾选平台协议 |

IMA 使用说明模板

### 📖 技能介绍
本技能专为微信视频号自媒体创作者与运营人员打造。通过自然语言对话即可一键调用 ServiceHub 的微信视频号公开接口，提供博主全量作品翻页、视频互动指标监测、评论与二级回复洞察、微信搜一搜以及语音转录文案提取与大模型摘要整理等全流程数据支持。

### 🚀 核心能力
1. **博主资料与作品翻页**：输入视频号分享文本或链接，自动反查博主主页并支持分页抓取历史作品列表。
2. **单视频详情与互动指标**：精准获取点赞、收藏、转发、评论 4 大互动数据及 CDN 播放地址。
3. **评论与二级回复采集**：支持连续翻页抓取视频根评论与二级回复，快速分析受众反馈与互动氛围。
4. **语音文案转写与 AI 摘要**：提取视频高精度 ASR 语音文案，一键生成分段整理稿与核心要点摘要。
5. **微信搜一搜作品检索**：按关键词检索微信搜一搜视频号作品，辅助爆款选题调研。

### 🔑 前置准备与凭证获取（重要）
本技能基于 **ServiceHub** 微信视频号数据接口运行：
1. **账号注册与获取**：请前往 ServiceHub 官网（https://www.ccailab.top）注册账号并获取您的用户名与密码（或 passtoken）。
2. **凭证配置**：首次使用时，只需在对话中直接发送您的 ServiceHub 用户名与密码，AI 助手将自动保存并复用，后续无需重复输入。
3. **积分说明**：接口按次扣除 ServiceHub 对应积分，提取已有缓存数据通常不扣积分，更新最新数据需扣点时 AI 助手会提前向您确认。

IMA 使用示例

示例 1（语音转写文案与总结）：
提取这个视频号作品的完整文案并做要点总结：微信视频号分享：【AI工具实操】https://channels.weixin.qq.com/...

示例 2（博主作品翻页抓取）：
帮我抓取这个视频号博主最近发布的 10 条视频作品列表

示例 3（视频数据详情）：
查询这条视频号作品的点赞、收藏、转发和评论数据：https://weixin.qq.com/sph/xxxx

示例 4（微信搜一搜与选题）：
在微信搜一搜中检索关于“大模型自媒体运营”的最新视频号作品