Skill: yyobject/hot-topic-ideator (version 1.0.0)

--- name: hot-topic-ideator description: 生成小红书热点选题和内容创意。当用户提到"热点选题"、"内容创意"、"小红书选题"、"trending topics"、"content ideas"、"热门话题"、"爆款选题"时使用。适用于品牌社媒运营、内容策划、热点借势营销场景。 metadata: {"clawdbot":{"emoji":"🔥","requires":{"bins":["uv"]},"install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)"}]}} --- # 热点选题生成器 (Hot Topic Content Ideator) 基于小红书真实数据，为品牌生成5-10个高质量热点选题创意，输出为专业 HTML 报告并转换为 PDF。 ## 快速开始 **使用示例：** ``` 用户：帮雪碧生成小红书热点选题 用户：给元气森林做5个内容创意 用户：为喜茶策划热点借势内容 ``` ## 环境配置 ### 必需的环境变量 ```bash export CHATDAM_API_TOKEN="YOUR_TOKEN_HERE" ``` ## 工作流程 ### Step 1: 品牌信息收集 **若用户只提供品牌名称，需收集以下信息：** 1. **品牌核心价值观** - 品牌代表什么？ 2. **目标受众** - 主要消费群体特征 3. **应用场景** - 产品典型使用场景 4. **品牌调性** - 活泼/专业/高端/亲民等 5. **竞品品牌** - 主要竞争对手（用于差异化分析） **若用户已提供详细信息，直接进入Step 2。** --- ### Step 2: 生成搜索关键词 基于品牌DNA，生成5-8个搜索关键词： **关键词公式：** | 类型 | 公式 | 示例 | |------|------|------| | 品牌+品类 | [品牌名] [产品类型] | 雪碧 气泡水 | | 品牌+场景 | [品牌名] [使用场景] | 雪碧 火锅 | | 品牌+情绪 | [品牌名] [情感词] | 雪碧 爽快 | | 品类+热点 | [品类] [潜在热词] | 碳酸饮料 搞抽象 | | 场景+趋势 | [消费场景] [流行词] | 聚餐 氛围感 | **输出：** 5-8个关键词列表 --- ### Step 3: 搜索小红书笔记 **对每个关键词调用API：** ```bash curl --request GET 'https://asset.tezign.com/chatdam/api/notes/search?keyword=[KEYWORD_URL_ENCODED]' \ --header "Authorization: Bearer ${CHATDAM_API_TOKEN}" \ --header 'Content-Type: application/json' ``` **响应结构：** ```json { "data": { "keyword": "雪碧 火锅", "notes": [ { "noteId": "69800480000000000e03c5b1", "title": "火锅配雪碧太爽了", "description": "辣到飞起的时候来一口冰爽雪碧 #火锅 #雪碧 #聚餐", "likedCount": 1205, "commentCount": 43, "collectedCount": 89, "sharedCount": 12 } ], "total": 20 } } ``` **数据处理：** 为每篇笔记计算互动分数： ``` engagement_score = likedCount + (commentCount × 2) + (collectedCount × 3) + (sharedCount × 1.5) ``` **从description中提取话题标签（#xxx格式）** --- ### Step 4: 获取热门笔记详情 **对每个关键词的前3篇高互动笔记，获取详情：** ```bash curl --request GET 'https://asset.tezign.com/chatdam/api/notes/detail?noteId=[NOTE_ID]' \ --header "Authorization: Bearer ${CHATDAM_API_TOKEN}" ``` **分析要点：** 1. **内容结构** - 开头钩子（如何吸引注意） - 主体内容（信息传递方式） - 结尾CTA（互动引导） 2. **话题策略** - 主话题（高流量） - 副话题（精准定位） - 品牌话题（转化追踪） 3. **成功要素** - 情绪触发点 - 用户价值点 - 可分享性 --- ### Step 5: 话题挖掘与评估 **汇总所有提取的话题标签，计算得分：** ``` 话题得分 = (出现频次 × 0.4) + (关联笔记平均互动 × 0.6) ``` **筛选Top 10话题，评估维度：** | 维度 | 权重 | 评分标准 | |------|------|----------| | 品牌相关性 | 30% | 与品牌价值观/场景的契合度 | | 用户互动量 | 25% | 关联笔记的平均互动表现 | | 内容可复制性 | 20% | 品牌执行的难易程度 | | 趋势热度 | 15% | 话题的增长势头 | | 竞品空白度 | 10% | 竞品是否已切入 | --- ### Step 6: 热榜验证 **调用官方热榜API验证话题热度：** ```bash curl --request GET 'https://asset.tezign.com/chatdam/api/hot-trends?limit=20' \ --header "Authorization: Bearer ${CHATDAM_API_TOKEN}" ``` **验证结果标记：** - ✅ **官方热榜验证** - 话题在Top 20热榜中 - 🌱 **新兴趋势** - 话题未上榜但数据强劲 - ⚠️ **小众话题** - 数据一般，需谨慎 --- ### Step 7: 深度话题分析（可选） **对高分话题，以话题为关键词再次搜索：** ```bash curl --request GET 'https://asset.tezign.com/chatdam/api/notes/search?keyword=%23搞抽象' \ --header "Authorization: Bearer ${CHATDAM_API_TOKEN}" ``` **分析：** - 话题下的内容主题分布 - 高互动内容的共性特征 - UGC创作模式 - 品牌切入角度 --- ### Step 8: 生成热点选题 HTML 报告 **基于前述分析结果，生成专业 HTML 报告，包含5-10个热点选题。** 报告整体结构如下，每个选题需包含完整信息： 1. **报告封面区域** - 品牌名称 + "小红书热点选题 Brief" - 数据基础概要（搜索关键词数、分析笔记数、提取话题数、热榜验证数） 2. **选题概览表** - 表格形式展示所有选题：序号、选题名称、热度等级、执行难度、推荐度 3. **每个选题详情卡片**，包含以下信息： - **选题标题** - **热点来源**：关联话题标签、热度验证状态（✅官方热榜 / 🌱新兴趋势）、数据支撑 - **创意概念**：1-2句话核心创意（<30字） - **创意阐释**：创意逻辑和品牌结合点（100-150字） - **内容形式**：形式（图文/视频/合集）、预估篇幅、参考风格 - **互动设计**：用户互动引导、评论区玩法 - **执行要点**：3个关键执行点 - **参考笔记**：Note ID、互动数据、成功要素 --- ## 设计风格 基于品牌属性，为报告选取合适的设计风格。以下为设计框架： ### 核心设计哲学 社媒热点选题报告面向品牌运营团队和决策者，视觉风格需兼顾**数据专业性**和**社交媒体活力感**——既有策略报告的严肃信服力，又有社媒内容的灵动气质。 **设计方向参考**： - 以杂志编辑式排版为底，融入数据看板的信息密度 - 参考 Monocle 杂志的优雅信息设计 + Spotify 年度报告的活力呈现 - 黑白灰为骨架，品牌色或亮色为点缀，不喧宾夺主 ### 设计规范 **色彩策略**： - 黑、白、灰为基础色系 - 可选单一强调色（如品牌色、亮橙、亮红、深蓝）作为点缀 - 严禁大面积彩色卡片、背景色块、粗彩色边框 - 热度等级可用色阶表示（如灰→深色→强调色），保持克制 **排版层级**： - 通过字重（Regular → Medium → Bold）建立层级，而非颜色 - 字号标识重要性，留白创造呼吸感 - 中文正文推荐使用系统默认字体，英文/数字可用 Inter / SF Pro 等 **信息密度**： - 紧凑但不拥挤，确保每屏有足够信息量 - 清晰的视觉分组和适度呼吸空间 - 表格、卡片、列表混合使用，提高扫读效率 ## 必须遵循的设计标准 ### 【核心设计哲学：Less is More】 用最有力的专业方式呈现最有价值的洞察。报告视觉语言应使用成熟专业的手法（编辑设计、信息图表美学），而非廉价的技术感装饰（霓虹渐变、3D效果、花哨特效）。 **关键原则**： - 真实而有戏剧性——避免合成塑料感，拥抱有力的视觉呈现 - 力量与深度兼备——视觉冲击力和经得起细看的内涵 - 专业但不疏远——咨询级严谨 + 社媒运营的亲切 - 色彩是戏剧，不是装饰——有目的的戏剧性对比，而非无意义的彩色点缀 **色彩策略**： - 黑白灰为基底，可选单一强调色（深蓝、炭灰、暖棕、亮橙均可） - 严禁大面积彩色卡片、背景色块、粗彩色边框 - 克制在于布局和结构，而非把所有东西变灰 **排版层级**： - 通过字重（Regular → Medium → Bold）建立层级，而非颜色 - 字号表示重要性，留白创造呼吸空间 - 最好的排版应当不被察觉——直到你需要阅读时，感觉毫不费力 **信息密度与阅读效率**： - 布局紧凑，保证每屏信息量充足——避免过多留白导致"一眼看不到东西" - 紧凑≠拥挤——保持清晰的视觉分组和适度呼吸空间 - 目标是高阅读效率：读者可快速扫描抓住要点，深入阅读时也感觉舒适 - 段落间距和标题间距适中——层次分明又节省空间 ### 【专业标准】 - 报告需体现咨询级专业水准 - 使用社媒运营和品牌策略的标准框架和术语 - 保持客观严谨的分析态度 - 数据引用需标注来源（API数据 / 网络搜索） ### 【内容生成原则】 - 基于真实API数据进行分析和推荐 - 数据不足时使用行业标准假设和经验判断 - 保持逻辑连贯和分析深度 - 所有推论必须有清晰的逻辑支撑和数据佐证 ### 【热点选题报告特有设计要求】 - 建立清晰的信息层级：通过字重、字号、衬线/无衬线字体组合区分内容重要性 - 精心安排布局结构：较高信息密度，减少不必要的留白，用精确的分组和对齐突出重点内容 - 表格展示数据对比分析，通过加粗、边框等强调方式突出关键数字和重要发现 - 选题卡片设计统一，便于快速浏览和对比 - 禁止使用超过4种颜色、彩色卡片块、装饰性边框，保持简洁克制的专业美感 ### 【视觉内容限制】 - **严禁**：使用图片生成API创建任何图表、表格、数据可视化、统计图、流程图 - **严禁**：使用外部图片链接 - 所有数据可视化通过 HTML/CSS 原生实现（表格、进度条、色阶等） - 不使用复杂的CSS图表或可视化 - 报告开头不包含日期信息 ### 【技术实现】 - 使用 Tailwind CSS（通过 CDN）进行响应式布局 - 优化不同屏幕尺寸的布局 - 所有样式和内容包含在单个 HTML 文件中 - 不使用外部图片链接或资源 - 避免生成无效链接和URL - 不使用复杂的CSS图表或可视化 - 输出内容仅为可直接使用的 HTML 代码，以 `<!DOCTYPE html>` 开头 --- ## API参考 ### 1. 笔记搜索 ``` GET https://asset.tezign.com/chatdam/api/notes/search?keyword=[ENCODED_KEYWORD] Header: Authorization: Bearer ${CHATDAM_API_TOKEN} 返回: 20篇笔记，含标题、描述、互动数据 ``` ### 2. 笔记详情 ``` GET https://asset.tezign.com/chatdam/api/notes/detail?noteId=[NOTE_ID] Header: Authorization: Bearer ${CHATDAM_API_TOKEN} 返回: 完整笔记内容、话题标签、详细数据 ``` ### 3. 热榜数据 ``` GET https://asset.tezign.com/chatdam/api/hot-trends?limit=20 Header: Authorization: Bearer ${CHATDAM_API_TOKEN} 返回: 官方热榜Top20，含热度值和排名变化 ``` --- ## 最佳实践 ### ✅ DO - 生成多样化关键词，覆盖不同场景 - 分析至少100篇笔记建立数据基础 - 用真实互动数据支撑选题判断 - 提取可复制的内容模板 - 验证热榜确认趋势真实性 - 每个选题提供具体执行指导 ### ❌ DON'T - 不要捏造互动数据 - 不要只依赖热榜（可能与品牌无关） - 不要提供无法执行的创意 - 不要忽略品牌调性限制 - 不要照搬竞品已做过的内容 --- ## 输出格式 ### Step 1: 生成 HTML 报告 创建 HTML 报告文件，保存到指定路径： - 单个 HTML 文件: `{base_dir}/{品牌名}-hot-topics/report.html` **HTML 报告内容包括：** 1. **报告封面** — 品牌名、报告标题、数据基础概要 2. **选题概览表** — 选题名称、热度等级、执行难度、推荐度 3. **选题详情卡片** — 每个选题的完整 brief（热点来源、创意概念、创意阐释、内容形式、互动设计、执行要点、参考笔记） 4. **数据来源说明** — 搜索关键词、分析笔记数量、数据采集方式 **技术要求：** - 以 `<!DOCTYPE html>` 开头的完整 HTML 文件 - 使用 Tailwind CSS CDN 进行样式控制 - 单文件，无外部依赖 - 响应式设计，适配不同屏幕 ### Step 2: 转换为 PDF 使用转换脚本生成最终 PDF： ```bash uv run {baseDir}/scripts/html_to_pdf.py --html {base_dir}/{品牌名}-hot-topics/report.html --output {base_dir}/{品牌名}-hot-topics/report.pdf ``` 脚本会： - 正确处理相对图片路径 - 生成专业 PDF - 打印 `MEDIA:` 行用于自动附件 --- ## 错误处理 **API调用失败：** - 重试1次 - 若仍失败，使用web_search作为备选数据源 - 标注数据来源为"网络搜索（非API）" **笔记数量不足：** - 扩展关键词范围 - 降低品牌强关联要求 - 提示用户"该品牌小红书声量较低，建议扩大搜索范围" **热榜API不可用：** - 继续基于笔记数据分析 - 标注"热度未经官方验证" --- ## 示例 HTML 结构参考 以下为报告 HTML 的骨架结构示意（实际生成时需填充真实数据和完整样式）： ```html <!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>[品牌名] 小红书热点选题 Brief</title> <script src="https://cdn.tailwindcss.com"></script> <style> /* 自定义字体和基础样式 */ body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif; background: #fafafa; color: #1a1a1a; } /* 打印优化 */ @media print { body { background: white; } .page-break { page-break-before: always; } } </style> </head> <body class="min-h-screen"> <!-- 封面区域 --> <header class="bg-white border-b border-gray-200 px-8 py-12 mb-8"> <p class="text-sm tracking-widest text-gray-400 uppercase mb-4">Xiaohongshu Content Strategy</p> <h1 class="text-4xl font-bold text-gray-900 mb-2">[品牌名]</h1> <h2 class="text-xl font-light text-gray-500 mb-8">小红书热点选题 Brief</h2> <div class="grid grid-cols-4 gap-6 mt-8"> <div class="border-l-2 border-gray-900 pl-4"> <p class="text-2xl font-bold">6</p> <p class="text-xs text-gray-500 mt-1">搜索关键词</p> </div> <div class="border-l-2 border-gray-900 pl-4"> <p class="text-2xl font-bold">120</p> <p class="text-xs text-gray-500 mt-1">分析笔记</p> </div> <div class="border-l-2 border-gray-900 pl-4"> <p class="text-2xl font-bold">85</p> <p class="text-xs text-gray-500 mt-1">提取话题</p> </div> <div class="border-l-2 border-gray-900 pl-4"> <p class="text-2xl font-bold">3</p> <p class="text-xs text-gray-500 mt-1">热榜验证</p> </div> </div> </header> <!-- 选题概览表 --> <section class="bg-white mx-8 mb-8 p-6 border border-gray-100"> <h3 class="text-lg font-bold text-gray-900 mb-4">选题概览</h3> <table class="w-full text-sm"> <thead> <tr class="border-b-2 border-gray-900"> <th class="text-left py-2 font-medium">#</th> <th class="text-left py-2 font-medium">选题</th> <th class="text-left py-2 font-medium">热度</th> <th class="text-left py-2 font-medium">执行难度</th> <th class="text-left py-2 font-medium">推荐度</th> </tr> </thead> <tbody> <!-- 由实际数据填充 --> <tr class="border-b border-gray-100"> <td class="py-3 font-bold">1</td> <td class="py-3">选题标题示例</td> <td class="py-3">⭐⭐⭐⭐⭐</td> <td class="py-3">中</td> <td class="py-3">★★★★★</td> </tr> </tbody> </table> </section> <!-- 选题详情卡片（重复N个） --> <section class="mx-8 mb-8"> <article class="bg-white border border-gray-100 p-6 mb-6"> <div class="flex items-center justify-between mb-4"> <h3 class="text-xl font-bold text-gray-900">选题 1: 选题标题</h3> <span class="text-xs px-3 py-1 bg-gray-900 text-white">✅ 官方热榜</span> </div> <div class="grid grid-cols-3 gap-4 mb-4 text-sm"> <div> <p class="text-gray-400 text-xs mb-1">关联话题</p> <p>#话题1 #话题2 #话题3</p> </div> <div> <p class="text-gray-400 text-xs mb-1">数据支撑</p> <p>XX篇相关笔记，平均互动XX</p> </div> <div> <p class="text-gray-400 text-xs mb-1">内容形式</p> <p>图文 / 6张图</p> </div> </div> <div class="mb-4"> <p class="text-gray-400 text-xs mb-1">创意概念</p> <p class="text-lg font-medium">一句话核心创意描述</p> </div> <div class="mb-4"> <p class="text-gray-400 text-xs mb-1">创意阐释</p> <p class="text-sm text-gray-700 leading-relaxed">详细说明创意逻辑和品牌结合点...</p> </div> <div class="mb-4"> <p class="text-gray-400 text-xs mb-1">互动设计</p> <p class="text-sm text-gray-700">如何引导用户互动，评论区玩法...</p> </div> <div class="mb-4"> <p class="text-gray-400 text-xs mb-1">执行要点</p> <ol class="text-sm text-gray-700 list-decimal list-inside space-y-1"> <li>关键执行点1</li> <li>关键执行点2</li> <li>关键执行点3</li> </ol> </div> <div class="border-t border-gray-100 pt-3 text-xs text-gray-400"> 参考笔记: Note ID xxx | 互动: xxx | 成功要素: xxx </div> </article> </section> <!-- 数据来源说明 --> <footer class="mx-8 mb-12 py-4 border-t border-gray-200 text-xs text-gray-400"> <p>数据来源：小红书笔记搜索API / 官方热榜API | 搜索关键词：xxx, xxx | 分析笔记数：xxx篇</p> </footer> </body> </html> ``` 以上仅为骨架参考，实际生成时需要： - 根据品牌调性微调强调色 - 填充真实分析数据 - 根据选题数量重复卡片组件 - 确保所有数据引用来自真实API响应


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (MEDIUM)