cn-last30days 中国社媒话题研究

📝 简介

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

✨ 功能特性

🔑 鉴权

API Key 从 红狐数据 获取，配置方式：

export REDFOX_API_KEY=ak_你的密钥

优先级：命令行 --api-key > REDFOX_API_KEY > X_API_KEY > ~/.qoder/apis/redfox.json > 内置公共 Key（有免费额度）。

核心参数

平台信号解读：

工作流程

1. 环境检查

如无 REDFOX_API_KEY / X_API_KEY 环境变量且 ~/.qoder/apis/redfox.json 不存在，提示用户配置。内置公共 Key 有免费额度，可用则跳过。

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. 综合输出

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

• 按话题/故事综合，非按平台罗列
• 多平台交叉验证的结论置信度最高
• 高互动内容权重最高（含真实用户信号）
• 每个叙事段落以粗体标题开头，后跟 - 和正文
• 引用必须为可点击的 Markdown 链接

综合报告完成后，询问用户是否需要 HTML。如需要：

# 1. 写入 Markdown 报告
cat > "${CN_LAST30DAYS_MEMORY_DIR:-$HOME/Documents/CnLast30Days}/cn30days_{TOPIC}_report.md" \x3C\x3C 'REPORT_EOF'
{综合报告全文}
REPORT_EOF

# 2. 从 JSON + 报告生成 HTML（不调 API）
python3 scripts/cn_last30days.py --from-json "JSON文件路径" --report-file "报告Markdown路径" \
  --output-dir="${CN_LAST30DAYS_MEMORY_DIR:-$HOME/Documents/CnLast30Days}"

其他资源

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