前言¶

做內容運營或競品調研時，經常要在今日頭條裏按關鍵詞翻最新圖文和視頻，再按閱讀量或發佈時間篩一批樣本。手工在 App 或網頁裏翻頁、抄標題和鏈接，很難系統化對比，也不方便交給表格或報告繼續分析。下面介紹 SkillHub 上的社區 Skill「今日頭條爆款內容查詢」，把搜索、排序、時間範圍限定和結果展示（終端表格、CSV、HTML 報告）交給 Agent 按對話觸發，減少重複檢索勞動。

這是什麼¶

「今日頭條爆款內容查詢」是 SkillHub 座標 @user_5f9c21aa/toutiao-search-redfox 上的數據分析類 Skill（分類 data-analysis，版本 1.0.0，來源 community）。頁面標註作者爲 to the moon（紅狐數據）。

一句話定位：輸入關鍵詞搜索今日頭條最新作品（圖文/視頻），支持按閱讀量或時間排序、限定時間範圍，並在終端以表格展示結果，同時支持 CSV 導出與交互式 HTML 報告。官方說明適用於需要搜索今日頭條熱門內容、追蹤頭條熱點、分析爆款文章的場景。

SkillHub 標籤含 requires_api_key=true，表示使用前需要配置 API Key；具體變量名與獲取方式以安裝後包內 SKILL.md 及發佈者說明爲準，本文不展開未在公開頁寫明的配置項。

核心功能¶

以下能力均來自 SkillHub 公開簡介，未做延伸：

1. 關鍵詞搜索：針對給定關鍵詞檢索今日頭條上的最新作品，覆蓋圖文與視頻。
2. 排序：支持按閱讀量排序，或按時間排序，便於看「當前最熱」或「最近更新」。
3. 時間範圍：可限定檢索的時間範圍，縮小樣本窗口。
4. 結果呈現：
   - 終端表格展示，便於在 CLI 會話裏快速瀏覽；
   - CSV 導出，便於二次統計或導入其他工具；
   - 交互式 HTML 報告，便於在瀏覽器裏查看與篩選。

安裝與啓用¶

Skill 遵循通用 SKILL.md 格式。在 SkillHub 上，官方給出的安裝方式是：讓當前使用的 AI 客戶端根據安裝文檔拉取該 Skill。

通過對話安裝（官方推薦提示）¶

將下面意圖發給支持 Skill 的 Agent（Cursor、Claude Code、Codex 等均可按各自 skills 目錄落盤）：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_5f9c21aa/toutiao-search-redfox`。

Agent 會按 SkillHub 安裝文檔檢查或安裝 skillhub CLI，並把 Skill 安裝到當前環境的 skills 目錄。

使用 skillhub CLI（文檔中的標準路徑）¶

若本機已有 skillhub，可先確認版本：

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

安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被客戶端加載。文檔記載的常用路徑示例：

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

安裝命令形式爲：

skillhub install user_5f9c21aa/toutiao-search-redfox --dir <你的 skills 目錄>

具體目錄以你當前使用的客戶端爲準；安裝後若客戶端要求重啓或重新加載 skills，按其產品說明操作。

API Key¶

公開標籤標明 requires_api_key=true。在首次調用搜索相關能力前，應按 Skill 包內說明配置 API Key；未在 SkillHub 摘要頁列出的字段名不在本文編造。

典型用法¶

公開頁未提供固定 shell 子命令示例，典型用法是在已啓用該 Skill 的 Agent 裏用自然語言描述檢索需求，由 Skill 驅動搜索與導出。可與官方簡介對齊的表述例如：

1. 「用關鍵詞『新能源汽車』搜今日頭條最近一週的視頻，按閱讀量從高到低排，結果導出 CSV。」
2. 「查今日頭條裏和『本地生活』相關的圖文，按時間排序，限定最近 3 天，並生成 HTML 報告。」
3. 「追蹤頭條熱點詞『某某事件』的最新作品，先在終端表格裏給我看前 20 條。」

經過上面的步驟，Agent 應能完成搜索、排序、時間過濾，並按你指定的形式輸出表格、CSV 或 HTML。若某次調用失敗，優先覈對 API Key 是否已配置、網絡是否可達，以及 Skill 是否安裝在正確的 skills 目錄。

適用場景與注意¶

適合誰

• 需要按關鍵詞批量查看今日頭條圖文/視頻樣本的內容、運營或分析人員；
• 要在 Agent 工作流裏做熱點追蹤、爆款結構參考檢索，並希望結果可落盤（CSV/HTML）的團隊。

使用上需注意

• 數據來自 Skill 所對接的檢索能力，時效性與字段以實際返回爲準；公開材料未承諾與頭條官方後臺數據完全一致。
• 社區來源（community），版本當前爲 1.0.0；升級可通過 skillhub 或 SkillHub 頁面關注新版本。
• SkillHub 頁面統計（截至抓取）：評分 100000，下載 2278；安裝數在抓取快照中爲 0，僅作商店側參考，不代表你本機是否已安裝。
• 涉及平臺內容與合規使用時，應遵守今日頭條及相關服務的使用條款；批量抓取或商用需自行評估授權與頻率限制。

結尾¶

「今日頭條爆款內容查詢」把頭條關鍵詞檢索、排序與時間過濾，以及終端表格、CSV 與 HTML 報告幾種輸出方式收進一個 Skill，適合在 Cursor 等 Agent 環境裏做熱點與爆款樣本的快速拉取。安裝與優先源配置以 SkillHub 文檔爲準；Skill 詳情與安裝入口：

• SkillHub 頁面：https://www.skillhub.cn/skills/user_5f9c21aa/toutiao-search-redfox
• API 座標頁：https://api.skillhub.cn/user_5f9c21aa/toutiao-search-redfox