社媒热搜助手 (social-hotsearch)

一个面向社会化营销、内容运营、PR 公关、品牌投放从业者的热搜情报技能。 零配置,首次使用自动注册,免费 200 次调用额度。

你能用它做什么

1. 看榜单 — 拉取微博/抖音/小红书/知乎/百度的实时热搜榜
2. 解读热点 — 对单个话题做声量/情感/互动/平台分布分析
3. 看原帖 — 采样话题下的代表性帖子,直接看舆论现场

当用户提出以下需求时,使用此技能

• "今天微博热搜前 10 是什么?"
• "抖音榜单上有没有 XX 相关的话题?"
• "帮我分析一下'XX'这个热点的声量和情感倾向"
• "看看小红书上关于 XX 的真实讨论是怎样的"
• "最近 3 天'XX'话题在各平台的表现"

核心入口(三个 CLI 脚本)

1. 查询热搜榜单 → scripts/query_hot_list.py

python3 ./scripts/query_hot_list.py --source 微博 --size 20
python3 ./scripts/query_hot_list.py --source 抖音 --keyword 华为
python3 ./scripts/query_hot_list.py --source 小红书 --date 2026-05-13

参数:

• --source (必填):平台,可选 微博 / 抖音 / 小红书 / 知乎 / 百度
• --size:返回数量,默认 50,最多 100
• --keyword:可选,过滤包含特定关键词的话题
• --date:可选,日期 YYYY-MM-DD,默认今天

消耗: 1 次额度

2. 单话题深度分析 → scripts/analyze_topic.py

python3 ./scripts/analyze_topic.py --topic '特朗普访华'
python3 ./scripts/analyze_topic.py --topic '小米SU7' --days 7 --with-clusters
python3 ./scripts/analyze_topic.py --topic '苹果AI' --datasource 小红书 抖音

参数:

• --topic (必填):话题关键词
• --days:时间窗口天数,默认 3
• --datasource:平台列表,默认 微博 抖音 小红书
• --with-clusters:加上相关话题聚类(会多消耗 1 次额度)

输出: 声量、情感指数、互动数、用户数、平台分布、(可选)关联话题 消耗: 基础 1 次,加 --with-clusters 共 2 次

3. 话题原帖采样 → scripts/sample_posts.py

python3 ./scripts/sample_posts.py --topic '小米SU7' --size 20
python3 ./scripts/sample_posts.py --topic '苹果AI' --datasource 小红书 --order 互动数

参数:

• --topic (必填):话题关键词
• --days:时间窗口,默认 3
• --datasource:平台列表,默认 微博 抖音 小红书
• --size:采样数量,默认 20,最多 100
• --order:排序,可选 综合/发布时间/互动数/阅读数/曝光量

输出: 帖子列表(标题/内容/作者/链接/互动数据) 消耗: 1 次额度

4. 查询当前剩余额度 → scripts/ensure_user.py

python3 ./scripts/ensure_user.py

输出 user_id、已用、剩余次数。首次运行会自动注册,不消耗额度。

操作规则(给 AI 看的)

1. 首次使用:任何脚本第一次调用时会自动通过 ~/.config/social-hotsearch/user.json 注册新用户,无需用户手动配置
2. 配额耗尽时:脚本退出码为 3,stderr 输出引导用户填写飞书表单的提示。直接把表单 URL 转告用户,不要尝试绕过
3. 平台名称:必须使用中文 微博/抖音/小红书/知乎/百度,不要用英文 weibo/douyin 等
4. 时间范围:analyze_topic 和 sample_posts 的 --days 参数最多 365 天
5. 省额度:用户问"看看 XX 热搜"通常只需要 query_hot_list,不要叠加 analyze_topic + sample_posts 三连击除非用户明确要求深度分析
6. 结果解读:返回的 JSON 较长时,用 head / jq 截取展示给用户;不要把完整 JSON 灌给用户看

典型工作流

场景 A - 用户:"今天小红书有什么热搜?"

python3 ./scripts/query_hot_list.py --source 小红书 --size 10

解读 top 10,简单评论。消耗 1 次

场景 B - 用户:"分析一下'特朗普访华'这个热点"

python3 ./scripts/analyze_topic.py --topic '特朗普访华' --days 3

基于声量/情感/互动数据给出洞察。消耗 1 次

场景 C - 用户:"看看小红书上'小米SU7'的真实讨论"

python3 ./scripts/sample_posts.py --topic '小米SU7' --datasource 小红书 --size 30 --order 互动数

拉高互动样本,提炼用户态度。消耗 1 次

场景 D - 完整热搜情报(用户明确要深度分析)

# 1. 看榜
python3 ./scripts/query_hot_list.py --source 微博 --size 20
# 2. 用户挑一个话题
python3 ./scripts/analyze_topic.py --topic '挑出的话题' --with-clusters
# 3. 取代表帖
python3 ./scripts/sample_posts.py --topic '挑出的话题' --size 30 --order 互动数

消耗 4 次(榜单 1 + 分析含聚类 2 + 采样 1)

异常处理

数据时效

• 热搜榜单:实时 (5 分钟级延迟)
• 话题分析/原帖:T+1 (前一天数据完整)

升级到无限额度

免费 200 次用完后,填写以下飞书表单联系商务: https://tj4ovkghqw.feishu.cn/share/base/form/shrcnHBiiUFOUhRO7Y6H6eeEbQd