前言¶
做抖音达人调研时，常见做法是手工翻主页、截图或写一次性爬虫。主页分享链、短链和 sec_user_id 形态不一，作品里还混着视频、图文和短剧合集，翻页 token 也不能跨账号复用。把「按达人查作品 / 查合集、分页、整理成可读摘要」交给 Agent，需要一套约定好的 Skill 和稳定的数据接口。下面介绍 SkillHub 上的 抖音达人数据 SocialDataX 达人作品（坐标 @user_825d9e7e/socialdatax-douyin-creator-videos，当前版本 1.0.3），它把 SocialDataX 的只读查询能力写进通用 SKILL.md，便于在 Cursor、Claude Code 等环境里安装后由模型按文档调用。
这是什么¶
一句话定位：面向 Douyin / 抖音创作者已发布内容 的数据 Skill，用于作品列表、图文列表、短剧/合集列表，以及近期发布、内容调研和创作者内容分析。
出品与托管：能力数据来自 SocialDataX 社媒数据助手；Skill 由社区发布者 user_825d9e7e 维护，在 SkillHub 分类为 data-analysis，来源标记为 community。SkillHub 页面标注 requires_api_key=true，调用前需配置 SOCIALDATAX_API_KEY。
官方 Skill 页：
- https://www.skillhub.cn/skills/user_825d9e7e/socialdatax-douyin-creator-videos
- https://api.skillhub.cn/user_825d9e7e/socialdatax-douyin-creator-videos
核心功能¶
以下能力均来自该 Skill 的 SKILL.md 与元数据说明，为只读查询，不涉及登录、发帖、点赞或改号。
- 达人作品列表：按
sec_user_id或主页 URL / 短链 / 分享文案查询已发布作品（douyin user-posts或对应 MCP 工具）。 - 短剧 / 合集列表：同一套身份参数下查询创作者系列内容（
douyin user-series或对应 MCP 工具）。 - 分页：使用接口返回的
next_page_token，通过--page-token或 MCP 的page_token翻页；token 绑定当前用户与命令类型，不可跨用户或跨命令族复用。 - 输出解读指引：Skill 要求 Agent 汇总标题/描述、发布时间、互动数、媒体链接、内容类型；图文优先用
image_urls；合集侧可报告系列 ID、标题、封面、价格与作者信息等字段（以实际返回为准）。
运行依赖：node、npm，以及 npm 包 socialdatax-skills（Skill 元数据中的安装项）。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明见：https://skillhub.cn/install/skillhub.md
2. 将 Skill 装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。SkillHub 文档给出的常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令示例（将 <skills 目录> 换成你的实际路径）：
skillhub install @user_825d9e7e/socialdatax-douyin-creator-videos --dir <skills 目录>
若你更习惯用自然语言驱动 Agent，SkillHub 页面提供的提示词为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_825d9e7e/socialdatax-douyin-creator-videos。
3. 配置 API Key¶
环境变量名固定为 SOCIALDATAX_API_KEY。申请与管理入口以 SocialDataX 官网为准：
https://socialdatax.com/?from=skillhub
Skill 明确：不向本地浏览器取数、不保存 Key，且仅引导上述官方域名。
典型用法¶
Skill 建议优先使用可直接执行的 CLI（无需单独配 MCP）。下列命令来自官方 SKILL.md，npx 会拉取 socialdatax-skills 最新包。
已知创作者 sec_user_id 时查作品列表：
npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --pretty
只有主页链接或分享文案时：
npx -y socialdatax-skills@latest douyin user-posts --profile-url "<profile_url_or_share_text>" --pretty
查短剧 / 合集列表（参数二选一，与作品查询相同规则）：
npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --pretty
npx -y socialdatax-skills@latest douyin user-series --profile-url "<profile_url_or_share_text>" --pretty
翻页时带上上一页返回的 token（勿改写、勿跨用户复用）：
npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --page-token "<next_page_token>" --pretty
若当前 Agent 已接入 SocialDataX 相关 MCP，可使用工具名：douyin_get_user_posted_videos_by_sec_user_id、douyin_get_user_posted_videos_by_profile_url、douyin_get_user_series_by_sec_user_id、douyin_get_user_series_by_profile_url，分页字段与 CLI 的 page_token 语义一致。
在对话中的典型提问方向（Skill 原文归纳）：抖音达人数据、某达人作品列表、图文列表、短剧合集、近期话题回顾、对标账号跟踪、内容风格分析等——由 Agent 读取本 Skill 后选择 CLI 或 MCP 并整理输出。
适用场景与注意¶
适合谁：需要做抖音创作者内容调研、竞品账号跟踪、近期发布盘点，或要把作品/合集结构化成摘要的数据分析、运营、研究场景；希望把查询步骤固化给 Agent，而不是每次手写脚本。
限制与注意：
- 只读边界：不执行登录、互动或账号变更；合规与平台条款仍需自行把握。
- 必须自备 SOCIALDATAX_API_KEY 与 Node 环境；无 Key 时只能完成安装，无法真正拉数。
- 单条命令在
--sec-user-id与--profile-url之间只能选其一。 - SkillHub 公开数据（截至页面抓取）：评分 100000，下载 2356；标签 requires_api_key=true。安装计数等以 SkillHub 实时页为准。
结尾¶
抖音达人数据 SocialDataX 达人作品 把 SocialDataX 的抖音达人作品与合集查询写进标准 Skill 文档，并给出 CLI 与 MCP 两套入口，适合在 Agent 工作流里做可复用的创作者内容分析。安装与坐标以 SkillHub 为准：
https://www.skillhub.cn/skills/user_825d9e7e/socialdatax-douyin-creator-videos
