用途:该技能封装 Podchaser 的 GraphQL API,用于查询播客相关数据。当用户提到 Podchaser、podcast、播客搜索或询问播客信息时使用。
主要能力:支持搜索播客(podcasts)、搜索单集(episodes)、按 ID 获取播客或单集详情、获取某播客的单集列表、获取播客分类、按分类筛选播客、获取 Apple Podcasts 榜单排名、搜索创作者/主播(creators)与播客网络(networks),以及通过 /graphql/cost 端点预估查询消耗。
使用方式:请求发往 https://api.podchaser.com/graphql,使用 POST 方法,请求头包含 Content-Type: application/json 与 Authorization: Bearer $PODCHASER_TOKEN。查询以 GraphQL 语句写入 /tmp/podchaser_request.json 后通过 curl 发送,例如:curl -s -X POST "https://api.podchaser.com/graphql" --header "Content-Type: application/json" --header "Authorization: Bearer $PODCHASER_TOKEN" -d @/tmp/podchaser_request.json。使用 identifier 获取播客或单集时,type 字段必填,可选 PODCHASER、APPLE_PODCASTS 或 SPOTIFY。
限制与注意事项:请求限制为每 10 秒 50 次;查询按返回字段消耗积分,响应头 X-Podchaser-Points-Remaining 与 X-Podchaser-Query-Cost 可查看积分情况,基础元数据约 9 点,搜索 10 个播客含详情约 100 点。访问令牌有效期 1 年,应避免每次查询都申请新令牌;客户端应用应使用 limited_scope: true 的令牌(1 小时过期),且绝不能在客户端代码中暴露常规访问令牌。遇到 429 响应时检查 Retry-After 头。chartCategories 需要付费计划。若请求失败,可运行 zero doctor check-connector --env-name PODCHASER_TOKEN 或 zero doctor check-connector --url https://api.podchaser.com/graphql --method POST 排查。