podcast-radar-cn

中文播客数据工具包。用于播客发现、竞品分析、订阅追踪、创作机会评估。 触发场景： · 发现热门/新锐播客或单集 · 分析某个分类的竞争格局 · 追踪播客订阅量变化趋势 · 评估播客创作方向的机会 · 生成完整的播客创作机会报告 · 对标学习头部播客案例 · 话题热度趋势监控

Security Scan

The package and its runtime instructions are coherent with a Chinese podcast discovery/analysis tool — the scripts only call the documented ranking/trend APIs and scrape xiaoyuzhou pages, require no extra credentials, and have no surprising install or persistence behavior.

Purpose & Capability

Name/description describe discovery, tracking and reporting; included scripts (fetch_xyz_rank.py, analyze_genre.py, generate_report.py, batch_track.py, enrich_xiaoyuzhou.py, etc.) directly implement those features and use the documented data sources (xyzrank, api.xyzrank.top, xiaoyuzhoufm). No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md and example commands consistently instruct running the included Python scripts which fetch API endpoints and (optionally, in small batches) scrape xiaoyuzhou pages for subscription/play counts. Scripts read/write local JSON files for tracking — this matches the stated workflows. There are no instructions to read arbitrary system files, use unrelated environment variables, or send data to unexpected external endpoints.

Install Mechanism

There is no install spec; the package is instruction-plus-scripts and relies on Python standard library only (authors claim zero pip deps). No remote downloads or archive extraction are performed by an installer.

Credentials

The skill declares no required environment variables or credentials. The scripts access only public HTTP(S) endpoints (xyzrank, api.xyzrank.top, xiaoyuzhoufm) and local JSON files inside the scripts directory, which is appropriate for the described functionality.

Persistence & Privilege

The skill does not request always:true, does not modify other skills, and only persists its own tracking/history to JSON files in the package directory. Autonomous model invocation is allowed by default (normal), but this skill's code does not grant it extra system privileges.

Assessment

This package appears to do what it says: call xyzrank APIs, query api.xyzrank.top, and optionally scrape xiaoyuzhoufm pages for subscription/play counts, storing results in local JSON files. Before installing, consider: (1) scraping xiaoyuzhou is rate-sensitive—keep the default limits (max 20 per enrich) and respect the target site's terms; (2) scripts spawn subprocesses to run other bundled scripts and will create/modify JSON files in the skill directory (episode_history.json, subscription_data.json, tracking_data.json, etc.); (3) verify the external endpoints (xyzrank.com and api.xyzrank.top) are services you trust and that usage complies with their API/robots policies. If you need stronger guarantees, inspect the remaining (truncated) files locally for any network or file operations not covered here.

中文播客数据工具包——发现 · 分析 · 追踪 · 报告，覆盖创作者和听众两类核心需求。

核心能力矩阵

能力	数据来源	典型场景
榜单发现	xyzrank.com API	发现热门/新锐播客和单集
趋势分析	api.xyzrank.top	获取播客历史订阅增长曲线
小宇宙详情	小宇宙页面爬取	获取订阅量、播放量、评论区
订阅追踪	batch_track + 本地 JSON	监控播客订阅量周变化
竞争分析	analyze_genre.py	评估某分类的竞争强度
机会报告	generate_report.py	生成完整创作机会报告
爆款追踪	track_episodes.py	追踪特定话题/嘉宾的单集表现

数据来源

榜单 API (xyzrank.com)

GET https://xyzrank.com/api/episodes      # 热门单集
GET https://xyzrank.com/api/podcasts      # 热门播客
GET https://xyzrank.com/api/new-episodes  # 新锐单集
GET https://xyzrank.com/api/new-podcasts # 新锐播客

小宇宙详情页

# 播客页
https://www.xiaoyuzhoufm.com/podcast/{pid}
  → 订阅量 subscriptionCount

# 单集页
https://www.xiaoyuzhoufm.com/episode/{eid}
  → 播放量、评论数、收藏数、点赞数、节目介绍

趋势 API (api.xyzrank.top) — 已接入 ✅

官方历史趋势数据，覆盖 9000+ 播客的完整订阅增长曲线。

端点说明

GET https://api.xyzrank.top/v1/stats
# 返回所有播客最新订阅统计（含日/月变化）
# 字段: podcast_id, title, latest_count, daily_change, monthly_change

GET https://api.xyzrank.top/v1/metrics/{podcast_id}
# 返回单个播客的完整历史趋势（按日期排列）
# 字段: crawl_date, subscriber_count, status_code
# podcast_id 为小宇宙 24 位字符 ID

GET https://api.xyzrank.top/v1/podcast/{name}
# 按名称搜索播客，返回匹配列表
# 用于获取 podcast_id

快速查询示例

# 查询单个播客历史趋势（以罗永浩为例）
curl -s "https://api.xyzrank.top/v1/metrics/68981df29e7bcd326eb91d88" | python3 -m json.tool

# 查询所有播客最新统计
curl -s "https://api.xyzrank.top/v1/stats" | python3 -c "import json,sys;d=json.load(sys.stdin);[print(f'{p['title']}: {p['latest_count']:,}') for p in d['data'][:10]]"

# 按名称搜索播客获取 ID
curl -s "https://api.xyzrank.top/v1/podcast/纵横四海" | python3 -m json.tool

在脚本中使用

generate_report.py 和 analyze_genre.py 已自动集成趋势 API：

# 生成报告时自动查询趋势数据
python scripts/generate_report.py --custom-query "纵横四海"
# 输出包含: 当前订阅、总增长、增长率、数据点数量

# 分类分析时自动查询趋势数据
python scripts/analyze_genre.py --genre 科技
# 输出包含: Top 3 增长最快播客的订阅趋势

典型响应格式

// /v1/metrics/{podcast_id}
{
  "podcast_id": "68981df29e7bcd326eb91d88",
  "count": 115,
  "data": [
    {"crawl_date": "2026-04-07", "subscriber_count": 317963, "status_code": 200},
    {"crawl_date": "2026-01-24", "subscriber_count": 248242, "status_code": 200}
  ]
}

// /v1/stats
{
  "total": 9464,
  "limit": 50,
  "offset": 0,
  "data": [
    {
      "podcast_id": "625635587bfca4e73e990703",
      "title": "岩中花述",
      "latest_count": 3516964,
      "daily_change": 0,
      "monthly_change": 0
    }
  ]
}

分析框架

增长潜力评估

• 订阅增长率（月度/季度变化，基于 batch_track 历史数据）
• 新入局者数量（新锐榜分析）
• 内容稀缺度（现有数量 vs 需求）
• 趋势方向（热门 vs 新锐交叉）

竞争强度评估

• 头部集中度（Top 10 占比 vs 均值）
• 平均播放量差距
• 评论互动率（评论数 / 播放量）
• 更新频率（日更/周更/双周更/月更）

内容模式分析

• 时长分布：短（<30min）、中（30-60min）、长（>60min）
• 更新节奏：日更、周更、双周更、月更
• 内容形式：访谈、单口、对话、漫谈
• 标题模式：数字型、话题型、人物型、情绪型

场景与工作流

场景 1：播客/单集发现（基础）

# 发现热门单集（默认模式，用户说"热门播客"时触发）
python scripts/fetch_xyz_rank.py --list hot-episodes --limit 20

# 发现热门播客（用户明确要求频道/栏目级时触发）
python scripts/fetch_xyz_rank.py --list hot-podcasts --limit 20

# 新锐播客（发现新入场者）
python scripts/fetch_xyz_rank.py --list new-podcasts --limit 20

# 分类过滤
python scripts/fetch_xyz_rank.py --list hot-podcasts --genre 商业 --limit 20

# 关键词搜索
python scripts/fetch_xyz_rank.py --list hot-episodes --query "AI创业" --limit 20

# 按新鲜度过滤（30天内更新）
python scripts/fetch_xyz_rank.py --list new-episodes --freshness-days-max 30 --limit 20

# 按播放量下限过滤
python scripts/fetch_xyz_rank.py --list hot-episodes --min-play-count 50000 --limit 20

场景 2：竞品分析

# 分析某分类的竞争格局
python scripts/analyze_genre.py --genre 商业

# 对比多个分类
python scripts/analyze_genre.py --genre 科技 --compare-genres 商业 个人成长

场景 3：订阅追踪（需先初始化）

# 初始化：获取热门播客并抓取订阅量
python scripts/batch_track.py init --max 500

# 更新所有追踪播客的订阅量
python scripts/batch_track.py update

# 查看订阅趋势
python scripts/batch_track.py trends "纵横四海"

# 列出所有追踪的播客
python scripts/batch_track.py list

场景 4：创作机会报告

# 分析某分类的完整创作机会
python scripts/generate_report.py --genre 个人成长

# 自定义关键词分析
python scripts/generate_report.py --custom-query "AI创业"

# 完整报告输出包括：
#   · 领域概览（播客数量、新锐数量）
#   · 增长最快的播客（基于订阅追踪数据）
#   · 竞争格局（门槛、中位值、头部集中系数）
#   · 爆款单集模式（内容形式、时长分布）
#   · 推荐对标案例（Top 5 + 是否已追踪标记）
#   · 创作切入点建议

场景 5：小宇宙详情补充（慎用，最多 20 条）

# 补充单个播客详情
python scripts/enrich_xiaoyuzhou.py \
  --podcast-url https://www.xiaoyuzhoufm.com/podcast/625635587bfca4e73e990703

# 补充单集详情
python scripts/enrich_xiaoyuzhou.py \
  --episode-url https://www.xiaoyuzhoufm.com/episode/69bf524c2d318777c9169361

# 从榜单 JSON 批量补充（最多 20 条）
python scripts/fetch_xyz_rank.py --list hot-episodes --query "AI" --limit 20 | \
  python scripts/enrich_xiaoyuzhou.py --from-json -

场景 6：爆款单集追踪

# 追踪特定话题的爆款单集
python scripts/track_episodes.py --topic "AI" --limit 30

# 追踪特定嘉宾出现过的单集
python scripts/track_episodes.py --guest "张雪峰" --limit 20

# 导出为简报格式
python scripts/track_episodes.py --topic "注意力" --report

场景 7：话题热度趋势

# 监控话题在热门/新锐榜的出现频率变化
python scripts/topic_trends.py --topics "AI创业,副业,MBTI,注意力" --weeks 4

# 输出：各话题在热门榜 vs 新锐榜的占比趋势

Query 语义规则

中文用户的"播客"常指"最近值得点开的内容"，默认返回单集级结果。

用户说	默认映射	切换条件
热门播客、最近火什么	hot-episodes	明确说"频道"/"栏目"时→hot-podcasts
新播客、最近新出的	new-episodes	明确要求show-level时→new-podcasts
播客频道/栏目/榜单	hot-podcasts	—
对标学习/竞品	hot-podcasts	—

标题信号优先：先从标题、排名、播放量判断，标题信号充足时不 enrich。

Xiaoyuzhou Enrichment 规则

• ⚠️ 默认 不 enrich
• ⚠️ 最多 20 条/次
• ⚠️ 仅在榜单数据无法回答问题时使用

适用场景：

• 短列表需要更好的推荐理由
• 需要从单集页获取真实 PID
• 需要节目介绍/单集简介用于最终推荐

数据边界

• 榜单周更，非分钟级实时
• 覆盖主要中文播客平台（小宇宙为主）
• 部分历史数据可能不完整
• 区分"数据事实"和"分析推断"

脚本索引

脚本	功能	输入
fetch_xyz_rank.py	获取榜单数据 + 过滤 + 标题信号	list/genre/query
batch_track.py	批量订阅追踪（init/update/trends/list）	播客名
analyze_genre.py	分类竞争格局分析	--genre
generate_report.py	完整创作机会报告	--genre / --custom-query
track_episodes.py	爆款单集追踪	--topic / --guest
topic_trends.py	话题热度趋势监控	--topics
enrich_xiaoyuzhou.py	小宇宙页面详情补充	URL / JSON

API 速查卡

xyzrank.com 榜单 API

# 热门单集
https://xyzrank.com/api/episodes?limit=20

# 热门播客
https://xyzrank.com/api/podcasts?limit=20

# 新锐单集
https://xyzrank.com/api/new-episodes?limit=20

# 新锐播客
https://xyzrank.com/api/new-podcasts?limit=20

# 带过滤
https://xyzrank.com/api/episodes?query=AI&genre=科技&limit=20

api.xyzrank.top 趋势 API

# 所有播客最新统计
https://api.xyzrank.top/v1/stats

# 单个播客历史趋势（pid 为小宇宙 24 位 ID）
https://api.xyzrank.top/v1/metrics/{podcast_id}

# 按名称搜索播客
https://api.xyzrank.top/v1/podcast/{name}

小宇宙页面

# 播客页（获取订阅量）
https://www.xiaoyuzhoufm.com/podcast/{pid}

# 单集页（获取播放量、评论数）
https://www.xiaoyuzhoufm.com/episode/{eid}

参考文档

• references/title-signals.md — 标题信号解读
• references/output-modes.md — 输出格式指南
• references/api.md — API 字段说明