gzh-astock-top

A股公众号大V

1. 简介

A股公众号大V工具，输入日期获取A股领域30个公众号大V的账号数据与最新文章数据。帮助用户快速掌握A股领域头部公众号的运营表现和最新内容动向。

API 请求均携带 A股公众号大V-GitHub 标识。使用环境变量 REDFOX_API_KEY 鉴权。

---

2. 功能特性

• 固定账号池：覆盖19个个人大V + 30个官媒/机构，共49个A股头部公众号
• 账号数据：获取每个账号的平均阅读数、红狐指数、账号描述等核心指标
• 当日文章：获取每个账号在指定日期发布的最新文章，含标题、链接、阅读数、点赞、评论等互动数据
• 双分类模式：官媒/机构 + 个人大V 两类分开展示，各类最多30个
• AI概要：基于文章标题自动生成1句话内容概要
• 标题跳转：文章标题渲染为超链接，点击可跳转原文
• 订阅推送：按序号订阅账号，每日只查订阅列表，减少API调用

---

3. 鉴权配置

获取 API Key

请前往 红狐hub 获取 API Key。

配置方式

方式	命令
环境变量（推荐）	export REDFOX_API_KEY=ak_你的密钥
命令行参数	--api-key ak_你的密钥
配置文件	echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json

---

4. 使用指南

基础使用

Step 1 — 确认日期：从用户输入中提取查询日期。未指定日期时默认为今天。

Step 2 — 调用脚本：

python3 "$SKILL_PATH/scripts/fetch_astock_accounts.py" --date <日期> --dual-category

• 指定日期：--date 2026-06-15
• 默认今天：python3 "$SKILL_PATH/scripts/fetch_astock_accounts.py" --dual-category
• 仅查个人大V（不分类）：python3 "$SKILL_PATH/scripts/fetch_astock_accounts.py" --date 2026-06-15

⚠️ 防重复调用规则（强制）：

• ❌ 禁止先用 head/tail 等方式"试运行"脚本
• ❌ 禁止在同一次查询中对同一参数多次调用脚本
• ✅ 每次查询只执行一次脚本命令，直接读取完整输出

Step 3 — 查看结果：脚本返回结构化 JSON 数据，按本指南规定的展示策略输出结果。

---

数据展示策略

⚠️ 强制输出规则：

• ✅ 必须严格按照本步骤规定的格式输出
• ❌ 禁止在输出前添加任何分析或解读
• ❌ 禁止自作主张给建议或方案
• ✅ 直接读取脚本返回的 JSON 数据，按照对应策略输出

前置说明（展示数据前必须告知用户）

• 数据说明：账号数据来源于红狐API收录的公众号信息，文章数据为账号在指定日期发布的作品（由服务端直接筛选）。互动数据截止为入库时间，非实时数据。
• 排序说明：账号按平均阅读数降序排列

默认查询行为

• 用户未指定日期时，默认查询当天（如 2026-06-17）
• 默认使用 --dual-category --count 120 模式，同时输出官媒和大V两类
• 若用户仅说"看看A股大V"或"查查今天的"，直接运行双分类查询

数据充足（accounts ≥ 10）

展示内容：

1. 时间范围说明：告知用户查询的日期
2. 账号与文章数据表格（含AI概要列）

Markdown表格格式：

📅 查询日期：2026-06-17

【官媒/机构】X 个账号

#	公众号	平均阅读	红狐指数	最新文章	AI概要	阅读	点赞	发布
1	金融时报	3.2w	937.1	重磅会议明天见	聚焦即将召开的重要经济会议，预判政策方向	8.3w	109	06-16

【个人大V】X 个账号

#	公众号	平均阅读	红狐指数	最新文章	AI概要	阅读	点赞	发布
1	大红好运哥	7.1w	862.0	太强了！！！	A股强势突破，博主情绪极度乐观	7.2w	1939	06-15

格式规范：

• 第一列为序号，从1开始递增
• 平均阅读数 ≥ 10000 时显示为 x.xw 格式
• 最新文章标题：必须渲染为超链接，[标题](workUrl)。标题超过15字截断加 ...。无 workUrl 时仅显示纯文本
• AI概要：基于文章标题，用1句话（≤30字）概括文章核心内容/观点，由AI在展示时推断生成，不依赖API
• 发布时间仅显示月-日

数据不足（accounts < 10）

展示内容：

1. 时间范围说明
2. 提示信息："💡 当前日期仅找到 X 个A股领域大V账号，数据可能不完整"
3. 正常数据表格（含AI概要列）

无数据（accounts = 0）

🔍 抱歉，当前日期未找到A股领域的公众号大V数据，请尝试更换日期或稍后重试。

输出规则：

• ✅ 必须直接输出上述格式内容
• ❌ 禁止添加额外的分析或建议
• ❌ 禁止解释为什么没有数据

---

5. 参数说明

参数	说明	默认值
--date	查询日期 YYYY-MM-DD	今天
--api-key	指定 API Key	—
--dual-category	分类模式：官媒/机构 + 个人大V 两类分别展示	—

---

5.5 订阅管理功能

功能说明

支持从榜单中按序号订阅官媒或大V账号，每次调用订阅推送时只查询已订阅账号的最新文章，减少不必要的API调用。

数据更新时间：红狐平台每日 07:00 更新昨日爆款文章数据，建议 07:30 之后运行推送查询。

工作流程

Step 1: 运行榜单查询（--dual-category）→ 展示官媒/大V榜单（含序号）
Step 2: 用户输入序号 → 调用 manage_subscriptions.py 写入订阅
Step 3: 每日调用 fetch_subscribed_updates.py → 查询订阅账号最新文章

Step 1: 展示榜单（AI触发）

当用户说"看看榜单并订阅"时：

python3 "$SKILL_PATH/scripts/fetch_astock_accounts.py" --date <日期> --dual-category

此命令同时将结果缓存至 cache/last_dual_result.json，供订阅时使用。

Step 2: 添加订阅（AI根据用户序号调用）

从官媒榜单订阅序号 1、3、5：

python3 "$SKILL_PATH/scripts/manage_subscriptions.py" --action add --category official --indexes 1,3,5 --from-cache

从大V榜单订阅序号 2、4：

python3 "$SKILL_PATH/scripts/manage_subscriptions.py" --action add --category kol --indexes 2,4 --from-cache

查看当前所有订阅：

python3 "$SKILL_PATH/scripts/manage_subscriptions.py" --action list

删除订阅（按账号名）：

python3 "$SKILL_PATH/scripts/manage_subscriptions.py" --action remove --names 央视财经,金融时报

清空某类订阅：

python3 "$SKILL_PATH/scripts/manage_subscriptions.py" --action clear --category official

Step 3: 每日推送（AI触发）

当用户说"看订阅账号更新"或"推送今日更新"时：

# 全部订阅
python3 "$SKILL_PATH/scripts/fetch_subscribed_updates.py"

# 只查官媒
python3 "$SKILL_PATH/scripts/fetch_subscribed_updates.py" --category official

# 只查大V
python3 "$SKILL_PATH/scripts/fetch_subscribed_updates.py" --category kol

订阅推送输出展示规范

脚本返回JSON，AI按以下格式展示：

数据说明：订阅账号最新文章数据，近7天内发布。互动数据截止入库时间，非实时。

📅 日期：2026-06-17 · 数据更新时间：每日 07:00

【官媒/机构订阅】X 个账号

#	公众号	最新文章	AI概要	阅读	点赞	发布
1	央视财经	利好来袭！9部门重磅发布	九部门联合发布重磅利好政策	8.3w	464	06-16

【个人大V订阅】X 个账号

（同格式）

注：文章标题必须渲染为超链接 [标题](workUrl)；AI概要由AI基于标题推断生成；无文章数据时显示 -。

目录结构（更新）

gzh-astock-top/
├── SKILL.md
├── subscriptions.json          # 订阅配置（官媒/大V账号ID列表）
├── cache/
│   └── last_dual_result.json   # 最近一次双分类榜单缓存
├── scripts/
│   ├── fetch_astock_accounts.py      # 榜单查询（--dual-category 时自动缓存）
│   ├── manage_subscriptions.py       # 订阅管理（添加/删除/查看）
│   └── fetch_subscribed_updates.py   # 订阅推送（查询已订阅账号最新文章）
└── references/
    └── api_guide.md

---

6. 项目架构

目录结构

gzh-astock-top/
├── SKILL.md                          # Skill 定义与使用文档（本文件）
├── scripts/
│   └── fetch_astock_accounts.py      # 核心脚本：获取A股大V账号及文章数据
└── references/
    └── api_guide.md                  # API接口说明文档

技術スタック

コンポーネント	技術	説明
実行環境	Python 3.13+	標準ライブラリのみで動作し、サードパーティ依存関係はありません
標準ライブラリ	urllib.request, json, os, sys, argparse, datetime	HTTP リクエスト、JSON 処理、引数の解析、日付計算
データインターフェース	红狐 API (Redfox) — dailyPublish インターフェース	REDFOX_API_KEY による認証で、1 回の呼び出しですべてのデータを取得します
出力形式	JSON (stdout)	AI が解析した後、Markdown テーブルで表示するために使用します

コアモジュールの説明

モジュール	パス	機能
データ取得スクリプト	scripts/fetch_astock_accounts.py	dailyPublish インターフェースを呼び出し、固定された 49 アカウントの当日の記事データを 1 回で取得します
API リファレンスドキュメント	references/api_guide.md	インターフェースの URL、パラメーター、戻り値のフィールドについて詳しく説明します

リソースインデックス

• コアスクリプト：scripts/fetch_astock_accounts.py — dailyPublish インターフェースを 1 回呼び出し、A 株の人気アカウントのデータを取得します。パラメーター：--date（任意）、--dual-category（任意）、--api-key（任意）
• リファレンスドキュメント：references/api_guide.md — インターフェースのデータ形式やフィールドの説明を確認する場合に読みます

---

7. よくある質問

Q: 当日の記事がないアカウントがあるのはなぜですか？ A: dailyPublish インターフェースは指定した日付で絞り込むため、当日に記事を公開していないアカウントは返されません。そのため、日によって結果に含まれるアカウント数は異なります。

Q: アカウント数が少ない場合はどうすればよいですか？ A: 固定された 49 アカウントのうち、当日に記事を公開したアカウントのみが結果に表示されます。数が少ない場合は、当日の公開頻度が低い可能性がありますが、正常な動作です。

Q: データの更新頻度はどのくらいですか？ A: 红狐プラットフォームは毎日 07:00 に前日分のデータを更新します。前日分のデータは 07:30 以降に照会することをおすすめします。

Q: スクリプトでエラーが発生した場合はどうすればよいですか？ A: よくある原因：(1) REDFOX_API_KEY が設定されていない、または有効期限が切れている、(2) Python のバージョンが 3.13 未満、(3) ネットワークの問題。順番に確認してください。