douyin-daily-hot

TikTok 毎日の人気作品ランキング

📝 概要

日次コンテンツ人気度モニタリングツールです。毎日、全プラットフォームから数万件のTikTok作品を手作業で収集・検証し、1日分のいいね数 TOP50 ランキングを出力します。

• 更新時刻：毎日 06:00 に前日分のデータを更新
• 遡及範囲：過去 30 日まで遡及可能
• 各カテゴリーの返却件数は最大 50 件

✨ 機能の特長

機能モジュール	機能の説明	主な価値
日次ランキング	1日分のいいね数 TOP50 ランキングを毎日出力	全プラットフォームで当日最も人気の作品をすばやく確認
ジャンル絞り込み	28 のジャンル分類で検索可能	特定の分野で人気のコンテンツを正確に特定
過去データの遡及	過去 30 日分のデータを遡及可能	過去の人気傾向を追跡
クリック可能なリンク	作品タイトルをハイパーリンク形式で出力	ワンクリックで元の作品を表示
ページ分け表示	デフォルトは TOP20、TOP50 全件を表示可能	必要に応じて全データまたは概要データを取得
購読プッシュ通知	ジャンルと時間の希望を指定して購読可能	人気の動向を定期的に取得

🔑 認証

API Key の取得

红狐hub にアクセスして API KEY を取得してください。

API Key の設定

方法1: OpenClawを例に、REDFOX_API_KEYを~/.openclaw/openclaw.jsonに追加します。設定の一部は以下のとおりです。

{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

方法2: ターミナルで設定

export REDFOX_API_KEY="ak_xxxx..."

📡 API 呼び出し

• エンドポイント：POST https://redfox.hk/story/api/dy/search/likesRank
• 認証方式：リクエストヘッダー X-API-KEY。値は環境変数 REDFOX_API_KEY から取得
• 固定パラメーター：source（値はスクリプトを参照）
• 任意パラメーター：type（ジャンル）、startTime、endTime（日付範囲）

詳しくは api-config.md を参照してください。

💳 ポイント不足時のチャージ（Alipayへの引き継ぎ）

スクリプト scripts/douyin_daily_hot.py が終了コード 3で終了し、stdout に ===PAYMENT_REQUIRED_JSON_START=== ブロックを出力した場合、現在の API Key のポイントが不足しています（インターフェース code=3210、3201にも対応）。レスポンスボディの data には、構造化された支払い情報が含まれます。cashierUrl（Alipay決済ページのリンク）、amount（注文金額、元）、goodsName（商品名）、outTradeNo（注文番号）です。

スクリプトの終了コード：0 は正常終了（「データなし」を含む）、1 はパラメーター／認証／インターフェースエラー、3 はポイント不足のためチャージが必要です。references/alipay-recharge.md に従ってAlipayのチャージ画面を開き、入金後に元のパラメーターでスクリプトを自動再実行します。

前提条件の確認、alipay-bot trigger-payment-signal → submit-payment → poll-payment-status のオーケストレーション手順、ウォレットの紐付け処理、支払い引き継ぎのルールと失敗時の処理については、すべて references/alipay-recharge.md を参照してください（汎用的な手順で、他のスキルでも再利用できます）。submit-payment の後、Agent は poll-payment-status --out-shake-no <查询单号> を使って支払いコールバックの入金を自動で監視するため、ユーザーが手動で再確認する必要はありません。入金（outcome=success）後、ユーザーの元の検索パラメーターを使って scripts/douyin_daily_hot.py を自動的に再実行し、結果を出力します。

🔄 操作の流れ

1. 日付の判定

ユーザーの入力	処理方法
今日 / 現在 / 最新	最新データは前日分であることを説明し、前日分のデータを提示
未来の日付	該当する日付は未来であることを伝え、前日分のデータを提示
過去30日以内の日付	該当する日付をそのまま検索
30日より前	該当する日付は対象外であることを伝え、最も近い範囲のデータを提示

日付に関する案内文：

• 当日／未来：「誠に申し訳ありません🙏、最新データは前日分です。ご希望に最も近い前日の人気ランキングをご案内します。」
• 遡及範囲外：「誠に申し訳ありません🙏、現在、ランキングは「過去30日」まで遡及できます。ご希望に最も近い期間のデータを検索します。」

2. ジャンルの判定

ユーザーの説明を以下の対応ジャンルに分類します。該当するジャンルがない場合はその旨を明確に伝え、すべてのジャンルを列挙してユーザーに選択を促します。

全部、小剧场、财富理财、二次元、身体锻炼、居家装修、数码科技、科学普及、
旅行、美食、动物、明星娱乐、汽车、亲子、人文、三农、潮流风尚、游戏、
生活记录、体育、舞蹈才艺、学习教育、休闲玩乐、影视、音乐、颜值造型、
健康医学、综艺、个人成长

3. デフォルトの動作

特別な指定がない場合は、前日分の全カテゴリー日次ランキングを返します。全カテゴリーと特定ジャンルのどちらの検索でも、デフォルトでは TOP20 を表示します。ユーザーが完全版を明示的に求めた場合にのみ、50 件すべてを出力します。

📊 標準出力形式

ランキングは Markdown テーブルで表示します。作品タイトルは [タイトル](workUrl) の形式で、クリック可能なハイパーリンクとして必ず出力してください。

💡 榜单说明：每日 06:00 更新昨日数据，[如有时间偏差提示则插入]。互动数据为入库时间，与实时数据存在差异。

📊 抖音每日点赞TOP20（YYYY-MM-DD）[查询全部时含"赛道"列，查询特定赛道时不含]

| 排名 | 作品标题 | 作者（粉丝数） | 赛道* | 收藏 | 评论 | 分享 | **点赞** | 发布时间 |
|------|---------|--------------|-------|------|------|------|------|---------|
| 1 | [红烧肉的教程](https://www.douyin.com/video/xxx) | 美食达人（10w+） | 美食 | 10w+ | 10w+ | 10w+ | **10w+** | 05-28 12:00 |

*查询特定赛道时去掉"赛道"列

⚡ 更多操作
• 本次榜单完整共50条数据，是否需要查看剩余30条？

📬 订阅服务
1️⃣ 我们每日 06:00 更新昨日数据，是否需要订阅每日的抖音作品最新排名，订阅后定时推送给您
2️⃣ 是否需要订阅具体赛道的作品表现？我们支持：[列出28个赛道]

> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询

作品タイトルのハイパーリンクに関するルール（必ず遵守）

• 作品タイトルは必ず Markdown リンク形式で出力します：[作品タイトル](workUrl)
• workUrl はインターフェースの返却フィールドで、TikTok上の作品へのアクセスリンクです
• HTML の <a> タグやターミナルの OSC エスケープシーケンスは使用禁止です
• ターミナルで直接クリックできない場合でも、Markdown リンク形式であれば会話画面で正しくクリック可能なハイパーリンクとして表示されます

データフィールドの説明

フィールド	参照フィールド	説明
順位	rank	当日のいいね数ランキング
作品タイトル	video_title + workUrl	[タイトル](workUrl) のハイパーリンク形式で必ず表示
作者	author_name + author_fans	アカウント名 + フォロワー総数
ジャンル	category	全カテゴリー検索時のみ表示
お気に入り / コメント / シェア / いいね	collect / comment / share / like	エンゲージメントデータ（データベース登録時のスナップショット）。いいね列の数値は太字で表示
公開時刻	publish_time	形式 MM-DD HH:00

📬 ファイル出力と購読

• デフォルトでは 20 件を表示します。ユーザーが完全版を求めた場合は、Markdown テーブル（50 件を含む）を出力します
• 購読：ユーザーはジャンルと時間の希望を選択でき、毎日 06:00 の更新後に自動でプッシュ通知を受け取れます

📚 その他のリソース

• API の設定と呼び出し：api-config.md
• ジャンル分類と操作例：interaction-guide.md