前言¶
做抖音內容調研時，常見做法是複製分享文案或鏈接，再手工打開頁面覈對標題、發佈時間、點贊評論等字段。鏈接形態多（短鏈、分享文本、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
