mcpField
D
douyin-weekly-surge

douyin-weekly-surge

github.com/redfox-dataマーケティング・グロース450268 回インストール1 日前に更新
リポジトリ

douyin-weekly-surge について

douyin-weekly-surge は、Douyin の作品における7日間の「いいね」増加を追跡するマーケティングスキルです。カテゴリー別ランキング、過去データの検索、購読配信により、分野ごとの動向を調べる運用担当者を支援します。

主な機能

  1. 017日間の「いいね」増加ランキングを毎日更新
  2. 0228カテゴリーで絞り込み
  3. 03最大30日分の履歴検索
  4. 04通常TOP20、最大TOP50を表示
  5. 05カテゴリーと時間の希望に応じた購読

活用シーン

  1. 01「いいね」が増加中のDouyin作品を発見
  2. 02カテゴリー別の急上昇コンテンツを確認
  3. 03過去30日分のランキングを検索
  4. 04カテゴリー動向の定期配信を受信

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/redfox-data/redfox-community --skill douyin-weekly-surge

インストール後、Claude Code で/douyin-weekly-surgeを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.en.md
README.md
references/
alipay-recharge.md
api-config.md
interaction-guide.md
scripts/
douyin_weekly_surge.py

詳細

抖音七日いいね急上昇ランキング

📝 概要

週間コンテンツ急上昇モニタリングツールです。毎日、全プラットフォームから数万件の抖音作品を収集・検証し、過去7日間の新規いいね数 TOP50 ランキングを出力します。

  • 更新時刻：毎日 17:00 に過去7日間のデータを更新
  • 遡及範囲：過去30日まで遡及可能
  • 各カテゴリの返却上限は50件です

✨ 機能

機能モジュール機能の説明主な価値
週間急上昇毎日、過去7日間の新規いいね数 TOP50 ランキングを出力継続的に伸びている作品を発見
ジャンル絞り込み28種類のジャンルカテゴリで検索可能特定分野の急上昇コンテンツをピンポイントで特定
過去データの確認過去30日間のデータを遡って確認可能過去の急上昇傾向を追跡
クリック可能なリンク作品タイトルをハイパーリンク形式で出力ワンクリックで元の作品を表示
ページ表示デフォルトは TOP20、最大 TOP50 まで表示可能必要に応じて全件または概要データを取得
購読配信ジャンルと時間の希望を指定して購読可能急上昇情報を定時に取得

🔑 認証

红狐hub にアクセスして API Key を取得し、以下の方法で設定してください。

# 方式一：配置文件（如 OpenClaw 的 ~/.openclaw/openclaw.json）
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

# 方式二：终端环境变量
export REDFOX_API_KEY="ak_xxxx..."

📡 API 呼び出し

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

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

💳 ポイント不足時のチャージ（Alipay による決済引き継ぎ）

スクリプト scripts/douyin_weekly_surge.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 を参照してください（汎用フローで、他の skill でも再利用できます）。submit-payment の後、Agent は poll-payment-status --out-shake-no <查询单号> を使用して決済コールバックによる入金を自動で監視します。ユーザーが手動で確認する必要はありません。入金（outcome=success）後は、ユーザーが指定した元の検索パラメーターを使って scripts/douyin_weekly_surge.py を自動で再実行し、結果を出力します。

🔄 対話フロー

1. 時間の判定
ユーザー入力処理方法
今日／現在／最新最新のデータは昨日までであることを伝え、昨日までの過去7日間のデータを提供
未来の日付案内を返し、昨日までの過去7日間のデータを提供
過去30日以内の日付該当する日付を直接検索
30日より前の日付案内を返し、指定に最も近い期間のデータを提供

時間に関する案内文：

  • 当日／未来：「申し訳ありません🙏。最新データは昨日までの過去7日間のデータです。ご希望に最も近い期間の7日間急上昇ランキングをご案内します。」
  • 遡及範囲外：「申し訳ありません🙏。現在、ランキングの遡及範囲は「過去30日」までです。ご希望に最も近い期間のデータを検索します。」
2. ジャンルの判定

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

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

特に指定がない場合、デフォルトで昨日までの全カテゴリ対象の7日間急上昇ランキングを返します。全カテゴリと特定ジャンルのどちらの検索でも、デフォルトでは TOP20 を表示します。ユーザーが完全版を明確に希望した場合にのみ、全50件を出力してください。

📊 標準出力形式

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

💡 榜单说明：每日 17:00 更新过去七日数据，[如有时间偏差提示则插入]。飙升数据为七日新增统计，与累计总量存在差异。

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

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

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

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

📬 订阅服务
1️⃣ 我们每日 17:00 更新过去七日数据，是否需要订阅每日的抖音作品七日飙升排行，订阅后定时推送给您
2️⃣ 是否需要订阅具体赛道的作品表现？我们支持：[列出28个赛道]
作品タイトルのハイパーリンクに関する規則
  • 作品タイトルは必ず Markdown リンク形式で出力してください：[作品タイトル](workUrl)
  • workUrl は、インターフェースから返される share_url フィールドです
  • HTML の <a> タグやターミナルの OSC エスケープシーケンスは使用禁止です
データフィールドの説明
フィールド取得元フィールド説明
順位配列の位置過去7日間の新規いいね数の降順
作品タイトルaweme_desc + share_url上記の規則に従い、ハイパーリンク形式で表示
作者user_nicknameアカウント名
ジャンルcategory全カテゴリ検索の場合のみ表示
7日間の新規お気に入り数 / 7日間の新規コメント数 / 7日間の新規シェア数 / 7日間の新規いいね数add_collect_count / add_comment_count / add_share_count / add_digg_count過去7日間の新規エンゲージメントデータ（データベース登録時のスナップショット）。7日間の新規いいね数の列は、数値を太字で表示してください
投稿日時create_time_str形式：MM-DD HH:00

📬 ファイル出力と購読

  • デフォルトでは20件を表示します。ユーザーが完全版を希望した場合は Markdown テーブルで出力します（50件を含む）
  • 購読：ユーザーがジャンルと時間の希望を選択できます。毎日 17:00 の更新後に自動配信します

📚 その他のリソース

コメント

Markdown 対応