前言¶

做抖音相關的數據分析、內容歸檔或競品調研時，常見做法是手寫爬蟲或對接零散接口：要處理登錄態、反爬和字段變更，維護成本高。若你只需要在對話裏按抖音名稱或抖音 ID 拿到賬號基礎信息和近期作品列表，並把結果交給 Agent 繼續分析，可以把「查賬號 + 列作品」封裝成 Skill，由模型在合適意圖下自動調用。

下面介紹 SkillHub 上的 抖音作品洞察（@redfox-data/douyin-crawler），說明它做什麼、如何安裝，以及使用時的邊界。

這是什麼¶

抖音作品洞察 是紅狐數據（enterprise 來源）發佈的數據分析類 Skill，當前版本 1.0.6。定位可以概括爲：輸入 抖音名稱 或 抖音 ID，通過 紅狐 API 廣域庫 返回該賬號的基礎信息與近期作品內容列表；列表支持分頁，每頁最多 50 條。

Skill 頁標註 requires_api_key=true，即實際拉數需要配置紅狐側 API 密鑰，具體字段名與申請方式以 Skill 包內說明及紅狐數據文檔爲準（本文不展開未在公開頁出現的配置項）。

• SkillHub 頁面：https://www.skillhub.cn/skills/redfox-data/douyin-crawler
• 安裝座標：@redfox-data/douyin-crawler
• 分類：data-analysis

當用戶提到「爬取抖音作品」「抖音作品列表」「查看抖音視頻」「抖音內容採集」「抓取抖音作品」等表述時，Agent 會傾向於啓用該 Skill。

核心功能¶

依據 SkillHub 簡介，已覈實能力如下：

1. 賬號基礎信息：根據名稱或 ID 解析目標抖音賬號，返回基礎畫像類字段（具體字段以接口返回爲準）。
2. 近期作品列表：輸出該賬號近期作品內容列表，支持分頁；單頁上限爲 50 條。
3. 意圖觸發：面向「列作品、看視頻、採集內容」類自然語言需求，由 Skill 描述引導模型選用本工具，而不是每次手寫爬取腳本。

數據經紅狐 API 廣域庫獲取，不屬於本地瀏覽器模擬登錄方案；是否滿足你的合規與數據授權要求，需結合業務自行評估。

安裝與啓用¶

1、安裝 SkillHub CLI（若尚未安裝）¶

先檢查是否已有 CLI：

command -v skillhub && skillhub --version

未安裝時，可按 SkillHub 官方安裝文檔執行完整安裝（CLI + 默認 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

僅安裝 CLI：

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/ 時，部分 Agent 不會加載。

skillhub install @redfox-data/douyin-crawler --dir <skills 目錄>

常用路徑示例（來自 SkillHub 安裝文檔）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可將下列提示詞發給 AI，由其按官方安裝說明完成安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@redfox-data/douyin-crawler`。

3、API Key¶

Skill 標籤標明需要 API Key。安裝後請在 Skill 包內的 SKILL.md 或紅狐數據提供的說明中完成密鑰配置，否則無法通過廣域庫拉取數據。

典型用法¶

公開 SkillHub 頁未給出獨立 REST 示例；典型交互方式是在已啓用該 Skill 的 Agent 中，用自然語言說明目標賬號與需求，例如：

• 提供 抖音名稱 或 抖音 ID，要求查看近期作品列表；
• 說明是否需要翻頁（記住單頁最多 50 條，更多內容需分頁多次獲取）；
• 在返回列表基礎上，讓 Agent 做彙總、選題對比或導出整理。

模型會根據 Skill 描述中的觸發語（如「抖音作品列表」「抓取抖音作品」等）選擇本 Skill，再調用背後紅狐 API。具體請求參數與返回 JSON 結構以 Skill 實現與 API 文檔爲準，此處不臆造字段示例。

適用場景與注意¶

適合：

• 需要在對話裏快速查看某抖音號的公開側賬號信息與近期作品列表；
• 希望把「查賬號 + 列作品」交給 Agent，減少臨時寫爬蟲；
• 已具備或願意申請紅狐 API 密鑰，並接受 enterprise 數據源方案。

注意：

• 密鑰與費用：requires_api_key=true，使用前需完成 API Key 配置；調用量、配額與計費以紅狐數據爲準。
• 數量上限：作品列表分頁，每頁最多 50 條；全量歷史需多次分頁，不宜默認一次拿全站。
• 合規：廣域庫數據的使用範圍需符合平臺規則與你的業務授權；Skill 不替代法務或合規審查。
• 環境：SkillHub 頁面統計（截至資料抓取）爲評分 100000、下載 2079；安裝後若 Agent 未識別，檢查 --dir 是否指向正確 skills 目錄並按各客戶端要求重載配置。

結尾¶

抖音作品洞察 把「按名稱或 ID 查抖音賬號 + 拉近期作品列表（分頁、每頁至多 50 條）」封裝成可複用的 Agent Skill，適合內容調研與數據分析前的數據獲取環節。安裝與優先源策略以 SkillHub 官方文檔爲準；Skill 詳情與安裝入口：https://www.skillhub.cn/skills/redfox-data/douyin-crawler