cn-last30days

# Last 30 Days—CN版 ## 📝 简介 Last 30 Days—CN版 是中国社交媒体话题研究工具，从小红书、抖音、公众号三大平台搜索近30天真实讨论数据，通过跨平台对比分析舆情趋势。支持通用话题研究和实体对比两种模式，输出结构化研究报告和可视化 HTML。 ## ✨ 功能特性 | 功能模块 | 能力描述 | 核心价值 | |---------|---------|---------| | 三平台数据源 | 小红书/公众号统一接口 + 抖音广域库接口数据 | 多维度舆情视角 | | 关键词研究 | 支持多词组合查询（英文逗号分隔） | 灵活话题覆盖 | | 跨平台对比 | 自动综合三平台数据生成洞察 | 发现差异化趋势 | | 对比 | A vs B 结构化对比分析 | 辅助决策判断 | | HTML 报告 | 交互式可视化报告生成 | 便于分享传播 | | 历史回溯 | 支持近30天任意日期数据 | 追踪趋势演变 | ## 🔑 鉴权 脚本需配置 API Key 使用。从 [红狐数据](https://www.redfox.hk/settings/api-keys?source=github) 获取个人 Key 并配置环境变量： ```bash 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 个 WebSe...