wechat-10w-hot

公众号10w+文章

1. 简介

一句话定位：公众号10w+阅读爆文推荐工具，全网持续收录每日1000+条公众号10w+文章，支持按领域分类查询、智能爆款规律分析和HTML报告导出。

核心价值：

• 海量收录：每日收录1000+条10w+阅读文章，覆盖22个标准分类
• 智能分析：基于四维度内容分析（内容概述、热点利用、传播作用、达成效果）
• 可视化报告：自动生成公众号风格HTML页面，支持PDF导出

适用对象：公众号运营者、内容创作者、自媒体编辑、市场运营、爆文研究者。

2. 功能特性

核心功能

功能模块	能力描述	核心价值
📊 爆文榜单推送	获取全领域10w+阅读文章TOP50	快速了解公众号爆文风向
🏷️ 领域分类查询	22个标准分类独立查询	精准定位垂直领域爆文
📝 四维度内容分析	内容概述/热点利用/传播作用/达成效果	深度解析爆文成功要素
📈 爆款规律分析	标题特征/内容主题/发布时间/账号特征	提炼可复用的爆款方法论
🎨 HTML可视化报告	微信绿主题设计，支持PDF导出	便于分享存档和数据汇报
⏰ 订阅推送	每日19:30定时推送	持续追踪，不错过爆文

特色亮点

• 智能时间判断：根据数据更新时间(18:30)自动计算正确查询区间
• 分页预览机制：首次展示前10条，按需展示完整50条
• 四维度分析：每篇文章从内容概述、热点利用、传播作用、达成效果四方面深度分析
• HTML防分页：PDF导出自适应单页模式，所有内容完整展示

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标准库（urllib.request）。

环境变量配置

变量名	说明	必填
REDFOX_API_KEY	红狐 API Key	是

4. 使用指南

基础使用

查询全领域10w+文章（总榜）

启动后提示用户：「技能已加载完成。是否为您推送最新的10w+阅读文章。」

总榜请求直接推送最新10w+阅读文章TOP50（首次预览展示前10条）。

领域关键词查询

输入具体领域关键词（如"AI编程"、"财经"、"健康饮食"），系统自动匹配22个标准分类并输出该领域TOP10。

标准22分类：人文资讯、知识百科、健康养生、时尚潮流、美食餐饮、乐活生活、旅游出行、搞笑幽默、情感心理、体育娱乐、美容美体、文摘精选、财富理财、科技数码、创投商业、汽车交通、房产楼市、职场发展、教育考试、学术研究、企业品牌、总排名。

分类泛化映射规则详见 references/category-mapping.md。

高级使用

标准执行流程

1. 用户意图识别：智能体识别总榜请求/领域查询/模糊输入
2. 获取爆文数据：调用 scripts/fetch_hot_articles.py 脚本（必须调用，禁止自行生成）
3. 爆款规律分析：基于实际文章数据进行四维度分析
4. 询问订阅：主动询问用户是否需要订阅特定领域
5. 生成HTML页面：调用 scripts/generate_hot_html.py 生成可视化报告
6. 处理用户订阅选择：根据用户回复执行订阅逻辑

脚本参数说明

python scripts/fetch_hot_articles.py --type "分类名称" --start_date YYYY-MM-DD --end_date YYYY-MM-DD --mode preview --limit 10 --source "公众号10w+阅读文章推荐"

参数	说明	示例
--type	标准分类名称，默认"总排名"	--type "科技数码"
--start_date	开始日期（必传），YYYY-MM-DD	--start_date 2026-05-13
--end_date	结束日期（必传），YYYY-MM-DD	--end_date 2026-05-14
--source	数据源（固定值）	--source "公众号10w+阅读文章推荐"
--mode	输出模式：preview(前10条) / full(全部)	--mode preview
--limit	预览模式下显示数量	--limit 10
--temp_file	临时数据文件路径	--temp_file temp_articles.json

时间参数计算规则（重要）

数据更新时间：每天 18:30 同步前一日数据。

时间判断逻辑：智能体必须根据当前时间自动计算正确的查询日期。

当前时间	用户询问	实际查询区间	原因
< 18:30	今日文章	T-2 ~ T-1	昨天数据未更新，查前天区间
>= 18:30	今日文章	T-1 ~ T	昨天数据已更新，查昨天区间
< 18:30	昨天文章	T-2 ~ T-1	昨天数据未更新，查前天区间
>= 18:30	昨天文章	T-1 ~ T	昨天数据已更新

默认时间规则：用户提到"最近"、"最新"等无明确时间说法时，默认查询过去7天。

订阅推送时间参数：订阅推送（每天19:30）查询昨天（T-1）的数据。

典型场景示例（假设今天是2026-05-14）：

用户询问	当前时间	实际查询区间	原因
今日文章	11:19	start_date=2026-05-12, end_date=2026-05-13	昨天数据未更新，查前天区间
今日文章	19:30	start_date=2026-05-13, end_date=2026-05-14	昨天数据已更新，查昨天区间
昨天文章	11:19	start_date=2026-05-12, end_date=2026-05-13	昨天数据未更新，但前天数据已更新
昨天文章	19:30	start_date=2026-05-13, end_date=2026-05-14	昨天数据已更新

时间不一致提示规则

只要用户询问的时间和实际查询的时间不一致，就需要提示：

• 用户询问"今天的数据"，实际查询昨天：「非常抱歉🙏，今天的数据要明天才会更新，我将为您查询昨天的xx月xx日10W+文章。」
• 用户询问"昨天数据"，实际查询前天：「非常抱歉🙏，昨天的数据还未更新，我将为您查询前天的xx月xx日10W+文章。」
• 用户询问时间早于回溯日期：「非常抱歉🙏，目前最多支持回溯过去30天，我将为您查询最接近您需求的时间范围~」

分页展示策略

• 首次展示：--mode preview --limit 10，展示前10条
• 用户要求拓展：--mode full，展示所有数据
• 数据不超过10条：直接展示所有，无需询问
• 超过10条时底部提示："还有X条数据未展示，是否需要全部展示？"

文章数量较少提示规则

当某赛道某日10w+文章少于10篇时，提示：「💡 xx日xx赛道10w+文章较少，您可以拓展过去30天或者看看综合10w+文章~」

输出格式

脚本输出按以下顺序：数据说明 → 文章概览表格 → 文章详情 → 统计信息。

文章概览表格：

| 序号 | 标题 | 作者 | 阅读数 |
|------|------|------|--------|
| 1 | [标题](文章链接) | [作者名称](公众号名片链接) | 5w+ |

文章详情格式：

**序号、[标题](文章链接)**
📄 作者：[作者名称](公众号名片链接)
👀 阅读数：阅读数
⏰ 发布时间：发布时间
🔍 内容分析：基于四维度规则的分析内容
---

四维度内容分析规则

每篇文章必须从以下四个维度进行分析：

• 内容概述：简明扼要地概括文章核心内容
• 热点利用：分析文章借用了哪些热点话题或趋势
• 传播作用：阐述内容起到的作用（满足用户需求、引发情感共鸣、提供实用价值）
• 达成效果：说明内容达到的效果（提升品牌认知、完成用户转化、促进信息传播）

인기 콘텐츠 패턴 분석

전체 순위 데이터를 모두 표시한 후 실행하며, 실제 기사 데이터를 바탕으로 다음 네 가지 측면을 분석합니다.

• 제목 특징：제목의 공통점과 돋보이는 점을 정리합니다.
• 콘텐츠 주제：주제 유형과 확산 가치를 분석합니다.
• 게시 시간：게시 시간대의 패턴을 분석합니다.
• 공식 계정 특징：계정 유형과 콘텐츠 포지셔닝 특징을 분석합니다.

HTML 페이지 생성

python scripts/generate_hot_html.py --temp_file temp_articles.json --output "热门文章_榜单.html" --display_count 10

매개변수	설명
--temp_file	임시 JSON 파일 경로（기본값：temp_articles.json）
--output	출력 파일 경로
--display_count	표시할 기사 수입니다. 대화에서 표시한 수와 일치해야 합니다.

HTML 시각 디자인 규격：

• 기본 색상：rgb(0, 179, 84)（위챗 그린）
• 보조 색상：#0088ff（조회 수, 사용자 이름）
• 순위 1~3위는 🥇🥈🥉를 사용하고, 4위부터는 숫자를 사용합니다.
• 사용자 이름을 클릭하면 공식 계정 명함으로 이동할 수 있습니다（https://open.weixin.qq.com/qr/code?username={accountId}）
• PDF 내보내기：단일 페이지에 맞춤 모드, pagebreak: { mode: 'none' }

구독 서비스

패턴 분석 후 사용자에게 구독이 필요한지 먼저 물어봅니다.

📬 订阅服务

是否需要订阅具体赛道的账号表现？我们支持：
人文资讯、知识百科、健康养生、时尚潮流、美食餐饮、乐活生活、旅游出行、搞笑幽默、情感心理、体育娱乐、美容美体、文摘精选、财富理财、科技数码、创投商业、汽车交通、房产楼市、职场发展、教育考试、学术研究、企业品牌、总排名

订阅推送 - 每天19点30分推送最新10w+公众号爆文
暂不需要 - 仅本次查询

명령어 빠른 참조

상황	명령 예시
전체 순위 미리 보기	python scripts/fetch_hot_articles.py --type "总排名" --start_date 2026-05-12 --end_date 2026-05-13 --mode preview --limit 10
전체 순위 전체 보기	python scripts/fetch_hot_articles.py --type "总排名" --start_date 2026-05-12 --end_date 2026-05-13 --mode full
분야별 조회	python scripts/fetch_hot_articles.py --type "科技数码" --start_date 2026-05-13 --end_date 2026-05-14 --mode preview --limit 10
HTML 생성	python scripts/generate_hot_html.py --temp_file temp_articles.json --output "榜单.html" --display_count 10

5. 사용 사례

사례 1：공식 계정 운영자의 글쓰기 아이디어 얻기

역할：공식 계정 편집자/운영자
요구 사항：매일 아침 전날 조회 수 10만 회 이상인 인기 콘텐츠를 살펴보고, 인기 주제와 제목 작성 패턴을 추출합니다.
사용 방법：「오늘의 인기 콘텐츠」를 입력해 전체 분야 TOP50과 인기 콘텐츠 패턴 분석을 확인합니다.
기대 효과：당일 인기 콘텐츠의 흐름을 빠르게 파악하고, 재사용할 수 있는 제목 및 주제 선정 방법론을 얻습니다.

사례 2：특정 분야 콘텐츠 심층 탐구

역할：특정 분야 콘텐츠 크리에이터（예：건강 관리, 과학 기술 및 디지털 제품）
요구 사항：자신의 분야에서 인기 콘텐츠를 지속적으로 추적하고, 동종 업계의 콘텐츠 전략을 파악합니다.
사용 방법：특정 분야 TOP50을 조회하고 인기 콘텐츠 패턴을 분석한 다음, 매일 발송을 구독합니다.
기대 효과：같은 분야의 선도적인 콘텐츠를 정확하게 벤치마킹해 자체 콘텐츠의 경쟁력을 높입니다.

사례 3：브랜드 마케팅 콘텐츠 기획

역할：브랜드 마케팅 기획자
요구 사항：공식 계정 인기 콘텐츠의 확산 패턴을 연구해 브랜드 콘텐츠 제작의 참고 자료로 활용합니다.
사용 방법：여러 분야의 인기 콘텐츠 순위를 조회하고 제목 특징 및 확산 효과를 분석합니다.
기대 효과：공식 계정 콘텐츠 확산의 비결을 파악하고 효과적인 브랜드 콘텐츠 전략을 수립합니다.

사례 4：1인 미디어 창업 방향 조사

역할：1인 미디어 창업자
요구 사항：분야별 공식 계정의 트래픽 분포와 인기 콘텐츠 특징을 파악해 적절한 진입 분야를 선택합니다.
사용 방법：여러 분야의 최근 7일 데이터를 연속으로 조회하고, 각 분야의 인기 콘텐츠 수와 품질을 비교합니다.
기대 효과：데이터를 바탕으로 분야를 선택하고, 계정 개설 단계부터 올바른 방향으로 나아갑니다.

6. 프로젝트 아키텍처

디렉터리 구조

wechat-10w-hot/
├── SKILL.md                       # 技能描述文件
├── scripts/
│   ├── fetch_hot_articles.py      # 爆文数据获取脚本
│   └── generate_hot_html.py       # HTML页面生成脚本
└── references/
    ├── api-spec.md                # API接口规范
    └── category-mapping.md        # 分类泛化映射规则

기술 스택

구성 요소	기술	설명
스크립트 언어	Python 3	표준 라이브러리（urllib.request）를 사용합니다.
데이터 인터페이스	Redfox API (GET)	https://redfox.hk/story/api/cozeSkill/getWxDataByCategoryAndTime
인증 방식	X-API-KEY	요청 헤더 인증
보고서 템플릿	HTML/CSS/JS	위챗 그린 테마 스타일
PDF 내보내기	html2pdf.js	단일 페이지에 맞춤 모드

핵심 모듈 설명

모듈	기능
fetch_hot_articles.py	분류와 기간에 따라 조회 수 10만 회 이상인 인기 기사 데이터를 가져와 요약 표와 상세 목록을 생성하고, 임시 JSON 파일에 저장합니다.
generate_hot_html.py	임시 JSON 파일에서 데이터를 읽어 공식 계정 스타일의 HTML 페이지를 생성하고 PDF 내보내기를 지원합니다.
api-spec.md	API 인터페이스 규격 참고 자료
category-mapping.md	분류 일반화 매핑 규칙 참고 자료

리소스 색인

• 스크립트: scripts/fetch_hot_articles.py 참조（용도: 분류와 기간에 따라 조회 수 10만 회 이상인 인기 기사 데이터 가져오기）
• 스크립트: scripts/generate_hot_html.py 참조（용도: 임시 JSON 파일에서 데이터를 읽어 공식 계정 스타일의 HTML 페이지 생성）
• 참고 자료: references/api-spec.md 참조（읽을 시점: API 인터페이스 규격을 확인할 때）
• 참고 자료: references/category-mapping.md 참조（읽을 시점: 분류 일반화 매핑 규칙을 확인할 때）

7. 자주 묻는 질문

설치 관련

Q: 스크립트 실행 시 "REDFOX_API_KEY not found" 오류가 발생합니다.
A: 환경 변수 REDFOX_API_KEY가 설정되어 있는지 확인하세요. 설정 방법은 위의 인증 섹션을 참조하세요.

Q: Python 의존성을 설치해야 하나요?
A: 설치할 필요가 없습니다. 스크립트는 Python 표준 라이브러리（urllib.request）를 사용하므로 추가 설치가 필요하지 않습니다.

사용 관련

Q: "오늘"의 기사를 조회했는데 왜 어제 기사가 반환되나요?
A: 데이터는 매일 18:30에 전날 데이터를 동기화합니다. 18:30 이후에 조회하면 전날 데이터를 가져올 수 있으며, 18:30 이전에 조회할 때는 그 전날 데이터를 사용해야 합니다. 시스템이 자동으로 날짜를 계산해 안내합니다.

Q: 전체 50개 데이터를 어떻게 확인하나요?
A: 처음에 상위 10개를 미리 본 뒤 「모두 표시」 또는 「예」라고 답하면 시스템에서 --mode full을 사용해 전체 50개를 표시합니다.

Q: 사용자가 입력한 분야 키워드는 어떻게 매칭되나요?
A: 시스템은 분류 일반화 매핑 규칙을 통해 자동으로 매칭합니다. 예를 들어 "AI" → "과학 기술 및 디지털 제품", "다이어트" → "건강 관리"입니다. 자세한 내용은 references/category-mapping.md를 참조하세요.

Q: HTML의 기사 수가 대화에서 표시한 수와 일치하지 않습니다.
A: --display_count 매개변수로 HTML 표시 수를 제어하며, 대화에서 실제로 표시한 수와 일치해야 합니다.

문제 해결

Q: 조회 결과가 비어 있습니다.
A: 가능한 원인：1) 해당 분야에 조회 기간 내 조회 수 10만 회 이상인 기사가 없습니다. 2) API Key가 유효하지 않거나 만료되었습니다. 시스템에서 종합 순위나 다른 분류를 확인하도록 안내합니다.

Q: PDF를 내보낼 때 페이지가 나뉩니다.
A: HTML 생성 시 pagebreak: { mode: 'none' } 및 page-break-inside: avoid가 이미 설정되어 있습니다. 그래도 페이지가 나뉜다면 html2pdf.js 설정을 확인하세요.

Q: 스크립트 출력이 잘립니다.
A: 처음에는 preview 모드를 사용해 10개만 표시하고 출력이 잘리지 않도록 하세요. 사용자가 요청하면 full 모드로 전체를 표시합니다.