中文播客雷达

Discover, compare, and curate trending Chinese podcasts or episodes from 中文播客榜. Use for hot or recent show discovery, creator benchmarking, curation lists, c...

Security Scan

The skill's code, runtime instructions, and install steps align with its stated purpose (discovering and enriching Chinese podcast rankings); it requests no credentials and its enrichment actions are capped and reasonable.

Purpose & Capability

Name/description (Chinese podcast discovery from 中文播客榜) match the actual behavior: fetching ranking endpoints on xyzrank.com and optional Xiaoyuzhou page enrichment. Required runtime (Python) and the included scripts are proportional to the stated purpose.

Instruction Scope

SKILL.md instructs the agent to run the included fetch and optional enrichment scripts, to prefer ranking/title signals first, and to only perform limited Xiaoyuzhou enrichment. The instructions do not ask the agent to read local secrets, system files, or send data to unrelated external endpoints.

Install Mechanism

Install spec is a single Homebrew formula (python). This is a standard, low-risk mechanism and appropriate for running the provided Python scripts.

Credentials

The skill declares no environment variables, no credentials, and no sensitive config paths. The scripts make only outbound HTTP(S) requests to the ranking site (xyzrank.com) and Xiaoyuzhou (xiaoyuzhoufm.com), which aligns with the skill's function.

Persistence & Privilege

The skill is not always-enabled and makes no requests to modify other skills or system-wide agent settings. Autonomous invocation is allowed (platform default) but not combined with elevated privileges or broad credential access.

Assessment

This skill appears to do what it claims: it fetches ranking lists from xyzrank.com and (optionally, in small batches) enriches Xiaoyuzhou pages by parsing __NEXT_DATA__. It requests no credentials and uses only Python. Before installing, consider: (1) ensure you trust the referenced external sites (xyzrank.com / xiaoyuzhoufm.com) because the skill will make outbound requests to them; (2) review network/privacy policies if you plan to run the enrichment at scale (the enrichment script caps requests to 20 and adds delays); and (3) if your environment lacks Homebrew or you prefer not to install Python via brew, ensure a trusted Python binary is available on PATH since the scripts expect python3/python.

Podcast Radar CN

Use this skill when the user wants to discover, compare, or curate Chinese podcasts or podcast episodes based on current ranking data.

This skill is strongest at:

• listener discovery
• creator benchmarking
• curation and distribution research

It is not a general web scraping skill. Its default posture is ranking-first and title-first.

Skill Root Rule

Treat the directory containing this SKILL.md as the skill root.

• In OpenClaw, prefer {baseDir} when calling files inside this skill.
• In other hosts or manual installs, use the same paths relative to the skill root, for example scripts/fetch_xyz_rank.py.
• Examples below use python3; if the host only exposes python, swap the binary name.

Quick Start

Choose one of the four ranking lists:

• hot-episodes
• hot-podcasts
• new-podcasts
• new-episodes

Fetch a candidate set first:

python3 {baseDir}/scripts/fetch_xyz_rank.py --list hot-episodes --limit 20

Filter by genre, freshness, or query when the user already has a direction:

python3 {baseDir}/scripts/fetch_xyz_rank.py \
  --list new-episodes \
  --limit 12 \
  --genre 社会与文化 \
  --freshness-days-max 30

If and only if you truly need extra context for a small set of candidates, enrich a few Xiaoyuzhou URLs:

python3 {baseDir}/scripts/enrich_xiaoyuzhou.py \
  --episode-url https://www.xiaoyuzhoufm.com/episode/69bf524c2d318777c9169361

Workflow

1. Classify the request as one of:
   • listener discovery
   • creator benchmarking
   • curation/distribution research
2. Interpret the user's wording before choosing the list:
   • if the user says 热门播客, 最近播客, 值得听的播客, or similar casual Chinese phrasing, default to episode-level results
   • if the user explicitly asks for 播客频道, 播客栏目, 节目主页, show-level, 频道级, or wants a creator benchmark list, use podcast-level results
3. Pick the most relevant ranking list.
   • default listener-discovery wording usually maps to hot-episodes or new-episodes
   • explicit channel / show / benchmark wording usually maps to hot-podcasts or new-podcasts
4. Fetch enough candidates to support filtering; do not stop at the first 5 unless the user asked for 5.
5. Use ranking fields and title signals first.
6. Only if the answer would otherwise be weak, enrich a small set of Xiaoyuzhou pages.
7. Return a task-shaped result, not raw JSON.

Query Interpretation Rule

In Chinese product usage, users often say 播客 when they really mean 最近值得点开的内容.

Default behavior:

• 热门播客
• 最近热门播客
• 最近值得听的播客
• 推荐几个热门播客

Treat these as requests for episode-level recommendations unless the wording clearly asks for show/channel-level objects.

Switch to podcast-level results only when the user explicitly asks for things like:

• 播客频道
• 播客栏目
• 播客节目主页
• 频道级榜单
• 栏目级榜单
• show-level benchmark or channel list

When in doubt:

• listener-oriented wording -> episode-first
• benchmark / channel / host / show-portfolio wording -> podcast-first

Title-First Rule

Before reaching for Xiaoyuzhou pages, inspect:

• title
• podcastName / name
• primaryGenreName
• rank
• playCount / avgPlayCount
• commentCount / avgCommentCount
• freshness fields

The fetch script also extracts title signals such as:

• episode markers like S8E9, EP03, Vol132
• guest hints like A×B, 对话某某
• format hints like 对谈, 访谈, 复盘, 盘点
• topic keywords inferred from the title

If those signals are enough, do not enrich.

Read references/title-signals.md when you need examples or interpretation guidance.

Xiaoyuzhou Enrichment Rule

Xiaoyuzhou enrichment is allowed only for narrow, necessary follow-up work.

Hard rules:

• never bulk-enrich by default
• never enrich just to complete every field
• never enrich more than 20 URLs in one run
• if a request implies short-window bulk access, refuse enrichment and stay at ranking level

Use enrichment when:

• a short list needs better recommendation reasons
• you need the real Xiaoyuzhou pid from an episode page
• you need a podcast brief or episode description for a handful of finalists

The enrichment script enforces the cap for you.

Output Modes

Use one of these result shapes:

• Listener Discovery: what episode is worth hearing now, and why
• Creator Benchmarking: which shows are worth studying or comparing against
• Curation and Distribution: which shows or episodes are worth packaging, recommending, or developing into downstream ideas

Read references/output-modes.md when you need concrete formatting guidance.

Data Caveats

• 中文播客榜 is weekly, not minute-by-minute real time
• the data is not full-platform coverage
• primaryGenreName is often missing on new lists
• openRate / avgOpenRate can exceed 1; treat these as internal ranking signals, not literal rates

Read references/api.md when you need field notes or endpoint details.

Scripts

• scripts/fetch_xyz_rank.py Purpose: fetch and normalize ranking data, with basic filters and title-signal extraction
• scripts/enrich_xiaoyuzhou.py Purpose: enrich a small set of Xiaoyuzhou pages with brief/description/shownotes context, under a strict cap

What To Avoid

• dumping raw fields without synthesis
• pretending the ranking is a real-time universal truth
• using Xiaoyuzhou enrichment for large-page traversal
• over-explaining openRate as if it were a clean probability