用途:通过 Twitch Helix API 查询频道直播、用户信息、热门游戏和剪辑(Clips),仅包含只读操作,查询时无需确认。
主要能力:获取用户资料(ID、登录名、显示名称、观看数)、获取直播列表(主播名、游戏名、观众数、标题)、获取热门游戏(ID、名称)、获取指定主播的剪辑(ID、标题、观看数、URL)。
必要用法:需设置环境变量 TWITCH_CLIENT_ID(客户端 ID)和 TWITCH_ACCESS_TOKEN(OAuth 访问令牌)。请求需带请求头 Client-ID 与 Authorization: Bearer。示例: 获取用户:curl -s -H "Client-ID: $TWITCH_CLIENT_ID" -H "Authorization: Bearer $TWITCH_ACCESS_TOKEN" "https://api.twitch.tv/helix/users?login=USERNAME" | jq '.data[0] | {id, login, display_name, view_count}' 获取直播:curl -s -H "Client-ID: $TWITCH_CLIENT_ID" -H "Authorization: Bearer $TWITCH_ACCESS_TOKEN" "https://api.twitch.tv/helix/streams?first=10" | jq '.data[] | {user_name, game_name, viewer_count, title}' 获取热门游戏:curl -s -H "Client-ID: $TWITCH_CLIENT_ID" -H "Authorization: Bearer $TWITCH_ACCESS_TOKEN" "https://api.twitch.tv/helix/games/top?first=10" | jq '.data[] | {id, name}' 获取剪辑:curl -s -H "Client-ID: $TWITCH_CLIENT_ID" -H "Authorization: Bearer $TWITCH_ACCESS_TOKEN" "https://api.twitch.tv/helix/clips?broadcaster_id=BROADCASTER_ID&first=5" | jq '.data[] | {id, title, view_count, url}'
适用场景:查询特定主播或用户资料、浏览当前热门直播、统计热门游戏分布、收集主播的剪辑作品等。
限制:仅支持只读查询,不含写入或管理操作;需自行提供有效的客户端 ID 与访问令牌,令牌的获取与刷新方式暂未提供;返回字段与分页等细节以 Twitch Helix API 为准。