Podcast Feed Manager Skill

Use this skill to manage huisheng.fm Podcast Feeds from an agent sandbox. The skill calls the user-scoped REST API directly instead of calling the MCP endpoint.

Entrypoint

Resolve the executable relative to the installed skill root:

./scripts/run_huisheng.sh --help

./scripts/run_huisheng.sh is the only executable script in this skill package. It is self-contained and calls the fixed REST API directly with curl. Do not hardcode /mnt/skills/\x3Cid> or ~/.codex/... paths.

Before making API changes, run:

./scripts/run_huisheng.sh doctor

Use doctor before diagnosing API failures. hasCurl: false means the sandbox cannot run HTTP requests; hasToken: false means HUISHENG_API_TOKEN is not available in the command environment.

When the agent runtime executes commands in a separate sandbox working directory, copy scripts/run_huisheng.sh into that sandbox and run it from the copied location. This script has no sibling file dependencies.

Authentication

The sandbox must provide this environment variable:

HUISHENG_API_TOKEN

Every API request sends:

Authorization: Bearer \x3CHUISHENG_API_TOKEN>

Never print the full token in user-facing output.

Fixed API

The API URL is fixed and does not need user configuration:

https://huisheng.fm/api

Common Commands

List feeds:

./scripts/run_huisheng.sh list-feeds

Create a feed:

./scripts/run_huisheng.sh create-feed --json '{"title":"Daily Brief","siteUrl":"https://example.com"}'

List episodes:

./scripts/run_huisheng.sh list-episodes \x3Cfeed-key>

Create an episode:

./scripts/run_huisheng.sh create-episode \x3Cfeed-key> --json-file ./episode-payload.json

Operating Rules

• Require HUISHENG_API_TOKEN; do not invent fallback token names.
• Do not ask the user for an API URL; use https://huisheng.fm/api.
• Treat all operations as user-scoped. A token can only access Podcast Feeds owned by the authenticated dashboard user.
• Keep JSON arguments as structured JSON. Use --json-file for long episode payloads.
• If a feed is not found, list feeds first instead of assuming the feed is global.

Reference

Read references/api.md only when you need the endpoint list.