redfox-data 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+，仅标准库）