返回板块

G23 红狐数据API

类别：技术规范
名称释义：wechat-cover / 公众号配图样本数据接口
落位：~/.workbuddy/spec\3.行政法规\范式\G5_红狐数据API.md
版本：V1.0.1（2026-08-31 成文规范整改：四篇式结构 + 模态词等级表 + 术语和定义 + 失效模式表 + 附录 A–D）

---

工作流（启动顺序 + 升级闭环 · 全域硬约束）

本规范为对应对象（skill/专家）升级/迭代/训练/知识注入的唯一权威依据。任何涉及该对象的改动，必须严格按以下五步闭环执行，缺一不可、全域强制。

启动顺序（每次会话/任务启动，全域铁律）

1. 读 MEMORY（拿规则）：首步读 ~/.workbuddy/MEMORY.md，未读不得动手。
2. 跑 _tools 代码（强制）：凡 .docx/.xlsx 交付物命名与skill/专家迭代升版四件套验证，强制调用 ~/.workbuddy/_tools/（deliverable.py / check_deliverables.py），禁止手敲文件名。
3. 查 README（看 API）：动手前查 ~/.workbuddy/README/<对象目录名>/README.md；无独立 README 时以 SKILL.md 为 API 权威。
4. 查技术规范与 SOP（升级/建夹必过闸）：①升级/迭代/训练/知识注入前先读本范式（~/.workbuddy/spec\3.行政法规\范式\ 对应文件）；②每个新任务启动（含任何 skill 触发产出）先读 S01+S02，建「三字标题_YYYY-MM-DD_HHMM/产出/素材/」，产出落 产出/。
5. 收尾总结（每次任务结束后，200 字铁律）：任何任务每次结束后，在最终回复中用约 200 字总结「当前进展 + 核心结论 + 遗留问题」三要素（见 ~/.workbuddy/spec\3.行政法规\SOP\S10_任务收尾总结SOP.md）；与 S03/S04 收尾三件套、skill/专家迭代升版四件套并存、互不替代。

升级五步闭环（硬约束）

• 闭环链路：读 MEMORY → 跑 _tools → 查 README → 查技术规范与 SOP → 建任务夹（S02），五步必须闭环、全域可执行、覆盖全部 SOP（含 S02 建文件夹）、硬约束。
• 只按本技术规范修改：改动逐条对照本范式对齐，不重写整个 SKILL.md；不碰全域规则（MEMORY.md）与工具链（_tools/），除非其自身变化。
• 无技术规范，拒绝升级：定位不到或用户未提供本范式 → 立即停下、禁止动手改，并回复「请提供其技术规范（如电池专家技术规范）」。

来源：wechat-cover SKILL.md（红狐数据 API 接入）

文件：C:\Users\xub\.workbuddy\skills\wechat-cover\SKILL.md

---

name: wechat-cover
display_name: 公众号爆款封面设计
display_name_en: WeChat Viral Cover Designer
description: 公众号爆款封面AI设计工具。基于全网每日收录的10w+文章数据，获取同赛道爆款封面视觉元素，通过AI分析总结高转化视觉规律，生成贴合文章内容、符合平台流量审美的封面设计方案。当用户设计公众号封面、生成封面方案、查询爆款封面规律时使用。触发词：公众号封面、封面设计、爆款封面、封面方案、封面生图。
description_zh: 基于全网每日收录的10w+爆款文章数据，分析同赛道封面视觉元素，AI生成高转化封面设计方案。
description_en: AI-powered WeChat cover design tool based on daily viral article
data. Analyzes visual patterns and generates high-conversion cover designs.
category: design
version: 1.3.1
author: 红狐数据
disable-model-invocation: true

---

公众号封面图制作

📋 概述

基于全网每日收录的爆款文章数据，获取同赛道爆款封面的视觉元素，通过AI分析总结高转化视觉规律，生成贴合文章内容、符合平台流量审美的封面设计方案（含案例+生图提示词）。仅在主Agent中执行，不派发给子Agent。

🎯 触发规则

场景	处理方式
用户提供内容主题/赛道	执行任务流程
用户要求生成封面方案	执行任务流程
用户上传文案或图片要求分析	执行任务流程
用户询问技能功能/用法	仅介绍技能
用户未提供明确创作主题	仅介绍技能

📝 术语规范

统一使用"爆款封面"，禁止使用：爆炸封面→爆款封面、爆炸数据→爆款数据、抓取数据→获取/查询数据、抓取封面→获取封面。

🔒 数据来源

所有爆款数据必须来自接口，禁止联网搜索、使用其他数据源或脑补数据。数据不足时明确告知用户。

🔑 鉴权

获取 API Key

请前往 红狐hub 获取API KEY

配置 API Key

方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中：

{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

方案2: 终端配置

export REDFOX_API_KEY="ak_xxxx..."

⚙️ 前置准备

• 依赖：requests（pip install requests）
• 凭证：环境变量 REDFOX_API_KEY（详见鉴权章节）
• 数据范围：仅含昨天至30天前的数据，默认查询近30天

🔄 操作流程

步骤1：意图解析

结构化解析用户需求，提取4个维度：

维度	说明	示例
内容主题	优先领域词	护肤、穿搭、美食、职场
内容类型	内容形式	干货、测评、种草、教程
风格偏好	视觉/调性	专业、吸引点击、情绪、极简
核心关键词	搜索关键词	秋冬、美白、护肤、干皮

提取2-5个核心关键词（逗号分隔），优先细分领域词，结合风格偏好补充场景词。

步骤2：爆款数据查询

# 有赛道关键词
python3 scripts/fetch_explosive_covers.py --keyword <关键词1,关键词2,关键词3>
# 无赛道关键词
python3 scripts/fetch_explosive_covers.py --keyword ""

• 最多5个关键词，总长度≤200字符
• 关键词整体一次传入接口，不做拆分循环调用
• 时间参数默认不传（接口自行决定默认范围）；用户指定"近N天"时 startDate = 今天 - (N-1)天

步骤3：智能匹配筛选

数据量	处理
≥20条	直接使用
<20条	扩展关键词（如：美白→美白、护肤、美白祛斑），重新查询，合并数据

筛选规则：按阅读数从高到低排序，取前20条。关键词扩展最多1-2次，每次2-3个相似词。

步骤4：AI图像分析与特征提取

1. 解析脚本返回的JSON数据（含 articles 文章数组，以及 latestHotArticles、hotTopics、relatedSearches 辅助数据）
2. 提取 imageUrl 字段合并为封面候选池——直接使用原始值，不做任何修改（新接口字段名为 imageUrl，旧接口为 coverUrl，脚本已做兑容）
3. 按互动量从高到低取前20条
4. 逐张分析封面图（使用原生图片理解能力，直接访问 imageUrl）

7维度分析：

维度	分析内容
文字内容	是否有文字、内容、字体大小、位置、颜色、醒目程度
主体元素	人物/产品/场景/图案等主要视觉元素
色彩特征	主色调、配色方案、对比度、冷暖色调
构图布局	画面结构、元素分布、主体位置、留白处理
视觉风格	实拍/插画/拼贴/极简/炫酷等风格类型
点击吸引力	痛点/好奇/美感/实用——为什么吸引点击
尺寸检测	宽x高，是否合格（≥10px）

图片过滤规则：
- 空白图片（纯色块、无内容）：标注"需过滤"，后续所有环节排除
- 小尺寸图片（宽或高 <10px）：全部过滤
- 输出前二次检查：确保无空白/小尺寸图片混入

分类汇总：将相似风格的封面归为同一类，统计特征规律（分类前先过滤空白图片）。

步骤5：输出HTML分析报告与设计方案

使用 references/report_template.html（JS渲染型模板），只需注入 JSON 数据，禁止在输出时临时生成完整 HTML。

1. 复制模板到输出文件：cp references/report_template.html ./爆款封面分析报告_{关键词}.html
2. 将分析结果组装为 JSON 对象（格式见 references/report_template.md）
3. 用 SearchReplace 在输出文件（非模板原文件）中将 __REPORT_DATA__ 的默认空值替换为实际 JSON
4. 执行 open ./爆款封面分析报告_{关键词}.html 在浏览器中打开

JSON 结构（只需填充以下字段，无需生成任何 HTML）：

{
  "keyword": "用户关键词",
  "analysisCount": 20,
  "styles": [{ "name": "", "count": 0, "coreVisual": "", "features": "", "covers": [] }],
  "plans": [{ "name": "", "coreVisual": "", "case": { "imageUrl": "", "url": "", "title": "", "author": "", "reads": "" }, "prompt": "" }]
}

要求	说明
模板	references/report_template.html（JS 渲染型，样式/防盗链已内置）
数据格式	详见 references/report_template.md JSON 数据结构章节
封面展示	按风格类型分类，每类最多5张
案例参考	imageUrl 原始值 + 标题(url链接) + 作者 + 仅阅读数
生图提示词	严格遵循 2.35:1 横版比例

步骤6：用户选择方案并生成封面图

⚠️ 先询问用户，等回复后再生成——不要在用户选择前就生成封面图！

第一阶段（输出报告后立即执行）：HTML模板末尾已包含方案选择区域，展示报告后停止，等待用户回复。

第二阶段（用户回复后执行）：
1. 确认用户选择的方案（1/2/3）及其生图提示词
2. 如用户上传了图片，用原生图片理解能力分析
3. 使用原生图像生成能力生成封面图（2.35:1，900x383像素）
4. 直接展示图片，不需要HTML包裹

步骤7：输出前自检

检查项	内容
风格类型	每类有：名称、频次、核心视觉、关键特征、封面示例
三个方案	各有风格名称、核心视觉、案例参考（不重复）、生图提示词
- 封面图链接使用 imageUrl 字段原始值
图片过滤	无空白图片、无小尺寸图片
用户交互	已询问方案选择并等待回复

⚠️ 注意事项

• 封面图容器比例 2.35:1 (900x383)，使用 object-fit: cover + object-position: center 自适应截取
• HTML添加防盗链 meta 标签 <meta name="referrer" content="no-referrer">
• 案例参考仅保留阅读数（clicksCount），删除点赞和在看
• 封面图用 <a> 标签包裹可点击跳转大图，方案标题用 url 字段链接
• 图像分析使用原生图片理解能力，直接访问封面URL，逐张分析

来源：公众号爆款封面数据接口格式

文件：C:\Users\xub\.workbuddy\skills\wechat-cover\references/gzh_trend_data_format.md

公众号爆款数据格式说明

概览

本文档定义了公众号爆款封面数据查询脚本 fetch_explosive_covers.py 的输入输出格式规范。

接口地址：POST https://redfox.hk/story/api/gzh/search/hotArticleNew

输入格式

脚本参数

python3 scripts/fetch_explosive_covers.py --keyword <关键词> [选项]

参数	必填	说明	默认值
--keyword	是	搜索关键词（支持多个，逗号分隔，空字符串查全站热门）	-
--start-date	否	开始日期，格式 yyyy-MM-dd	不传（接口自行决定）
--end-date	否	结束日期，格式 yyyy-MM-dd	不传（接口自行决定）
--max-items	否	最多展示文章数量	20
--output-format	否	输出格式：text、json 或 markdown	json
--output-file	否	输出文件路径	不输出文件
--debug	否	调试模式	False

输出格式

文章数据字段

每篇文章（articles 数组中的对象）包含以下字段：

文章基本信息

字段名	类型	说明
id	string	文章ID（唯一标识）
title	string	文章标题（可能为空，需从 summary 提取）
summary	string	文章摘要/正文片段
publicTime	string	发布时间（格式：YYYY-MM-DD HH:MM:SS）
url	string	文章链接（完整URL）

作者信息

字段名	类型	说明
author	string	公众号名称/作者名

互动数据

字段名	类型	说明
clicksCount	int	阅读数
watchCount	int	在看数
likeCount	int	点赞数
shareCount	int	分享数
commentsCount	int	评论数

封面图

字段名	类型	说明
imageUrl	string	封面图URL（旧接口字段名为 coverUrl）

评分字段（用于排序）

字段名	类型	说明
totalScore	float	总分（用于排序）
relevanceScore	float	相关性评分
popularityScore	float	热度评分
recencyScore	float	时效评分

⚠️ 新接口缺失字段

以下字段在旧接口（getWxCozeSkillData）中存在，hotArticleNew 接口不返回：

缺失字段	说明	影响
userName	公众号名称	已改为 author 字段
photoId	文章旧ID	已改为 id 字段
oriUrl	文章旧链接	已改为 url 字段
accountId	公众号账号ID	无法拼接二维码链接
userHeadUrl	作者头像	无法展示作者头像

JSON 输出示例

{
  "keyword": "职场",
  "articles": [
    {
      "id": "abc123",
      "title": "职场新人必知的10个技巧",
      "summary": "刚入职场的你是否感到迷茫...",
      "author": "职场达人",
      "publicTime": "2026-07-20 10:30:00",
      "url": "https://mp.weixin.qq.com/s/xxxxx",
      "imageUrl": "https://mmbiz.qpic.cn/mmbiz_jpg/...",
      "clicksCount": 58000,
      "watchCount": 320,
      "totalScore": 85.5,
      "relevanceScore": 8.2,
      "popularityScore": 7.5,
      "recencyScore": 6.0
    }
  ],
  "latestHotArticles": [],
  "hotTopics": [
    { "name": "职场晋升", "count": 120 }
  ],
  "relatedSearches": ["职场沟通", "职场穿搭"]
}

关于封面图

新接口（hotArticleNew）封面图字段名为 imageUrl，旧接口为 coverUrl，脚本已做双字段兑容处理。

使用注意事项

数据获取原则

1. 必须调用脚本查询：不能使用其他方式查询或直接搜索网络资讯
2. 必须等待脚本执行完成：获取返回结果后才能进行后续步骤
3. 必须展示完整数据列表：不能跳过或询问用户

字段说明

1. 标题提取：如果 title 字段为空，从 summary 字段提取前30个字符作为标题
2. 作者名称：使用 author 字段
3. 阅读数格式：整数，脚本中格式化为 1.0w 形式（≥10000时）
4. 文章链接：使用 url 字段

---

模态词等级表与示例约定（STD-D）

本范式条款所用模态词，按五级体系执行，与 RFC 2119 对齐并补其缺失的 RECOMMENDED 级：

中文模态词	英文对应	语义	违反后果
必须	MUST / MUST NOT（否定式）	绝对要求，无任何例外	判 P1 阻断
禁止	MUST NOT	绝对禁止	判 P1 阻断
应	SHALL	要求；若确有例外，须在条款内显式声明例外条件	判 P2 整改
宜	SHOULD（RECOMMENDED）	推荐做法；可不采用，但须记录理由	判 P3 提示
可	MAY	允许，表许可而非能力	不构成违规

表能力时用「能够」，不用「可」。

示例约定：条款下以「例：」引导数值或场景示例，以「反例：」引导错误用法。

术语与定义

下列术语和定义适用于本范式。禁止循环定义（不得以 A 定义 B 又以 B 定义 A）。

术语	定义
wechat-cover	公众号爆款封面AI设计工具：基于全网每日 10w+ 文章数据，分析同赛道封面视觉元素，生成高转化封面方案
爆款封面	统一术语：禁止「爆炸封面/抓取封面/抓取数据」等词，统一用「爆款封面/获取/查询」
REDFOX_API_KEY	红狐hub API 密钥（ak_xxx），环境变量鉴权（openclaw.json env 或终端 export）
fetch_explosive_covers.py	爆款数据查询脚本（--keyword/--start-date/--max-items 等参数，POST /story/api/gzh/search/hotArticleNew）
imageUrl/coverUrl	封面图 URL 字段（新接口 imageUrl、旧接口 coverUrl，脚本双字段兑容；使用原始值不做修改）
7 维度分析	文字内容/主体元素/色彩特征/构图布局/视觉风格/点击吸引力/尺寸检测 七个封面分析维度
图片过滤规则	空白图片（纯色块）与宽或高 <10px 的小尺寸图片全部过滤，输出前二次检查
2.35:1 横版	封面容器比例 2.35:1（900x383 像素），object-fit: cover + object-position: center 自适应截取
智能匹配筛选	数据量 ≥20 条直接使用；<20 条扩展关键词（最多 1-2 次，每次 2-3 个相似词）后重查合并
报告模板	references/report_template.html（JS 渲染型，样式/防盗链内置），只注入 JSON，禁止临时生成 HTML

第二篇 流程与实施

本篇承接本范式既有工作流条款，汇总实施要点（原有条款原文一字未改，本篇仅作结构承接）：

• 启动顺序五步闭环：读 MEMORY → 跑 _tools → 查 README → 查技术规范与 SOP → 建任务夹
• 升级五步闭环：只按本技术规范修改，不重写整个 SKILL.md，不碰全域规则与工具链
• 封面任务流程：意图解析（4 维）→ 脚本查询 → 智能筛选 → 7 维度图像分析 → HTML 报告 → 用户选方案 → 生成封面
• 数据纪律：爆款数据必须来自接口脚本，禁止联网搜索/脑补；数据不足时明确告知用户
• 图片纪律：空白与小尺寸（<10px）一律过滤；imageUrl 用原始值；2.35:1 横版（900x383）
• 交互纪律：先询问用户方案选择并等待回复，再生成封面图

第三篇 风险与失效模式

图3-1 公众号爆款封面生成流程（认知入口）

意图解析(4维)
   │
   ▼
爆款数据查询(fetch_explosive_covers.py)
   │
   ▼
智能匹配筛选(≥20 直接用 / <20 扩词重查)
   │
   ▼
AI 图像分析(7 维度 + 空白/小尺寸过滤)
   │
   ▼
输出 HTML 报告(注入 report_template.html)
   │
   ▼
用户选方案 → 生成封面图(2.35:1 / 900x383)

失效模式对照表（三列：失效模式 / 后果 / 防护条款，必须 100% 可追溯到本范式条款）：

失效模式	后果	防护条款
FM-1 数据造假	联网搜索/脑补爆款数据，未走接口脚本，视觉规律失真	数据来源铁律（必须脚本查询，禁止其他数据源）
FM-2 术语失范	用「爆炸封面/抓取数据」等禁用词，输出口径混乱	术语规范（统一「爆款封面/获取/查询」）
FM-3 图片混入	空白/小尺寸（<10px）封面未过滤，报告质量劣化	图片过滤规则（标注需过滤 + 全部排除 + 二次检查）
FM-4 越权生成	用户选择方案前就生成封面图，交互失序	步骤6 交互纪律（先询问、等回复再生成）
FM-5 模板违例	输出时临时生成完整 HTML 而非注入报告模板	步骤5（report_template.html 只注入 JSON 数据）
FM-6 字段失真	封面 URL 被修改（非 imageUrl 原始值），链接失效	步骤4（原始值直用 + 双字段兑容）

第四篇 保障、记录与附录

评审机制

• 触发：本范式所规范对象升版、或相关工具链脚本变更时必须触发评审。
• 评审人：利衡辨全域治理工作组；对象维护人复核。
• 评审内容：①条款与本范式是否一致；②失效模式表是否覆盖新增风险（见第三篇）；③成文规范符合性（doc_style_check.py 判定结果）。
• 周期：宜每个季度至少一次例行评审；重大变更即时评审。

修订记录

修订记录必须含完整连续版本链，并与正文、头部版本号三处一致（STD-A）。

版本	日期	变更	编制	审核	批准
V1.0.0	2026-08-25	首版（原稿基线，条款未动）	利衡辨工作组	全域治理工作组	衡明合
V1.0.1	2026-08-31	成文规范整改（升次版本）：按《MASTER RULE 技术标准成文规范》补齐——模态词五级等级表、四篇式结构、术语和定义（10 条）、失效模式对照表（6 项）、认知入口图、必备附录 A–D、评审机制、修订记录、审批记录、定稿校核结论、待确认事项闭环记录。原有条款一字未改，仅增补结构与记录。	利衡辨工作组	全域治理工作组	衡明合

审批记录

项	内容
定稿版本	V1.0.1
编制	利衡辨工作组（2026-08-31）
审核	全域治理工作组（2026-08-31）
批准	衡明合（2026-08-31）
生效条件	本范式自批准之日起生效；旧版 V1.0.0 归档 .bak 保留可回退

定稿校核结论

• 校核工具：~/.workbuddy/_tools/doc_style_check.py（母规则 AUTO 条款自动判定器）。
• 校核对象：本文件（~/.workbuddy/spec\3.行政法规\范式\）。
• V1.0.0 基线：P1 不通过 9 项、P2 不通过 5 项。
• V1.0.1 结果：P1 不通过 0 项、P2 不通过 0 项（退出码 0）。
• P3 说明（STD-C-010 示例覆盖率）：该判据按「含示例标记段落占比 ≥30%」计，本范式以自有编号体系为主，示例标记段落占比未达阈值，属判据适用边界问题（非文档缺陷），如实记录。
• 结论：本范式在保持原有条款不变的前提下，完成母规则结构与记录类条款整改；P1/P2 全部清零，可作为 红狐数据API 的升级依据。

待确认事项

编号	事项	提出版本	责任人	状态
Q1	认知入口图现以 ASCII 框图呈现，待具备图形生成条件后替换为正式插图	V1.0.1	利衡辨工作组	待替换
Q2	hotArticleNew 新接口与旧接口 getWxCozeSkillData 字段差异需周期性复核，避免字段失效	V1.0.1	利衡辨工作组	待复核

---

附录 A 速查表

本范式核心要求速查（详见正文对应章节）：

场景	要求	位置
启动顺序五步闭环：读 MEMORY → 跑 _tools → 查 README → 查技术规范与 SOP → 建任务夹	强制闭环	正文工作流章节
升级五步闭环：只按本技术规范修改，不重写整个 SKILL.md，不碰全域规则与工具链	强制闭环	正文工作流章节
封面任务流程：意图解析（4 维）→ 脚本查询 → 智能筛选 → 7 维度图像分析 → HTML 报告 → 用户选方案 → 生成封面	强制闭环	正文工作流章节
数据纪律：爆款数据必须来自接口脚本，禁止联网搜索/脑补；数据不足时明确告知用户	强制闭环	正文工作流章节
图片纪律：空白与小尺寸（<10px）一律过滤；imageUrl 用原始值；2.35:1 横版（900x383）	强制闭环	正文工作流章节
交互纪律：先询问用户方案选择并等待回复，再生成封面图	强制闭环	正文工作流章节

附录 B 术语表

同正文「术语和定义」，共 10 条：wechat-cover、爆款封面、REDFOX_API_KEY、fetch_explosive_covers.py、imageUrl/coverUrl、7 维度分析、图片过滤规则、2.35:1 横版、智能匹配筛选、报告模板。

附录 C 工具链清单

工具	用途	位置
成文规范判定器	母规则 AUTO 条款机器判定	~/.workbuddy/_tools/doc_style_check.py
交付物命名与校验库	交付物路径派生、命名闸	~/.workbuddy/_tools/deliverable.py
规范闸门	无技术规范拒绝升级	~/.workbuddy/_tools/expert_spec_gate.py

附录 D 记录字段明细

字段	含义	引入版本
版本号	本范式当前版本（正文与头部三处一致）	V1.0.0
模态词等级	五级体系（必须/禁止/应/宜/可）	V1.0.1
失效模式编号	FM-N 与防护条款一一对应	V1.0.1