mcpField
W
weibo-trends-analyzer

weibo-trends-analyzer

github.com/yitongcodes营销与增长0103 次安装38 周前更新
代码仓库

关于 weibo-trends-analyzer

Weibo Trends Analyzer 是一项将微博热搜转化为产品创意并生成评分分析看板的技能,适用于产品构思和市场探索。它结合热搜数据、针对性网络调研、评分框架与交互式 HTML 输出。

主要功能

  1. 01获取并解析微博热搜数据
  2. 02研究各热搜的背景与用户需求
  3. 03生成并评估产品创意
  4. 04创建交互式 HTML 分析看板
  5. 05将热搜数据导出为 JSON

适用场景

  1. 01从当前微博热搜探索产品创意
  2. 02按发展潜力和实用性评分比较创意
  3. 03在看板中查看热搜调研与产品分析
  4. 04保存分析数据以便后续处理

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/yitongcodes/weibo_trends_analyzer_web --skill weibo-trends-analyzer

安装后在 Claude Code 中输入/weibo-trends-analyzer确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

API_CONFIG.md
CHANGELOG.md
dashboard-template-example.html
QUICKSTART.md
README.md
weibo-mock-data.json

详细介绍

微博热搜分析器——微博热搜创意产品分析

概述

此技能可帮助你从微博热搜话题中发现创意产品机会。它会获取实时热搜数据、调研全面的背景信息、评估产品开发潜力,并通过交互式仪表板展示结果。

关键词:微博、微博、热门话题、热搜、热搜、产品创意、创意产品、市场分析、社交媒体趋势、中国市场

工作流

1. 获取微博热搜话题

默认 API:https://apis.tianapi.com/weibohot/index?key=4dfdf794141101d7bb8ece0294dbbc02

当用户请求分析微博热搜时,获取当前热搜列表:

curl -s "https://apis.tianapi.com/weibohot/index?key=4dfdf794141101d7bb8ece0294dbbc02"

API 响应处理:

API 返回的数据格式如下:

{
  "code": 200,
  "msg": "success",
  "result": {
    "list": [
      {
        "hotword": "trending keyword",
        "hotwordnum": "1234567",
        "hottag": "新/热/荐"
      }
    ]
  }
}

字段映射:

  • hotword → 热搜关键词
  • hotwordnum → 热度值,可能包含类别前缀,例如“综艺 587870”
  • hottag → 标签:“新”(新)、“热”(热)、“荐”(推荐)或空
  • 排名位置 → 根据数组索引推断(从 1 开始)

解析说明:

  1. 检查 code == 200 以确认成功
  2. 提取 result.list 数组
  3. 对列表中的每个条目:
    • 排名 = 数组索引 + 1
    • 关键词 = hotword
    • 热度值 = 从 hotwordnum 中提取数值(如有类别前缀则移除)
    • 标签 = hottag
    • 类别 = 如果 hotwordnum 有前缀,则从中提取(例如“综艺”“剧集”“盛典”“演出”)
  4. 将分析范围限制在前 10–15 个条目,以控制处理时间

错误处理:

如果 API 获取失败,请按以下备用策略处理:

  1. API 返回错误代码(code ≠ 200):

    • 记录 API 响应中的错误消息
    • 告知用户:“API 返回错误:{msg}。你想改用模拟数据吗?”
    • 建议检查 API 密钥或配额限制
    • 如果用户同意,使用 .claude/skills/weibo-trends-analyzer/weibo-mock-data.json
  2. 网络/连接失败:

    • 告知用户:“无法连接到 API。可能是网络问题。”
    • 提议使用模拟数据:.claude/skills/weibo-trends-analyzer/weibo-mock-data.json
    • 建议检查互联网连接
  3. 无效的 JSON 响应:

    • 记录收到的响应
    • 告知用户:“API 返回的数据格式无效”
    • 建议检查 API 端点是否已更改
    • 如果有模拟数据,则回退使用
  4. 数据为空或格式错误:

    • 如果 result.list 为空或缺失
    • 告知用户:“API 响应中未找到热门话题”
    • 使用模拟数据作为备用
2. 深入研究每个热门话题

对于每个热门话题,执行 2 次有针对性的网络搜索,以收集必要的背景信息:

搜索策略(每个话题搜索 2 次):

搜索 1:背景与概况 在一次搜索中结合社交媒体讨论和新闻背景:

  • 搜索查询示例:
    • "{keyword} 微博 新闻背景"
    • "{keyword} 热搜原因 讨论"
    • "{keyword} latest news 用户看法"

目标:了解热门话题的内容以及它走红的原因

搜索 2:用户洞察与市场潜力 聚焦消费者视角和产品机会:

  • 搜索查询示例:
    • "{keyword} 用户需求 产品"
    • "{keyword} 消费者痛点"
    • "{keyword} 产品创意 市场"

目标:识别用户需求、痛点和产品开发机会

要提取的信息: 从 2 次搜索中收集:

  • ✅ 社交媒体情绪和讨论量(社交媒体讨论)
  • ✅ 新闻背景和事件背景(新闻背景)
  • ✅ 目标人群和受众规模(目标人群)
  • ✅ 用户痛点和未满足的需求(用户痛点)
  • ✅ 现有产品或市场空白(市场机会)
  • ✅ 文化/社会意义(文化意义)

网络搜索错误处理:

  1. 搜索无结果:

    • 记录:"No search results for: {keyword}"
    • 将研究标记为"数据有限"
    • 使用关键词本身和一般市场知识继续分析
    • 在仪表板中注明:"⚠️ 背景研究受限"
  2. 搜索超时或失败:

    • 使用简化后的查询重试一次(仅使用关键词,不添加其他词)
    • 如果重试失败,将其标记为"搜索不可用"
    • 使用现有数据继续分析
    • 在产品分析中注明限制
  3. 搜索结果不相关:

    • 如果结果与热门话题背景不符:
    • 使用不同关键词尝试其他搜索查询
    • 使用一般行业知识进行分析
    • 记录:"基于一般市场分析"
  4. 搜索部分成功(2 次中有 1 次成功):

    • 使用现有搜索数据继续分析
    • 注明缺失的方面(背景或用户洞察)
    • 对缺失信息做出保守估计
    • 在仪表板中标记:"⚠️ 部分数据"
3. AI 驱动的产品创意构思与评分

针对每个热门话题,使用以下评分框架进行分析并生成创意产品点子:

评分体系(总分:100 分)

  1. 产品发展潜力(可发展度):40 分

    • 市场规模与可扩展性(15 分)
    • 技术可行性(10 分)
    • 趋势持久性与昙花一现的风潮(10 分)
    • 竞争格局(5 分)
  2. 趣味程度(有趣度):20 分

    • 创意独特性(10 分)
    • 情感吸引力(5 分)
    • 易于分享/走红的潜力(5 分)
  3. 实际生活效用(生活有用度):20 分

    • 融入日常生活的程度(10 分)
    • 解决问题的能力(5 分)
    • 目标受众规模(5 分)
  4. 小规模生产便利性(小规模生产容易程度):20 分

    • 制造复杂度(10 分)
    • 材料的易获取程度(5 分)
    • 小批量生产的成本效益(5 分)

产品概念要求:

针对每个趋势,生成 1-3 个创意产品概念,包括:

  • 市场类别(市场赛道):产品所属类别(例如家居装饰、时尚配饰、文具、科技小工具、生活用品、玩具等)
  • 产品名称(产品名称):醒目、易记的名称
  • 目标受众(销售对象人群):具体的人群画像(年龄、兴趣、收入水平、生活方式)
  • 制造特点(工厂批量生产特点):
    • 生产方式(例如 3D 打印、注塑、丝网印刷、激光切割)
    • 材料要求
    • 最小起订量(MOQ)的可行性
    • 预计交货周期
    • 成本结构(不同产量下的单件成本)
  • 详细描述(详细描述):说明产品与热门话题的关联
  • 总分(总分):四个评分维度的总和
  • 评分细则(评分分析):简要说明各评分项的依据

评分指南:

  • 客观、务实
  • 考虑中国市场背景
  • 将当前制造能力纳入考量
  • 考虑趋势周期的时机
4. 生成交互式 HTML 仪表板

创建一份内容全面、视觉效果出色的 HTML 仪表板,结构如下:

仪表板组件:

A. 页眉部分

- Title: "微博热搜创意产品分析报告 - Weibo Trends Product Analysis"
- Generation timestamp
- Total trends analyzed count
- Summary statistics (average score, top categories, etc.)

B. 重点展示部分——表现最佳的产品 按评分档位展示产品:

  • 🏆 优秀(优秀)——评分 ≥ 80:

    • 使用金色/高端风格突出展示
    • 使用加大尺寸的卡片,附详细评分细则
    • 推荐操作:“优先开发推荐”
  • ⭐ 良好(良好)——评分 60-79:

    • 使用标准卡片布局并以醒目边框突出显示
    • 推荐操作:“可考虑开发”
  • 📋 其他产品——评分 < 60:

    • 使用紧凑列表视图
    • 推荐操作:“观望或需优化”

C. 产品卡片

每张产品卡片都应显示:

<div class="product-card score-tier-{excellent/good/other}">
  <div class="trend-info">
    <h3>{Trending Keyword}</h3>
    <span class="rank">热搜排名: #{rank}</span>
    <span class="heat">热度: {heat_value}</span>
  </div>

  <div class="product-concept">
    <h4>{Product Name}</h4>
    <div class="total-score">{Total Score}/100</div>
    <div class="score-badge">{优秀/良好/其他}</div>

    <div class="details">
      <p><strong>市场赛道:</strong> {market_category}</p>
      <p><strong>目标人群:</strong> {target_audience}</p>
      <p><strong>产品描述:</strong> {description}</p>
      <p><strong>生产特点:</strong> {manufacturing_details}</p>
    </div>

    <div class="score-breakdown">
      <h5>评分详情</h5>
      <div class="score-bar">
        <span>可发展度</span>
        <progress value="{score}" max="40"></progress>
        <span>{score}/40</span>
      </div>
      <div class="score-bar">
        <span>有趣度</span>
        <progress value="{score}" max="20"></progress>
        <span>{score}/20</span>
      </div>
      <div class="score-bar">
        <span>生活有用度</span>
        <progress value="{score}" max="20"></progress>
        <span>{score}/20</span>
      </div>
      <div class="score-bar">
        <span>生产容易度</span>
        <progress value="{score}" max="20"></progress>
        <span>{score}/20</span>
      </div>
    </div>

    <div class="analysis">
      <h5>分数分析</h5>
      <p>{score_justification}</p>
    </div>
  </div>

  <div class="research-summary">
    <h5>背景研究</h5>
    <ul>
      <li><strong>社交媒体:</strong> {social_media_insights}</li>
      <li><strong>新闻背景:</strong> {news_background}</li>
      <li><strong>用户洞察:</strong> {user_insights}</li>
    </ul>
  </div>
</div>

D. 仪表板样式要求

/* Color Scheme */
- Excellent products (≥80): Gold/amber theme (#FFD700, #FFA500)
- Good products (60-79): Blue/cyan theme (#4A90E2, #50C8E8)
- Other products (<60): Gray/neutral theme (#95A5A6, #BDC3C7)

/* Design Guidelines */
- Responsive layout (grid or flexbox)
- Clean, modern aesthetics
- Clear visual hierarchy
- Easy-to-read typography (Chinese + English support)
- Interactive hover effects
- Sortable/filterable options
- Progress bars for score visualization
- Badge system for quick identification

E. 交互功能

加入 JavaScript,实现以下功能:

  • 按评分排序(从高到低、从低到高)
  • 按评分档位筛选(优秀/良好/其他)
  • 按市场类别筛选
  • 关键词搜索功能
  • 展开/折叠详细内容
  • 导出为 PDF(可选加分项)

F. 页脚部分

- Disclaimer about trend volatility
- Recommendation to conduct further market research
- Generation metadata (API source, analysis timestamp)
- Skill version information
5. 文件输出

生成以下文件:

  1. weibo-trends-analysis-{YYYY-MM-DD}.html:完整的交互式仪表板
  2. weibo-trends-data-{YYYY-MM-DD}.json:供进一步处理的原始结构化数据(可选)

文件生成错误处理:

  1. 文件写入权限被拒绝:

    • 尝试使用带时间戳的备用文件名:weibo-trends-analysis-{YYYY-MM-DD-HHmmss}.html
    • 如果仍然失败,告知用户:“无法写入文件。请检查目录权限。”
    • 建议用户提供输出路径
  2. HTML 生成错误:

    • 如果模板渲染失败,则创建包含基本表格布局的简化版 HTML
    • 至少确保包含产品名称、评分和基本描述
    • 记录错误详情以便排查问题
  3. 输出前的数据验证:

    • 验证至少生成了 1 个产品概念
    • 检查所有评分是否在有效范围内(0-40、0-20 等)
    • 确保包含必填字段(产品名称、评分、描述)
    • 如果验证失败,告知用户哪些主题存在问题
  4. 大型文件处理:

    • 如果分析的主题超过 20 个,提醒用户文件可能较大
    • 考虑生成分页 HTML,或采用摘要 + 详细内容的结构
    • 确保大型数据集与浏览器兼容

最佳实践

研究质量:

  • 对每个热门话题进行 2 次有针对性的网页搜索(以提高效率)
  • 综合每次搜索中的多个来源的信息
  • 核实事实准确性
  • 注明信息的新鲜度
  • 搜索结果重质量而非数量

产品构思:

  • 不要局限于显而易见的关联
  • 考虑文化背景和中国消费者行为
  • 评估短期趋势利用与长期产品可行性
  • 保持创意,同时切合实际

评分客观性:

  • 对所有产品采用一致的标准
  • 使用具体证据说明评分理由
  • 避免偏向某些产品类别
  • 考虑中国的制造实际情况

仪表板质量:

  • 确保所有中文字符均能正确显示(UTF-8 编码)
  • 在不同屏幕尺寸上测试响应式布局
  • 验证 HTML/CSS/JS 语法
  • 为中文文本设置备用字体
  • 确保数据可视化清晰直观

示例使用流程

User: "分析微博热搜"
或
User: "分析今日微博热搜并生成产品创意"

Claude:
1. Fetches trending data from default API (https://apis.tianapi.com/weibohot/index?key=...)
   - If API fails, offers to use mock data
2. Parses the result.list array and extracts top 10-15 trending topics
3. For each topic:
   - Performs 2 focused web searches for background research
   - Handles search failures gracefully with fallback strategies
   - Analyzes market potential and user needs
   - Generates creative product concepts
   - Calculates detailed scores
4. Validates all generated data
5. Compiles all data into structured format
6. Generates interactive HTML dashboard with error indicators if needed
7. Saves output files

Output:
- weibo-trends-analysis-2026-01-11.html
- weibo-trends-data-2026-01-11.json (optional)

限制与注意事项

API 依赖:

  • 需要用户提供有效的 Weibo API 端点
  • API 速率限制可能影响可分析的热门话题数量
  • API 响应格式可能有所不同,需根据需要调整解析方式

网页搜索限制:

  • 搜索结果质量取决于关键词的具体程度
  • 中文内容可能需要采用特定的搜索策略
  • 信息时效性对趋势分析至关重要

评分的主观性:

  • 尽管采用了结构化框架,部分评分仍需依赖判断
  • 市场状况变化迅速
  • 制造可行性需要由具备领域专业知识的人员进行验证

仪表板限制:

  • 静态 HTML 文件(不是实时 Web 应用)
  • 使用现代浏览器可获得最佳体验
  • 大型数据集(>50 个产品)可能影响页面性能

技术要求

可用工具:

  • Bash:用于使用 curl 发起 API 调用
  • WebSearch:用于研究热门话题(必需)
  • Write:用于生成 HTML 和 JSON 输出文件

依赖项:

  • 基本功能无需外部库
  • 使用仪表板需要现代 Web 浏览器
  • 调用 API 和进行网页搜索需要互联网连接

质量检查清单

完成输出前,请确认:

  • 已研究所有热门话题(每个话题进行 2 次针对性搜索)
  • 已妥善处理搜索失败,并采用适当的备用方案
  • 每个产品概念都包含所有必填字段
  • 分数计算正确,且总和与总分一致
  • 已清楚标明数据限制(适用时使用 ⚠️ 标记)
  • HTML 可正确呈现,且采用正确的 UTF-8 编码
  • 中文字符显示正常
  • 交互功能(排序、筛选、搜索)正常运行
  • 样式能够清楚区分不同分数档位
  • 所有链接和引用均有效
  • 仪表板可适配不同尺寸的屏幕
  • 已验证数据准确性

高级功能(可选)

如果时间和上下文允许,请考虑添加:

趋势跟踪:

  • 与之前的分析进行比较,以识别上升或下降趋势
  • 跟踪关键词排名随时间的变化
  • 识别反复出现的主题或模式

竞品分析:

  • 检查淘宝/天猫/京东上是否已有类似产品
  • 分析定价策略
  • 识别市场空缺

视觉增强:

  • 用于展示分数分布的图表
  • 趋势热力图
  • 类别细分(饼图)
  • 时间线可视化

导出选项:

  • 导出 CSV,便于使用电子表格分析
  • 生成 PDF,用于演示
  • 适用于与其他系统集成的 API 就绪 JSON

版本历史

  • v1.2 (2026-01-17):错误处理与性能优化
    • 为 API、网页搜索和文件生成提供全面的错误处理
    • 将每个话题的网页搜索次数从 3-5 次优化为 2 次针对性搜索
    • 通过妥善处理备用方案提升可靠性
    • 处理时间缩短 33-40%
  • v1.1 (2026-01-11):与 TianAPI 集成
    • 内置微博热搜 API
    • 更新数据解析,以适配真实 API 格式
  • v1.0 (2026-01-11):首次创建技能
    • 核心工作流:API 获取 → 研究 → 评分 → 仪表板
    • 100 分制评分系统
    • 根据档位突出显示内容的交互式 HTML 仪表板

参考资料与资源

微博热搜数据:

产品开发资源:

  • 阿里巴巴 1688:用于研究制造合作伙伴
  • 淘宝/天猫:用于市场调研和竞品分析
  • 拼多多:用于了解热门产品类别

设计灵感:

  • Product Hunt:用于创意产品命名和定位
  • 小红书 (小红书):用于了解生活方式产品趋势
  • 抖音 (抖音):用于探索爆款产品概念

支持与故障排除

常见问题:

  1. API 返回空数据:

    • 确认 API 端点正确且可访问
    • 如有需要,请检查 API 身份验证
    • 尝试其他微博热搜 API 来源
  2. 网页搜索未找到相关信息:

    • 调整搜索词,使其更加具体
    • 尝试不同的关键词组合(中文 + 英文)
    • 使用指定网站的搜索(site:weibo.com、site:baidu.com)
  3. HTML 仪表板显示不正确:

    • 确保文件使用 UTF-8 编码
    • 检查浏览器控制台中的 JavaScript 错误
    • 确认所有 HTML 标签均已正确闭合
  4. 分数似乎不一致:

    • 查看第 3 节中的评分指南
    • 确保所有标准均经过客观评估
    • 记录临界分数的评分理由

获取帮助:

  • 查阅 Claude Code 官方技能文档
  • 查看具有类似模式的示例技能
  • 生成 HTML 前验证 JSON 数据结构

许可证:MIT License——可免费使用和修改 作者:Claude Code Skills Framework 最后更新:2026-01-17 版本:1.2

评论

支持 Markdown