解析说明 :

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. 搜索无结果 :

   • 记录："没有找到关于 {keyword} 的搜索结果"
   • 将研究标记为"可用数据有限"
   • 使用关键词本身和一般市场知识继续分析
   • 在仪表板中注明："⚠️ 背景研究受限"

2. 搜索超时或失败 :

   • 使用简化的查询（仅关键词，无附加词）重试一次
   • 如果重试失败，标记为"搜索不可用"
   • 使用可用数据继续分析
   • 在产品分析中注明限制

3. 搜索结果不相关 :

   • 如果结果与热搜话题背景不匹配：
   • 尝试使用不同关键词的替代搜索查询
   • 使用一般行业知识进行分析
   • 记录："基于一般市场分析"

4. 部分搜索成功（2 次中有 1 次成功） :

   • 使用可用的搜索数据继续
   • 注明缺少哪个方面（背景 vs 用户洞察）
   • 对缺失的信息进行保守估计
   • 在仪表板中标记："⚠️ 部分数据"

3. AI 驱动的产品构思与评分

对于每个热搜话题，使用以下评分框架进行分析并生成创意产品构思：

评分系统（总计：100 分）

1. 产品发展潜力 : 40 分

   • 市场规模和可扩展性 (15 分)
   • 技术可行性 (10 分)
   • 趋势持久性 vs 短暂流行 (10 分)
   • 竞争格局 (5 分)

2. 有趣度 : 20 分

   • 创意独特性 (10 分)
   • 情感吸引力 (5 分)
   • 可分享性/病毒式传播潜力 (5 分)

3. 生活实用度 : 20 分

   • 日常生活融入度 (10 分)
   • 问题解决能力 (5 分)
   • 目标受众规模 (5 分)

4. 小规模生产容易程度 : 20 分

   • 制造复杂性 (10 分)
   • 材料可获得性 (5 分)
   • 小批量成本效益 (5 分)

产品概念要求 :

对于每个趋势，生成 1-3 个创意产品概念，包括：

• 市场赛道 : 属于哪个产品类别（例如：家居装饰、时尚配饰、文具、科技小工具、生活方式产品、玩具等）
• 产品名称 : 吸引人、易记的名称
• 销售对象人群 : 具体的人群特征（年龄、兴趣、收入水平、生活方式）
• 工厂批量生产特点 :
  • 生产方法（例如：3D 打印、注塑成型、丝网印刷、激光切割）
  • 材料要求
  • 最小起订量可行性
  • 交货时间估计
  • 成本结构（不同产量下的单位成本）
• 详细描述 : 产品如何与热搜话题相关联
• 总分 : 所有四个评分维度的总和
• 评分分析 : 每个评分组成部分的简要理由

评分指南 :

• 客观且现实
• 考虑中国市场背景
• 考虑当前制造能力
• 考虑趋势周期时机

4. 生成交互式 HTML 仪表板

创建一个全面、视觉吸引人的 HTML 仪表板，结构如下：

仪表板组件 :

A. 头部区域

- 标题: "微博热搜创意产品分析报告 - Weibo Trends Product Analysis"
- 生成时间戳
- 分析的趋势总数
- 摘要统计（平均分、热门类别等）

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. 仪表板样式要求

/* 配色方案 */
- 优秀产品 (≥80): 金色/琥珀色主题 (#FFD700, #FFA500)
- 良好产品 (60-79): 蓝色/青色主题 (#4A90E2, #50C8E8)
- 其他产品 (<60): 灰色/中性主题 (#95A5A6, #BDC3C7)

/* 设计指南 */
- 响应式布局（网格或弹性盒子）
- 简洁、现代的美学
- 清晰的视觉层次
- 易于阅读的排版（支持中英文）
- 交互式悬停效果
- 可排序/可筛选选项
- 用于分数可视化的进度条
- 用于快速识别的徽章系统

E. 交互功能

包含 JavaScript 以实现：

• 按分数排序（从高到低，从低到高）
• 按分数等级筛选（优秀/良好/其他）
• 按市场类别筛选
• 关键词搜索功能
• 可展开/折叠的详细部分
• 导出为 PDF 选项（额外功能）

F. 页脚区域

- 关于趋势波动性的免责声明
- 建议进行进一步市场研究
- 生成元数据（API 来源、分析时间戳）
- 技能版本信息

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. 从默认 API (https://apis.tianapi.com/weibohot/index?key=...) 获取趋势数据
   - 如果 API 失败，提供使用模拟数据的选项
2. 解析 result.list 数组并提取前 10-15 个热搜话题
3. 对于每个话题：
   - 执行 2 次聚焦的网络搜索以进行背景研究
   - 优雅地处理搜索失败，采用备用策略
   - 分析市场潜力和用户需求
   - 生成创意产品概念
   - 计算详细分数
4. 验证所有生成的数据
5. 将所有数据编译成结构化格式
6. 生成交互式 HTML 仪表板，如有需要则包含错误指示器
7. 保存输出文件

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

限制与注意事项

API 依赖 :

• 需要用户提供有效的微博 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
  • 更新了真实 API 格式的数据解析
• v1.0 (2026-01-11): 初始技能创建
  • 核心工作流程：API 获取 → 研究 → 评分 → 仪表板
  • 100 分评分系统
  • 具有基于等级高亮的交互式 HTML 仪表板

参考资料与资源

微博趋势数据 :

• 官方微博热搜榜: https://s.weibo.com/top/summary
• 其他 API 可能提供不同的数据结构

产品开发资源 :

• 阿里巴巴 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

每周安装数

51

仓库

yitongcodes/wei…yzer_web

首次出现

Feb 12, 2026

安全审计

Gen Agent Trust HubFailSocketPassSnykFail

安装于

gemini-cli51

github-copilot51

amp51

codex51

kimi-cli51

opencode51