前言¶
做抖音内容调研时，常见做法是复制分享文案或链接，再手工打开页面核对标题、发布时间、点赞评论等字段。链接形态多（短链、分享文本、aweme_id），页面结构也会随视频、图文而变化，很难在对话里稳定复现同一份结构化数据。
下面介绍 SkillHub 上的社区 Skill「抖音数据分析 SocialDataX 视频详情」（坐标 @user_825d9e7e/socialdatax-douyin-detail，当前版本 1.0.3）。它把「给定作品标识 → 查询作品详情与互动指标」写成 Agent 可执行的流程，数据侧由 SocialDataX 社媒数据助手提供，适合在 Cursor、Claude Code 等支持 Skills 的环境里做内容分析，而不是替代官方创作者后台。
这是什么¶
一句话定位：当用户提供抖音作品 ID、内容页 URL、短链或分享文本时，用 SocialDataX 接口查询作品详情、图文详情及互动相关字段，并指导 Agent 如何调用 CLI 或 MCP。
- 出品与分发：发布者为 SkillHub 用户
user_825d9e7e，来源标记为 community，分类为data-analysis；SkillHub 页面标注requires_api_key=true。 - 解决的问题：在 Agent 对话中统一处理「作品详情 / 图文详情 / 互动指标 / 内容调研」类请求，避免 Agent 自行猜测页面结构或编造数据。
官方页面：https://www.skillhub.cn/skills/user_825d9e7e/socialdatax-douyin-detail
API 入口页（SkillHub 登记）：https://api.skillhub.cn/user_825d9e7e/socialdatax-douyin-detail
核心功能¶
依据 Skill 包内 SKILL.md 与 SkillHub 简介，已核实能力包括：
- 作品详情查询：支持通过
aweme_id或抖音内容 URL / 短链 / 分享文本拉取单条作品详情（Douyin work details）。 - 图文与视频形态：说明中明确覆盖图文详情；输出指引要求在有数据时返回
content_type、图文images，并区分平台播放器资源video（图文帖可能仅为音频等资源）。 - 互动与元数据字段：引导返回描述、作者、发布时间、互动计数等事实字段，用于内容分析与调研。
- 两种调用路径：优先推荐直接 CLI（
npx socialdatax-skills）；若当前 Agent 已配置 MCP，可使用douyin_get_video_detail_by_aweme_id或douyin_get_video_detail_by_url。 - 只读边界：Skill 声明为只读，不读本地浏览器数据、不保存 API Key，不进行登录、发帖、点赞、评论或账号变更。
依赖环境（Skill 元数据）：需要本机可用的 node、npm，以及环境变量 SOCIALDATAX_API_KEY；可通过 npm 包 socialdatax-skills 执行数据命令。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已安装：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方安装文档执行完整安装或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
文档地址：https://skillhub.cn/install/skillhub.md
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令（与 SkillHub 搜索结果一致）：
skillhub install socialdatax-douyin-detail --namespace user_825d9e7e --dir ~/.cursor/skills
也可按 SkillHub 页面提示，让 Agent 参照 https://skillhub.cn/install/skillhub.md 安装 @user_825d9e7e/socialdatax-douyin-detail。
3、配置 SocialDataX API Key¶
数据调用使用环境变量 SOCIALDATAX_API_KEY。申请与管理入口以 Skill 文档为准：
https://socialdatax.com/?from=skillhub
不要将 Key 写入仓库；在运行 Agent 或执行 CLI 的 shell 环境中导出即可。
典型用法¶
Skill 建议优先使用直接 CLI，无需单独配置 MCP Server。单次查询只使用 --aweme-id 或 --url 之一，不要同时传入。
已知作品 ID 时：
export SOCIALDATAX_API_KEY="你的密钥"
npx -y socialdatax-skills@latest douyin detail --aweme-id "<aweme_id>" --pretty
仅有链接或分享文案时：
npx -y socialdatax-skills@latest douyin detail --url "<douyin_content_url_or_share_text>" --pretty
说明：
--url用于内容页 URL、短链或分享文本；不要传入播放地址（如video.play_url）。--pretty仅影响输出格式。
若 Agent 环境已启用 SocialDataX 相关 MCP，可改用工具 douyin_get_video_detail_by_aweme_id（已知 aweme_id）或 douyin_get_video_detail_by_url（URL / 短链 / 分享文本），约束与 CLI 相同。
在对话中的典型触发方式：用户提供抖音链接或分享口令，并要求「查作品数据」「看互动指标」「做内容调研」等；启用本 Skill 后，Agent 应按上述边界选择 CLI 或 MCP，并基于返回字段做分析，而不是臆造计数。
适用场景与注意¶
适合谁
- 需要在 Agent 会话里快速核对单条抖音作品的事实字段（文案、作者、时间、互动、图文素材摘要等）。
- 做竞品内容调研、选题复盘，希望输入链接即可得到结构化结果的研究、运营、数据分析相关角色。
限制与注意
- 必须自备 API Key：Skill 标签要求 API Key；未配置
SOCIALDATAX_API_KEY时数据调用无法完成。 - 社区来源：
source: community，使用前可在 SkillHub 查看版本与说明，并按自身合规要求评估第三方数据服务。 - 平台数据与配额：具体字段是否返回、调用频率与计费以 SocialDataX 官网及账户权限为准；Skill 只描述调用方式，不保证任意链接均可解析。
- 只读能力：不能代替官方发布、投流或账号运营操作。
- SkillHub 侧数据（抓取时点）：评分 100000，下载 4445；安装后仍以本地
SKILL.md与socialdatax-skills包行为为准。
结尾¶
「抖音数据分析 SocialDataX 视频详情」把 Douyin 单条作品的详情与互动指标查询收敛成可复用的 Agent Skill：配置 SOCIALDATAX_API_KEY，安装到对应 skills 目录，即可用 aweme_id 或分享链接驱动 CLI/MCP 只读查询。需要安装说明与坐标时，以 SkillHub 官方页为准：
https://www.skillhub.cn/skills/user_825d9e7e/socialdatax-douyin-detail
