wechat-original-hot

公众号の人気オリジナル記事

1. 概要

一言での説明：公众号のオリジナル人気記事をおすすめするツールです。インターネット全体から毎日、公众号のオリジナル人気記事を継続的に収集し、カテゴリや日付による絞り込みに対応しています。HTMLのビジュアルレポートと毎日の購読配信も提供します。

主な価値：

• オリジナルに特化：公众号のオリジナル人気記事に特化して収集し、転載・コピー記事とは区別します
• 柔軟な検索：カテゴリ検索、日付検索、期間検索など、さまざまな方法に対応しています
• 完全なデータ出力：会話内にすべての記事を1件ずつ表示し、省略や途中での切り捨ては禁止です

対象ユーザー：公众号のコンテンツクリエイター、オリジナル記事のライター、人気記事の研究者、セルフメディア運営者。

重要なお知らせ：このSkillでは、必ずスクリプトを呼び出してデータを取得してください。AI が独自にコンテンツを生成することは禁止されています。

2. 機能

主な機能

機能モジュール	機能の説明	主な価値
📊 オリジナル人気記事ランキング	公众号のオリジナル人気記事TOP50を取得	オリジナルコンテンツに特化し、創作のトレンドを把握
🏷️ カテゴリ絞り込み	22の標準カテゴリを個別に検索	分野に特化したオリジナル人気記事を的確に特定
📅 日付指定	日付を指定した検索に対応。デフォルトで過去30日を遡ります	過去のデータを柔軟に検索
🎨 HTMLビジュアルレポート	WeChatグリーンをテーマにしたデザインで、PDFへのエクスポートに対応	共有、保存、データ報告に便利
⏰ 購読配信	毎日19:30に定時配信	オリジナル人気記事の動向を継続的に追跡

特長

• スクリプト呼び出しを必須化：AI による独自のコンテンツ生成を禁止し、データの正確性を確保します
• 1件ずつ完全に表示：limit=20の場合は、20件すべてを1件ずつ出力する必要があり、途中での切り捨てや省略は厳禁です
• 時間を自動判定：データ同期時刻（19:30）に基づいて、適切な検索期間を自動計算します
• カテゴリのあいまい検索：あいまいなキーワードを22の標準カテゴリに自動で照合できます

3. ワンクリックインストール

認証

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..."

依存関係のインストール

追加のインストールは不要です。スクリプトはPython標準ライブラリ（json、argparse、os、sys、urllib、ssl）を使用します。

環境変数の設定

変数名	説明	必須
REDFOX_API_KEY	红狐 API Key	はい

4. 使用ガイド

基本的な使い方

起動時のメッセージ

Skillの読み込み後、ユーザーに「スキルの読み込みが完了しました。最新のオリジナル人気記事をお届けしましょうか？」と提示します。

総合ランキングのオリジナル人気記事を検索

python scripts/fetch_articles.py --type "总排名" --limit 20

または --type を指定しない場合、デフォルトは「総合ランキング」です。最新のオリジナル人気記事Top20を出力します。

カテゴリ検索

python scripts/fetch_articles.py --type "科技数码" --limit 20

カテゴリ名はユーザーの入力から照合します。カテゴリ対応表を参照してください。

日付検索

python scripts/fetch_articles.py --type "总排名" --start_date "2026-05-03" --limit 20

スクリプトは endDate = startDate + 1日を自動計算します。

応用的な使い方

ユーザーの意図を認識

エージェントは、まずユーザーの意図の種類を認識します。

意図の種類	トリガーワード	処理方法
直接検索	「今日の人気記事」、「オリジナル人気記事」、「最新の人気記事」	最新のオリジナル人気記事Top20を出力
カテゴリ検索	「テクノロジー」、「健康・養生」、「金融・経済」	カテゴリを照合し、そのカテゴリのTop20を出力
日付検索	「5月3日のオリジナル人気記事」、「昨日の人気記事」	指定日の人気記事Top20を出力
期間検索	「最近」、「最新」（明確な期間の指定なし）	デフォルトで過去7日間を検索し、Top20を出力
あいまいな入力	入力が不明確	今日のオリジナル人気記事を直接配信

データの時刻に関する説明

• データ同期時刻：毎日19:30に同期
• 同期データの範囲：前日（T-1）のデータ
• 検索データの範囲：
  • 現在時刻 < 19:30：T-2のデータ（一昨日）を検索
  • 現在時刻 >= 19:30：T-1のデータ（昨日）を検索
• デフォルトの検索期間：「最近」、「最新」など、期間が明示されていない場合は、デフォルトで過去7日間を検索します

インターフェース情報

• インターフェースURL：https://redfox.hk/story/api/cozeSkill/getWxDataByCategoryAndTime
• リクエスト方式：POST（JSON body）
• 認証方式：X-API-KEY header。値は REDFOX_API_KEY 環境変数から取得します
• パラメーター：
  • type：カテゴリ名（例：「テクノロジー・デジタル」、「総合ランキング」など）
  • startDate：開始日（YYYY-MM-DD形式）
  • endDate：終了日（YYYY-MM-DD形式）
  • source：「公众号文章原创之王」（固定値）

主な出力ルール（必ず守ってください）

• スクリプトの呼び出しが必須：エージェントは fetch_articles.py スクリプトを呼び出す必要があります。記事の内容を独自に生成してはいけません
• スクリプトのパスやコードの出力は禁止：エージェントは、スクリプトのパス、コード内容、実行コマンドをユーザーに表示してはいけません
• スクリプトの出力をそのまま表示：スクリプトのstdout出力はそのまま表示し、省略、変更、再フォーマットしてはいけません
• 途中での切り捨てや省略は禁止：limit=20の場合は、20件すべてを1件ずつ出力する必要があります。「...」を使って先頭のN件だけを表示することは厳禁です
• データの変更は禁止：スクリプト出力のいかなる部分も、変更、再フォーマット、装飾、非表示にしてはいけません
• スクリプトの出力が最終出力：スクリプトの出力内容を、そのままユーザーに表示する最終内容とします
• 案内文の省略は禁止：スクリプト出力の「合計XX件を取得しました...」と購読サービスに関する案内は、必ずすべて表示してください

出力形式

記事の概要表：

| 序号 | 作者 | 标题 | 阅读数 |
|------|------|------|--------|
| 1 | [夜听](https://open.weixin.qq.com/qr/code?username=yetingfm) | [【夜听】有一种感情，叫不再联系](https://mp.weixin.qq.com/s?...) | 10w+ |

出力例（最新回のデータ。時期が一致しない場合は案内が必要です）：

💡 数据说明
公众号原创文章推荐将在每日19点30分准时更新昨日文章数据，以下数据为获取时间时的快照，和实时数据有所差别。

非常抱歉🙏，最新的是前天的数据，我将为您查询最接近您需求的2026年05月12日原创文章。

📊 原创爆文推荐
最近30天的原创爆款文章

| 序号 | 作者 | 标题 | 阅读数 |
|------|------|------|--------|
| 1 | [作者A](链接) | [文章标题](链接) | 10w+ |
...

导出功能：输出生成HTML榜单页面，表格内容支持导出 PDF 格式，自动生成并打开

共获取到50条爆款原创热门文章,当前展示前20条。

📬 订阅服务
是否需要订阅具体赛道的账号表现？我们支持：
人文资讯、知识百科、健康养生、时尚潮流、美食餐饮、乐活生活、旅游出行、搞笑幽默、情感心理、体育娱乐、美容美体、文摘精选、财富理财、科技数码、创投商业、汽车交通、房产楼市、职场发展、教育考试、学术研究、企业品牌、总排名
订阅推送 — 每天19点30分推送最新公众号原创文章
暂不需要 — 仅本次查询

時期が一致しない場合の案内ルール

検索日とユーザーが尋ねた日付が一致しない場合は、データの説明の後に必ず次の案内を表示してください。

• 検索日 > 最新日付：非常抱歉🙏，最新的是{查询日期}的数据，我将为您查询最接近您需求的{查询日期}原创文章。
• 検索日 < 遡れる最も古い日付：非常抱歉🙏，目前最多支持回溯「过去30天」（最早至{回溯日期}），我将为您查询最接近您需求的时间范围~

「最近7日間」の検索（検索範囲が最新データを超える場合）

💡 数据说明
公众号原创文章推荐将在每日19点30分准时更新昨日文章数据，以下数据为获取时间时的快照，和实时数据有所差别。

非常抱歉🙏，最新的是前天的数据，我将为您查询最接近您需求的时间范围。

📊 原创爆文推荐
2026年05月06日至2026年05月12日的原创爆款文章

HTMLページの生成

会話内にすべての記事データを完全に出力した後、HTMLページを自動生成します。

python scripts/generate_hot_html.py --temp_file temp_articles.json --output "原创爆文_榜单.html" --display_count 20

HTMLのビジュアル仕様：

• メインカラー：rgb(0, 179, 84)（WeChatグリーン）
• アクセントカラー：#0088ff（閲覧数、ユーザー名）
• 順位1～3には🥇🥈🥉を使い、4位以降は数字を使います
• ユーザー名をクリックすると、公众号のプロフィールカードに移動できます（https://open.weixin.qq.com/qr/code?username={accountId}）
• PDFエクスポート：単一ページに合わせて自動調整し、pagebreak: { mode: 'none' }

生成前の条件：HTMLの生成前に、会話の返信内で --limit で指定された件数の記事がすでに1件ずつ表示されていることを確認してください。

購読サービス

特定カテゴリの購読が必要かどうかをユーザーに尋ねます。ユーザーが購読を選択した場合、毎日19:30に最新回のオリジナル人気記事データを配信します。

コマンド早見表

用途	コマンド例
総合ランキング検索	python scripts/fetch_articles.py --type "总排名" --limit 20
カテゴリ検索	python scripts/fetch_articles.py --type "科技数码" --limit 20
日付検索	python scripts/fetch_articles.py --type "总排名" --start_date "2026-05-03" --limit 20
HTML生成	python scripts/generate_hot_html.py --temp_file temp_articles.json --output "原创爆文_榜单.html" --display_count 20

5. 使用シーン

シーン1：オリジナル記事のライターが人気記事の書き方を学ぶ

役割：公众号のオリジナル記事ライター
ニーズ：最近のオリジナル人気記事のタイトル、テーマ、構成を研究し、執筆力を高める
使い方：全分野または特定分野のオリジナル人気記事Top20を検索し、1件ずつ読んで分析する
期待される効果：人気の高いオリジナル記事の成功パターンを学び、自身のコンテンツの独自性と訴求力を高める

シーン2：特定分野のコンテンツを比較・分析する

役割：特定分野の公众号運営者
ニーズ：自分の分野におけるオリジナル人気記事の最新トレンドと競争状況を把握する
使い方：「健康・養生」など、カテゴリ別に検索し、その分野のオリジナル人気記事Top20を出力する
期待される効果：同じ分野の人気コンテンツと的確に比較し、分野内のコンテンツの動向を把握する

シナリオ3：過去のバズ記事の振り返り研究

役割：コンテンツ戦略アナリスト ニーズ：特定の期間（祝日など）におけるオリジナルバズ記事の特徴を研究する 使用方法：日付照会機能を使用し、具体的な日付を指定してその日のオリジナルバズ記事を取得する 期待される効果：時間周期的なバズ記事の法則を発見し、より精度の高いコンテンツカレンダーを策定する

シナリオ4：毎日の購読による継続的トラッキング

役割：自媒体（セルフメディア）起業家 ニーズ：オリジナルバズ記事の動向を継続的に追跡し、コンテンツトレンドの変化を見逃さない 使用方法：毎日のプッシュ通知を購読し、毎日19:30に最新のオリジナルバズ記事を自動取得する 期待される効果：WeChat公式アカウントのオリジナルコンテンツエコシステムに対する継続的な認識を維持し、制作方向を適時調整する

6. プロジェクトアーキテクチャ

ディレクトリ構造

wechat-original-hot/
├── SKILL.md                        # 技能描述文件
├── scripts/
│   ├── fetch_articles.py           # 原创爆文数据获取脚本
│   └── generate_hot_html.py        # HTML页面生成脚本
└── references/
    └── category_mapping.md         # 分类映射表

技術スタック

コンポーネント	技術	説明
スクリプト言語	Python 3	標準ライブラリを使用（json、argparse、os、sys、urllib、ssl）
データインターフェース	Redfox API (POST)	https://redfox.hk/story/api/cozeSkill/getWxDataByCategoryAndTime
認証方式	X-API-KEY	リクエストヘッダー認証
レポートテンプレート	HTML/CSS/JS	WeChatグリーンテーマスタイル
PDFエクスポート	html2pdf.js	自動調整シングルページモード

コアモジュールの説明

モジュール	機能
fetch_articles.py	オリジナルバズ記事データを取得し、カテゴリ照会と日付照会に対応、一時JSONファイルに保存する
generate_hot_html.py	一時JSONファイルからデータを読み取り、WeChat公式アカウントスタイルのHTMLページを生成する
category_mapping.md	カテゴリマッピングテーブル。22の標準カテゴリと汎化キーワードを含む

リソースインデックス

• スクリプト: scripts/fetch_articles.py を参照（用途: オリジナルバズ記事データを取得し、カテゴリ照会と日付照会に対応）
• スクリプト: scripts/generate_hot_html.py を参照（用途: 一時JSONファイルからデータを読み取り、WeChat公式アカウントスタイルのHTMLページを生成）
• リファレンス: references/category_mapping.md を参照（用途: カテゴリマッピングテーブル。22の標準カテゴリと汎化キーワードを含む）

7. よくある質問

インストール関連

Q: スクリプト実行時に "REDFOX_API_KEY not found" エラーが発生する A: 環境変数 REDFOX_API_KEY が設定されていることを確認してください。上記の認証セクションを参考に設定できます。

Q: サードパーティ製の依存関係をインストールする必要がありますか？ A: 不要です。スクリプトはPython標準ライブラリ（json、argparse、os、sys、urllib、ssl）を使用しており、追加のインストールは不要です。

使用関連

Q: 「今日」の記事を照会したのに一昨日のものが返ってくるのはなぜですか？ A: データは毎日19:30に前日分のデータを同期します。19:30より前に照会した場合、前日分のデータがまだ同期されていないため、システムは自動的に一昨日のデータを照会し、その旨を通知します。

Q: 会話で出力される記事数がlimitパラメータと一致しないのはなぜですか？ A: 本スキルは limit=20 の場合、必ず20件すべてを1件ずつ出力することを強制します。記事が欠けている場合は、エージェントの実行エラーを示しており、スクリプトを再呼び出しする必要があります。

Q: wechat-10w-hot との違いは何ですか？ A: wechat-original-hot はオリジナルバズ記事（ソース「公众号文章原创之王」に対応）に特化しています。wechat-10w-hot はすべての10万+閲読記事（転載および非オリジナルコンテンツを含む）を収録しています。

Q: 日付で照会するにはどうすればよいですか？ A: --start_date パラメータを使用します。例：--start_date "2026-05-03"。スクリプトは自動的に endDate = startDate + 1日 を計算します。

トラブルシューティング

Q: カテゴリ照会で正しいカテゴリにマッチしない場合は？ A: references/category_mapping.md のカテゴリマッピングテーブルを参照してください。ユーザーが入力したキーワードがマッピングテーブルにない場合は、22の標準カテゴリから選択するよう促すことができます。

Q: HTML生成後の記事数が正しくない場合は？ A: --display_count パラメータを使用して、HTMLの表示数が会話中の数と一致するようにしてください。生成前に、会話中に表示された記事数を必ず自己確認してください。

Q: 照会が空のデータを返す場合は？ A: 考えられる原因：1) そのカテゴリに照会期間内のオリジナルバズ記事がない；2) 照会日が30日の遡及範囲を超えている；3) 照会日が利用可能な最早データより前である。システムはそれぞれに応じた通知を行います。