From 2d23cc42a93cd3e9be07ac6afccbdca1c11be5da Mon Sep 17 00:00:00 2001 From: therohitdas <43847374+therohitdas@users.noreply.github.com> Date: Mon, 21 Sep 2026 11:56:47 +0000 Subject: [PATCH] docs: note that sorted results come from the Videos tab Adds the Shorts nuance to the README and the two reference docs. Sorted results read YouTube's Videos tab, which is long-form only, so Shorts are reached through tab=shorts instead. Scoped to this merge-only repo's doc surfaces. skills/youtube/SKILL.md stays on the clean founder copy. Docs only, no version bump. Co-Authored-By: CRHQ --- README.md | 2 ++ skills/youtube/references/mcp-tools.md | 2 ++ skills/youtube/references/rest-api.md | 2 ++ 3 files changed, 6 insertions(+) diff --git a/README.md b/README.md index 07736c0..4133244 100644 --- a/README.md +++ b/README.md @@ -393,6 +393,8 @@ List a channel's feed, paginated. Use `tab` to choose the uploads feed (default, **Sorting.** Add sort=latest, popular, or oldest to channel/videos to get a channel's videos in the order you want, for example its most-popular uploads first. A sorted page returns about 30 videos (an unsorted page returns about 100), and every page costs the same 1 credit. +Sorted results come from YouTube's Videos tab (long-form only); Shorts have their own tab=shorts feed. + When paging, send the same sort on each request. Every item carries **`members_only`**: `true` only when YouTube badges the video "Members only", and those items have no `viewCountText`. It is always `false` on the uploads feed, on `tab: "shorts"`, and on playlists. diff --git a/skills/youtube/references/mcp-tools.md b/skills/youtube/references/mcp-tools.md index 4ea6afb..0d15f71 100644 --- a/skills/youtube/references/mcp-tools.md +++ b/skills/youtube/references/mcp-tools.md @@ -170,6 +170,8 @@ or live streams (~48/page), and the optional `sort` to order the Videos tab. **Sorting.** Add sort=latest, popular, or oldest to channel/videos to get a channel's videos in the order you want, for example its most-popular uploads first. A sorted page returns about 30 videos (an unsorted page returns about 100), and every page costs the same 1 credit. +Sorted results come from YouTube's Videos tab (long-form only); Shorts have their own tab=shorts feed. + When paging, send the same sort on each request. Every item carries **`members_only`**: `true` only when YouTube badges the video "Members only", and those items have no `viewCountText`. It is always `false` on the uploads feed, on `tab: "shorts"`, and on playlists. diff --git a/skills/youtube/references/rest-api.md b/skills/youtube/references/rest-api.md index cd13ca1..0569312 100644 --- a/skills/youtube/references/rest-api.md +++ b/skills/youtube/references/rest-api.md @@ -197,6 +197,8 @@ Provide **exactly one** of `channel` or `continuation`. The response carries **Sorting.** Add sort=latest, popular, or oldest to channel/videos to get a channel's videos in the order you want, for example its most-popular uploads first. A sorted page returns about 30 videos (an unsorted page returns about 100), and every page costs the same 1 credit. +Sorted results come from YouTube's Videos tab (long-form only); Shorts have their own tab=shorts feed. + When paging, send the same sort on each request. Every item carries `members_only`, `true` only when YouTube badges it "Members only", and those