社媒热搜助手

社媒热搜助手 (social-hot搜索)

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

你能用它做什么 看榜单 — 拉取微博/抖音/小红书/知乎/百度的实时热搜榜 解读热点 — 对单个话题做声量/情感/互动/平台分布分析 看原帖 — 采样话题下的代表性帖子,直接看舆论现场 当用户提出以下需求时,使用此技能 "今天微博热搜前 10 是什么?" "抖音榜单上有没有 XX 相关的话题?" "帮我分析一下'XX'这个热点的声量和情感倾向" "看看小红书上关于 XX 的真实讨论是怎样的" "最近 3 天'XX'话题在各平台的表现" 核心入口(三个 命令行工具 脚本)

• 查询热搜榜单 → scripts/查询_hot_列出.py

python3 ./scripts/查询_hot_列出.py --source 微博 --size 20 python3 ./scripts/查询_hot_列出.py --source 抖音 --keyword 华为 python3 ./scripts/查询_hot_列出.py --source 小红书 --date 2026-05-13

参数:

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

消耗: 1 次额度

• 单话题深度分析 → 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 次

• 话题原帖采样 → 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 次额度

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

python3 ./scripts/ensure_user.py

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

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

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

python3 ./scripts/查询_hot_列出.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/查询_hot_列出.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)

异常处理 异常 含义 处理 退出码 3 + stderr 飞书 URL 配额耗尽 转告用户,引导填表升级 退出码 2 + JSON error 网络/服务异常 提示稍后重试,不要循环重试 count: 0 该话题在该时间窗内无数据 建议放宽时间窗或检查关键词 退出码 1 参数错误 检查 --source / --topic 是否正确 数据时效 热搜榜单:实时 (5 分钟级延迟) 话题分析/原帖:T+1 (前一天数据完整) 升级到无限额度

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