前言¶

运营侧做内容日历，常见做法是手工刷热榜、把截图丢进表格，再凭经验排 7 天或 30 天的选题。问题在于：小红书、抖音、快手的榜单和搜索口径不同，发布时间、排序维度也不好对齐，复盘时往往只剩主观判断，缺少可追问的样本和 ID。

下面介绍 SkillHub 上的 SocialDataX 内容日历研究（坐标 @user_825d9e7e/socialdatax-content-calendar-research，当前版本 1.0.13）。它把「热榜 + 关键词搜索」的调用方式写进 SKILL.md，让 Agent 在对话里按统一流程拉数据、整理证据，再输出适合排期的观察结论。

这是什么¶

SocialDataX 内容日历研究 是一条面向内容运营的 Agent Skill，来源为 SkillHub community，由发布者 user_825d9e7e 维护，分类为 content-creation。官方页面标注 requires_api_key=true：数据请求依赖环境变量 SOCIALDATAX_API_KEY，底层通过 Node.js 运行 socialdatax-skills 包中的 CLI（或等价的 MCP 工具）。

它解决的是：在 小红书、抖音、快手 上做内容日历相关研究——包括 7 天或 30 天选题规划、发布时间观察、主题分组、平台节奏对比、运营素材整理等，而不是替代你定稿或发稿。

核心功能¶

以下能力均来自 Skill 自带的 SKILL.md 说明，可按需组合使用。

三平台热榜¶

无需关键词，直接观察当前榜单排名与热度信号：

• 小红书：xhs hot-search
• 抖音：douyin hot-search
• 快手：kuaishou hot-search

关键词搜索与筛选¶

按选题方向拉内容样本，支持分页与条数上限：

• 三平台均提供 search --keyword "<keyword>"
• 小红书额外支持笔记类型（--note-type）、排序（--sort-type）、发布时间范围（--publish-time-range）
• 抖音额外支持时长（--duration-range）、内容类型（--content-type）等筛选
• 通用：--pages <n>、--max-items <n> 扩大样本；--page-token 续页时需原样传回完整 next_page_token

Agent 侧输出规范¶

Skill 要求把「可见证据」和「判断」分开写：热榜与搜索结果分栏；需要追溯时保留标题、作者、链接或内容 ID、指标与发布时间。小红书 note_url 须保留完整 URL（含 xsec_token）；note_id 不得截断前缀。

只读与安全边界¶

Skill 明确为只读：不读本地浏览器数据，不执行登录、发帖、点赞、评论或改号。API Key 只从用户环境变量读取，不写入 Skill 文件。

MCP 等价工具¶

若 Agent 已配置 SocialDataX MCP，可与 CLI 对应使用，例如 xhs_get_search_hot_list、xhs_search_notes、douyin_get_hot_search_list、douyin_search_videos、kuaishou_get_hot_search_list、kuaishou_search_videos。参数命名与 CLI 的 kebab-case 不同，需按文档使用 snake_case。

安装与启用¶

1、安装 SkillHub CLI（尚未安装时）¶

command -v skillhub && skillhub --version

未安装时可按 SkillHub 官方安装文档执行完整安装：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2、安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。

skillhub install @user_825d9e7e/socialdatax-content-calendar-research --dir <skills 目录>

常见路径示例（以 SkillHub 安装文档为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

SkillHub 页面也支持把安装提示发给 AI，内容为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_825d9e7e/socialdatax-content-calendar-research。

3、配置 API Key 与运行依赖¶

在官网申请或管理 Key（Skill 文档指定入口）：

https://socialdatax.com/ai?from=skillhub

环境变量名固定为：

export SOCIALDATAX_API_KEY="你的密钥"

Skill 元数据要求本机具备 node、npm；首次执行 CLI 时会通过 npx 拉取 socialdatax-skills 包。

典型用法¶

先做环境检查，再在对话里描述选题方向、要对比的平台，以及希望观察的时间维度（例如近一周发布内容）。Agent 按 Skill 建议可先取 1 页样本，再决定是否 --pages 或 --max-items 扩大。

直接调用时，Skill 示例命令如下（需已配置 SOCIALDATAX_API_KEY）：

npx -y socialdatax-skills@latest xhs hot-search \
  --pretty --source-client socialdatax-skills --source-platform skillhub \
  --source-skill socialdatax-content-calendar-research

npx -y socialdatax-skills@latest douyin search \
  --keyword "秋季护肤" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill socialdatax-content-calendar-research \
  --publish-time-range week --sort-type time_descending

返回为 JSON，包含 platform、tool、arguments 和 data；多页搜索会合并到 data.items，并附带 page_count、item_count 与下一页标记。

在 Cursor 等客户端中，更常见的路径是：安装 Skill 后，用自然语言提出需求，例如「对比小红书与抖音本周与『职场成长』相关的内容节奏，先各搜一页再归纳主题分组」。Agent 应优先走 direct CLI 或 MCP，而不是用公开网页搜索替代 SocialDataX 数据。

适用场景与注意¶

适合谁：负责社媒选题、内容日历、多平台节奏对齐的运营或策略同学；需要在对话里快速拉热榜与搜索证据、并保留可追溯字段的团队。

平台与数据：覆盖小红书、抖音、快手；具体字段以 API 返回为准，Skill 中的示例结果仅说明展示格式，不代表固定字段集。

费用与配额：调用消耗 SocialDataX 账户积分；出现 insufficient_balance 或「积分不足」时不应盲目重试，应按错误信息中的充值指引处理，并确认当前 SOCIALDATAX_API_KEY 与充值账号一致。

环境与权限：npm 网络、Node 版本、沙箱执行权限会导致 CLI 失败；Skill 将其归为本地环境问题，需在用户授权范围内修复依赖，而非改用其他数据源。

SkillHub 侧信息：截至资料抓取时，该 Skill 评分为 100000，下载约 773 次（页面统计会变动，以 SkillHub 为准）。

结尾¶

SocialDataX 内容日历研究 把跨平台热榜与可筛选搜索收敛成一套 Agent 可执行的流程，适合用来支撑 7 天或 30 天选题规划、发布时间观察和平台节奏对比，同时通过只读边界和输出规范降低「只有结论、没有证据」的风险。

官方 Skill 地址：

• API 入口：https://api.skillhub.cn/user_825d9e7e/socialdatax-content-calendar-research
• SkillHub 页面：https://www.skillhub.cn/skills/user_825d9e7e/socialdatax-content-calendar-research