cn-last30days

Last 30 Days—CN版

📝 简介

Last 30 Days—CN版 是中国社交媒体话题研究工具，从小红书、抖音、公众号三大平台搜索近30天真实讨论数据，通过跨平台对比分析舆情趋势。支持通用话题研究和实体对比两种模式，输出结构化研究报告和可视化 HTML。

✨ 功能特性

功能模块	能力描述	核心价值
三平台数据源	小红书/公众号统一接口 + 抖音广域库接口数据	多维度舆情视角
关键词研究	支持多词组合查询（英文逗号分隔）	灵活话题覆盖
跨平台对比	自动综合三平台数据生成洞察	发现差异化趋势
对比	A vs B 结构化对比分析	辅助决策判断
HTML 报告	交互式可视化报告生成	便于分享传播
历史回溯	支持近30天任意日期数据	追踪趋势演变

🔑 鉴权

脚本需配置 API Key 使用。从 红狐数据 获取个人 Key 并配置环境变量：

export REDFOX_API_KEY=ak_你的密钥

优先级：命令行 --api-key > REDFOX_API_KEY / X_API_KEY 环境变量 > 配置文件。

---

核心参数

参数	说明	默认值
keyword	搜索关键词（必填，多词用英文逗号分隔）	-
--platforms	平台列表（不建议缩减）	xhs,dy,gzh
--count	每平台条数	50
--days	时间范围，看近期趋势可设7	30
--output-format	json / html / both	json
--output-dir	输出目录	~/Documents/CnLast30Days

平台信号解读：

平台	内容特征	关键指标
小红书 (xhs)	种草体验、教程攻略、用户反馈	收藏/点赞比高=种草信号
抖音 (dy)	热点追评、知识碎片、情绪传播	分享数=传播力
公众号 (gzh)	行业深度分析、观点输出、数据报告	阅读量=关注度，分享=认同

---

工作流程

1. 环境检查

运行前需确保已配置 API Key（环境变量 REDFOX_API_KEY 或 --api-key 参数）。如未配置，提示用户：

请配置 API Key：export REDFOX_API_KEY=ak_你的密钥，注册地址 https://www.redfox.hk/login

2. 关键词质量检查

运行引擎前检查话题是否过于模糊（如"工具"、"方法"），若是则请用户具体化。

3. 预研究

调用引擎前，并行运行 2-3 个 WebSearch 提取热词和背景：

• 小红书 {TOPIC} 热门讨论 → 提取小红书热词
• 抖音 {TOPIC} 热门话题 → 提取抖音标签
• {TOPIC} 最新动态 → 补充时效背景

4. 查询计划

根据预研究决定查询策略：

• 优先将相关关键词合并为一次调用（如 "产品经理,AI产品经理"）
• 每平台最多5个词，只在话题维度差异极大时才分开调用
• 默认只调用 1 次引擎

5. 运行引擎

python3 scripts/cn_last30days.py "{TOPIC},{SUBTOPIC}" \
  --platforms xhs,dy,gzh \
  --count 50 \
  --days 30 \
  --output-format json \
  --output-dir="${CN_LAST30DAYS_MEMORY_DIR:-$HOME/Documents/CnLast30Days}"

前台运行，5分钟超时，不要后台。 读取完整输出，包含三平台的标题、作者、互动数据和链接。

6. WebSearch 补充

引擎完成后补充 1-2 个 WebSearch，覆盖知乎、B站、36氪等引擎未覆盖的来源。排除 xiaohongshu.com / douyin.com / mp.weixin.qq.com（已被引擎覆盖）。

7. 综合输出

按 输出规则 生成研究报告。核心原则：

• 徽章之后、「我的发现」之前，必须输出「数据速览」模块：按公众号→小红书→抖音顺序，每平台展示 TOP5 作品表格（标题作为可点击超链接、作者、平台专属互动指标分列展示（公众号阅读/点赞/转发，小红书点赞/收藏/评论，抖音点赞/评论/分享）），模块末尾展示数据总量和 HTML 报告提示
• 按话题/故事综合，非按平台罗列
• 多平台交叉验证的结论置信度最高
• 高互动内容权重最高（含真实用户信号）
• 每个叙事段落以粗体标题开头，后跟 - 和正文
• 引用必须为可点击的 Markdown 链接

综合报告完成后，自动执行以下步骤生成 HTML 报告（无需询问用户）：

# 直接从 JSON 生成 HTML（不调 API，不写入 Markdown）
python3 scripts/cn_last30days.py --from-json "JSON文件路径" \
  --output-dir="${CN_LAST30DAYS_MEMORY_DIR:-$HOME/Documents/CnLast30Days}"

# 自动打开 HTML 报告
open "HTML文件路径"

脚本会输出 HTML 文件路径，自动打开后将路径告知用户即可。

---

其他资源

• 输出规则与模板 - 输出规则（LAW）、通用/对比查询输出格式模板
• 脚本文件 - Python 引擎（Python 3.8+，仅标准库）