前言¶

做內容選題或競品觀察時，往往需要先在今日頭條上按關鍵詞翻作品、看閱讀量和發佈時間。手工在 App 或網頁裏搜、抄標題、再整理成表，步驟多，也不方便和 AI 工作流銜接。下面介紹 SkillHub 上的 今日頭條爆款查詢（@redfox-data/toutiao-search，v1.0.1）：用關鍵詞檢索頭條最新圖文/視頻，支持排序與時間過濾，並在終端表格、CSV 與交互式 HTML 報告裏呈現結果。

這是什麼¶

今日頭條爆款查詢 是紅狐數據發佈的企業類 Skill（分類 content-creation），座標 @redfox-data/toutiao-search。它面向「搜頭條熱門作品、追熱點、看爆款指標」這類任務：輸入關鍵詞，從今日頭條最新發布的作品中拉取數據（官方說明爲實時拉取、無緩存延遲），再按你的選項排序、過濾並導出。

SkillHub 頁面標註 requires_api_key=true：調用紅狐數據 API 前需配置個人 API Key。API 請求會攜帶 今日頭條爆款查詢-RedSkill 標識。

核心功能¶

以下能力均來自該 Skill 的 SKILL.md 與 SkillHub 簡介，安裝後由 scripts/search.py 執行。

1. 關鍵詞搜索：必填位置參數 keyword，檢索頭條圖文與視頻作品。
2. 排序：--sort views（閱讀量，默認）或 --sort time（發佈時間），結果按所選維度降序。
3. 時間範圍：--hours N 限定最近 N 小時內發佈（0 表示不限）。
4. 翻頁：--pages 控制翻頁次數（默認 3 頁，每頁約 10 條）。
5. 主題擴展：--expand 自動關聯同義詞/相關詞聯合檢索；--also "詞1,詞2" 手動追加關鍵詞，結果去重。
6. 視頻篩選：--video-only 只保留確認爲視頻的作品。
7. 輸出形態：終端表格；UTF-8 BOM 的 CSV；深色主題 HTML 報告（可頁內搜索、卡片跳轉原文）。默認輸出目錄爲 ~/Downloads/QoderToutiaoSearch/。
8. 數據字段：標題、作者、閱讀量、點贊、評論、轉發、發佈時間、類型（圖文/視頻）、原文鏈接等；搜索列表與 workDetail 詳情補全配合使用。

依賴：pip3 install requests。

安裝與啓用¶

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

先檢查是否已有 CLI：

command -v skillhub && skillhub --version

未安裝時可執行官方安裝腳本（完整安裝或僅 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

說明見 SkillHub 安裝文檔。

2. 安裝本 Skill¶

安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。SkillHub 文檔給出的常見路徑示例：

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

安裝命令示例（將 <skills 目錄> 換成你的實際路徑）：

skillhub install @redfox-data/toutiao-search --dir <skills 目錄>

SkillHub 技能頁也支持讓 AI 按上述安裝文檔安裝 @redfox-data/toutiao-search。

3. 配置 API Key¶

任選一種方式（密鑰需自行在紅狐數據平臺申請）：

export REDFOX_API_KEY=ak_你的密鑰

python3 scripts/search.py "關鍵詞" --api-key ak_你的密鑰

echo '{"api_key":"ak_你的密鑰"}' > ~/.qoder/apis/redfox.json

註冊與 Key 管理：redfox.hk 設置頁。

典型用法¶

安裝後，在 Skill 目錄下將 SKILL_PATH 設爲該 Skill 的根路徑，再調用 scripts/search.py。

基礎搜索（終端表格 + 默認 CSV/HTML）：

python3 "$SKILL_PATH/scripts/search.py" "關鍵詞"

按閱讀量排序、限定最近 24 小時：

python3 "$SKILL_PATH/scripts/search.py" "大模型" --sort views --hours 24

主題擴展與多詞聯合檢索：

python3 "$SKILL_PATH/scripts/search.py" "美伊戰爭" --expand
python3 "$SKILL_PATH/scripts/search.py" "美伊戰爭" --also "美伊衝突,美國伊朗"

只查視頻、多頁、僅 CSV、不自動打開瀏覽器：

python3 "$SKILL_PATH/scripts/search.py" "測評" --video-only
python3 "$SKILL_PATH/scripts/search.py" "新能源汽車" --pages 5
python3 "$SKILL_PATH/scripts/search.py" "AI" --csv-only
python3 "$SKILL_PATH/scripts/search.py" "AI" --no-open

常用參數摘要：--output-dir 自定義輸出目錄；--port 指定 HTML 本地服務端口（默認 8767）。

在 Cursor 等環境中，也可直接用自然語言描述需求（例如「搜頭條 AI 相關、按閱讀量排序、導出 CSV」），由 Agent 按 Skill 說明調用上述腳本。

適用場景與注意¶

適合誰

• 需要在頭條側快速看某關鍵詞下的新作與互動數據的內容、運營、分析人員。
• 希望把檢索結果落到 CSV/HTML，便於二次統計或彙報的團隊。

Skill 文檔列出的典型任務包括：熱點追蹤、爆款分析、競品關鍵詞監控、選題採集、輿情速覽、視頻類內容篩選等；具體仍以你配置的關鍵詞與 API 返回爲準。

限制與注意

• 必須配置有效的 REDFOX_API_KEY（或等價配置），並關注平臺額度；額度問題需到紅狐數據控制台處理。
• 默認約 3 頁、每頁約 10 條，更多結果需增大 --pages；官方 FAQ 說明搜索範圍目前覆蓋近 1 年作品，並優先近期內容。
• 列表檢索後會進行詳情補全，等待時間屬正常現象。
• SkillHub 統計（以抓取資料爲準）：評分 100000，下載 1788；頁面展示安裝數爲 0，以 SkillHub 實時數據爲準。
• 使用第三方 API 與頭條數據時，請遵守平臺服務條款與合規要求。

結尾¶

今日頭條爆款查詢 把「關鍵詞 → 頭條作品列表 → 閱讀/互動指標 → 表格與導出」收成一條可在 Agent 裏複用的路徑，適合追熱點和做內容分析前的數據拉取。官方 Skill 包地址：https://api.skillhub.cn/redfox-data/toutiao-search；SkillHub 介紹頁：https://www.skillhub.cn/skills/redfox-data/toutiao-search。