Back to skills
extension
Category: Data & AnalyticsAPI key required

SocialDataX 创作者研究

Use this skill when the user wants social creator research, XHS creator profiles, Douyin creator profiles, Kuaishou creator profiles, account basics, recent content review, partner shortlist research, or benchmark account observation.

personAuthor: user_825d9e7ehubcommunity
<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->

SocialDataX 创作者研究

适用场景

当用户需要做社媒创作者研究、小红书博主画像、抖音达人画像、快手达人画像、账号资料、近期内容复盘、合作对象初筛或对标账号观察时使用。来自 SocialDataX 社媒数据助手。

快速开始

  • 先给出当前 skill 支持的输入:账号主页、账号分享文本或平台账号 ID。
  • 如果结果有分页,先取第一页;要继续扩大,再按返回的下一页标记继续。
  • 你通常会得到:账号资料、认证、粉丝或互动信号、近期内容列表、发布时间和互动信号,以及可继续追问的角度。

API Key 获取

获取或管理 API Key:访问 https://socialdatax.com/ai?from=skillhub,按官网的 API Key 申请/管理入口操作。环境变量名固定使用 SOCIALDATAX_API_KEY;不要引导用户使用其他域名。

直接调用命令

优先使用 direct CLI;能运行 shell 命令的 Agent 不需要额外配置 MCP server:

npx -y socialdatax-skills@latest xhs user-info \
  --profile-url "<profile_url_or_share_text>" --pretty \
  --source-client socialdatax-skills --source-platform skillhub \
  --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest xhs user-posts \
  --profile-url "<profile_url_or_share_text>" --pretty \
  --source-client socialdatax-skills --source-platform skillhub \
  --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest douyin user-info \
  --profile-url "<profile_url_or_share_text>" --pretty \
  --source-client socialdatax-skills --source-platform skillhub \
  --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest douyin user-posts \
  --profile-url "<profile_url_or_share_text>" --pretty \
  --source-client socialdatax-skills --source-platform skillhub \
  --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest douyin user-series \
  --profile-url "<profile_url_or_share_text>" --pretty \
  --source-client socialdatax-skills --source-platform skillhub \
  --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest kuaishou user-search \
  --keyword "<creator_keyword>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest kuaishou user-info \
  --profile-url "<profile_url_or_share_text>" --pretty \
  --source-client socialdatax-skills --source-platform skillhub \
  --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest kuaishou user-posts \
  --profile-url "<profile_url_or_share_text>" --pretty \
  --source-client socialdatax-skills --source-platform skillhub \
  --source-skill socialdatax-creator-research

更多 direct CLI 入口:

npx -y socialdatax-skills@latest xhs user-info \
  --user-id "<user_id>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest xhs user-posts \
  --user-id "<user_id>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest douyin user-info \
  --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest douyin user-posts \
  --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest douyin user-series \
  --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest kuaishou user-search \
  --keyword "<creator_keyword>" --pages 3 --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest kuaishou user-info \
  --user-id "<user_id>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill socialdatax-creator-research

npx -y socialdatax-skills@latest kuaishou user-posts \
  --user-id "<user_id>" --pretty --source-client socialdatax-skills \
  --source-platform skillhub --source-skill socialdatax-creator-research

参数说明

创作者 / 账号:

  • 说明:如果手里是主页链接、短链或分享文本,使用 --profile-url <profile_url_or_share_text>
  • 说明:如果用户只提供了快手账号关键词、达人名称或赛道方向,先用 kuaishou user-search --keyword <creator_keyword> 找候选账号,再用返回的 user_id 继续查资料或内容列表。
  • 说明:如果创作者 ID 已经明确,XHS 或快手使用 --user-id <user_id>,抖音使用 --sec-user-id <sec_user_id>
  • 可选:--page-token <next_page_token>:创作者内容列表或合集续页时,只能原样使用完整返回 token;不能截断、改写、脱敏、重建,或用省略号替换中间内容。

通用:

  • 可选:--pretty:只影响输出格式,不改变实际请求结果。
  • 可选:--source-client socialdatax-skills --source-platform skillhub --source-skill socialdatax-creator-research:这是当前 Agent Skill 的来源标记;按本 Skill 示例执行时保持这些值不变。

只有在用户同时需要账号资料和近期内容证据时,才同时使用资料命令和内容列表命令。命令返回 JSON,包含 platformtoolargumentsdata

输出建议

优先输出可直接复盘的结果:创作者资料、创作者内容证据,并标出下一步可继续追问的问题。

输出创作者资料时,优先写昵称、平台 ID、简介、认证、粉丝数、关注数、获赞数、IP 属地、性别等可见事实;把事实和策略判断分开写。 整理内容列表时,优先保留标题或描述、摘要、发布时间、互动数据、媒体链接和内容类型等证据。 如果用了抖音短剧合集命令,优先输出合集 ID、标题、描述、封面、价格和作者信息;快手当前提供的是创作者作品列表,不是合集列表。 需要继续下钻时,优先复用返回里的内容 ID 去查详情或评论。

MCP 工具

与上面 direct CLI 命令对应的 MCP 工具:

  • xhs_get_user_info_by_profile_url
  • xhs_get_user_posted_notes_by_profile_url
  • douyin_get_user_info_by_profile_url
  • douyin_get_user_posted_videos_by_profile_url
  • douyin_get_user_series_by_profile_url
  • kuaishou_search_users
  • kuaishou_get_user_info_by_profile_url
  • kuaishou_get_user_posted_videos_by_profile_url
  • xhs_get_user_info_by_user_id
  • xhs_get_user_posted_notes_by_user_id
  • douyin_get_user_info_by_sec_user_id
  • douyin_get_user_posted_videos_by_sec_user_id
  • douyin_get_user_series_by_sec_user_id
  • kuaishou_get_user_info_by_user_id
  • kuaishou_get_user_posted_videos_by_user_id

上面自动列出的 MCP 工具名就是 URL / profile-url 入口的事实源;只有在平台 ID 已经明确时,才改用对应的 ID 型资料或内容列表工具。 做快手创作者发现时,使用 kuaishou_search_users 并传 keyword;只有续页时才传 page_token,不要传 page。 创作者内容列表和合集翻页使用不透明的 page_token;在同一用户链路下,必须把完整返回的 next_page_token 原样传回,不能截断、改写、脱敏、重建,或用省略号替换中间内容。

安全边界

这是只读 skill。运行时使用用户环境变量中的 SOCIALDATAX_API_KEY;生成的 Skill 文件不包含 API Key。不会读取本地浏览器数据,也不会执行登录、发帖、点赞、评论或账号修改。

示例结果

  • 示例展示格式,不代表固定字段:账号=昵称/ID/简介/粉丝信号、账号内容=标题/发布时间/互动信号;判断=相关原因和下一步。

异常处理

  • 非余额不足的网络或 API 异常:保留错误信息,检查 SOCIALDATAX_API_KEY、参数和链接格式后原样重试一次。
  • 如果返回 insufficient_balance 或“积分不足”:不要重复重试;把错误里的充值链接原样展示给用户,并提醒用户充值后继续执行刚才同一条命令。
  • 如果用户已经充值但仍提示余额不足:确认当前环境变量 SOCIALDATAX_API_KEY 是否来自刚充值的同一个账号;必要时重新复制官网后台的 API Key。
  • 分页中断:保留已取得的结果;重试仍失败:说明当前调用不可用,给出可替代输入方式。

常见问题

  • 没结果:确认账号主页、分享文本或平台账号 ID 完整。
  • 结果太多:补场景、人群、品牌、时间范围或账号名。
  • 调用失败:先确认 SOCIALDATAX_API_KEY 已配置;如果是 insufficient_balance 或“积分不足”,按错误里的充值链接充值后继续原命令,不要反复重试。
  • 担心账号安全:这是只读能力,不登录、不发帖、不点赞、不评论。
  • 想继续分析:把最相关的 1-3 条结果发回来,继续缩小范围。