前言¶
做抖音達人調研時，常見做法是手工翻主頁、截圖或寫一次性爬蟲。主頁分享鏈、短鏈和 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
