公众号爆文分析专家
功能描述
输入微信公众号名称,输出竞品内容策略分析报告,包含 7 个板块:
- 账号概览(粉丝数/平均阅读/总互动)
- 高阅读文章 TOP 5
- 高点赞文章 TOP 5
- 发文规律(频率/时段分布)
- 标题高频关键词
- 近期文章列表(含阅读/点赞数据)
- 内容策略建议
每次查询 1.99 元,数据来自微信公众号搜索和文章阅读数据实时采集。
付费前置检查
调用本 Skill 前,检查当前 Agent 是否已安装 weixinpay 插件(extension):
-
已安装:可继续提供付费服务
-
未安装:需要引导用户安装微信支付插件后才能使用。告诉用户:
"本 Skill 是付费服务(每次 1.99 元),需要先安装微信支付插件才能使用。安装方法:
- 在 WorkBuddy/QClaw 中搜索并安装「weixinpay」插件
- 安装完成后绑定微信支付 AI 专属卡
- 回来再试一次即可"
然后终止流程,等用户安装好后再继续。
输入要求
收集用户信息后,构造以下 JSON 作为 query:
{
"account": "蜜雪冰城",
"pages": 1
}
| 参数 | 说明 | 必填 | 默认值 |
|------|------|------|--------|
| account | 微信公众号名称,如"蜜雪冰城""瑞幸咖啡""黎贝卡的异想世界" | 三选一 | — |
| biz | 公众号biz ID(从该号任意文章链接的 __biz 参数读取) | 三选一 | — |
| url | 该公众号任意一篇真实文章完整链接(小号/未认证号最可靠的定位方式) | 三选一 | — |
| pages | 文章翻页数(1-3,每页10篇) | 否 | 1 |
账号定位策略(v1.1.1起,三级通道):url 直通最可靠 > account 名称(搜索→精确查询→文章搜索三段兜底)> biz。小号/未认证号可能未被搜索收录,此时服务端会自动用"文章搜索"找一篇该号文章完成定位;若仍失败,引导用户提供该号任意文章链接。
工作流程
第一步:请求资源
向商户服务发起 POST 请求(URL 由环境变量 SKILL_API_BASE 指定,默认 https://wechat-analysis-igryhhumvj.cn-beijing.fcapp.run):
curl -X POST ${SKILL_API_BASE:-https://wechat-analysis-igryhhumvj.cn-beijing.fcapp.run}/api/resource \
-H "Content-Type: application/json" \
-d '{"query": "{\"account\":\"蜜雪冰城\",\"pages\":1}"}'
注意:query 值是 JSON 字符串(需序列化),不是 JSON 对象。
第二步:处理 402 响应
如果收到 HTTP 402 响应,weixinpay 插件会拦截并完成支付流程,无需手动调用支付接口。
第三步:支付成功后重新请求获取内容(⚠️ 必须执行)
支付成功后,必须重新发起请求获取付费内容。重试规则:
- JSON body 与首次请求完全一致
- 额外携带两个 Header:将 402 响应中的
WeixinPay-Required和X-Out-Trade-No原样带上
POST ${SKILL_API_BASE:-https://wechat-analysis-igryhhumvj.cn-beijing.fcapp.run}/api/resource
Content-Type: application/json
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>
{"query": "用户的原始 query(与第一步完全一致)"}
第四步:处理响应
| HTTP 状态 | code 字段 | 行为 |
|-----------|-----------|------|
| 200 | SUCCESS | 提取 content 字段中的 Markdown 报告,直接呈现给用户 |
| 402 | NOT_PAID | 告知用户"支付验证中,请稍后重试" |
| 200 | REFUNDED | 告知用户"该服务暂时无法提供内容,已自动退款" |
| 500 | FULFILL_AND_REFUND_FAILED | 告知用户"服务异常且退款失败,请联系客服 skillhub@tencent.com" |
将 content 字段中的 Markdown 原文直接呈现给用户即可。
输出说明
报告包含 7 个板块,均为 Markdown 格式:
- 账号概览 — 粉丝数、平均阅读、总互动
- 高阅读文章 TOP 5 — 阅读量最高的文章及数据
- 高点赞文章 TOP 5 — 用户最认可的内容
- 发文规律 — 发文频率和时段分布
- 标题高频关键词 — 选题方向分析
- 近期文章列表 — 最近发布的文章及阅读数据
- 内容策略建议 — 可执行的建议
错误处理
- 如果返回
ACCOUNT_NOT_FOUND:提示用户确认公众号名称,或引导用户提供该号任意文章链接、从中提取__biz参数重试(小号/未认证号可能未被搜索收录) - 如果返回
NO_ARTICLES:提示用户该公众号暂无文章数据 - 如果返回
NEED_ARTICLE_URL:已定位到账号但拿不到文章列表,引导用户提供该号任意一篇真实文章的完整链接,用url参数重试 - 如果返回
BAD_QUERY:按返回的 message 修正 query 后重试
使用示例
示例 1:竞品内容摸底
用户:"帮我看看蜜雪冰城公众号的内容策略"
Agent 操作:
- 构造 query:
{"account":"蜜雪冰城","pages":1} - 发起 POST 请求 → 402 → 支付 → 重试 → 获取报告
示例 2:学习内容运营
用户:"瑞幸咖啡公众号最近发了什么?效果怎么样?"
Agent 操作:
- 构造 query:
{"account":"瑞幸咖啡","pages":1} - 发起 POST 请求 → 402 → 支付 → 重试 → 获取报告
示例 3:找对标账号
用户:"帮我分析一下黎贝卡的异想世界公众号"
Agent 操作:
- 构造 query:
{"account":"黎贝卡的异想世界","pages":1} - 发起 POST 请求 → 402 → 支付 → 重试 → 获取报告
注意事项
- 必须先通过"付费前置检查"确认 weixinpay 插件已安装
- 支付由 weixinpay 插件完成,Skill 无需手动调用支付接口
- 支付成功后必须主动发起重试请求
- query 必须是 JSON 字符串,不是 JSON 对象
- 不要缓存或修改商户返回的报告内容,原样呈现
Scan to join WeChat group