fix(copy): flat-cost lines, safe brands, verified stats, dash sweep

- Flatten both per-call cost lines to the agreed wording so they don't
  read as contradicting the FREE tools listed nearby: "Successful calls
  cost 1 credit unless a tool states otherwise below" (README.md,
  SKILL.md, mcp-tools.md) and "Successful requests cost 1 credit unless
  stated otherwise above" (rest-api.md, after the credit-cost table).
- Drop the unverified "Production-scale (15M+ requests/month, 49ms
  median)" claim from smithery.yaml, and the "(15M+ req/mo)" /
  "Hobbyist scrapers" cells from the README comparison table, re-padding
  the row.
- Drop "comprehensive" from "12 hosted MCP tools plus one comprehensive
  skill" (and the matching "single comprehensive `youtube` skill" in
  .codex-plugin/plugin.json) across all 7 files carrying that exact
  string; kept "no card" and "complete" wording as verified.
- Swapped the last personal-creator references and the rickroll
  placeholder ID (dQw4w9WgXcQ) for a verified one (UF8uR6Z6KLc). Where
  the old ID co-occurred with matching illustrative title/author/lyrics
  (mcp-tools.md's get_youtube_transcript example), replaced the whole
  block with the new video's real metadata (verified via YouTube oEmbed)
  instead of just swapping the ID, to avoid shipping a factually
  inconsistent example.
- Full em/en dash sweep of every touched file, replaced with
  hyphen/comma/colon per context; trimmed each FREE tool's redundant
  free/no-credit prose down to the single header badge mention.

Co-Authored-By: CRHQ <noreply@crhq.ai>

Author: therohitdas

.claude-plugin/marketplace.json

@@ -13,7 +13,7 @@
     {
       "name": "transcriptapi",
       "source": "./",
-      "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one comprehensive skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
+      "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
       "version": "1.2.0",
       "author": {
         "name": "TranscriptAPI",

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "transcriptapi",
   "version": "1.2.0",
-  "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one comprehensive skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
+  "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
   "author": {
     "name": "TranscriptAPI",
     "email": "hello@transcriptapi.com",

.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "transcriptapi",
   "version": "1.2.0",
-  "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one comprehensive skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
+  "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
   "author": {
     "name": "TranscriptAPI",
     "email": "hello@transcriptapi.com",
@@ -28,7 +28,7 @@
   "interface": {
     "displayName": "YouTube MCP + Skill (TranscriptAPI)",
     "shortDescription": "YouTube MCP + YouTube Skill for AI agents: transcripts, captions, search, channels and playlists.",
-    "longDescription": "One Agent Plugins 1.0.0 package that gives any compliant agent reliable access to YouTube: video transcripts, timestamped captions and subtitles, video and channel metadata, video and channel search, within-channel search, channel browsing and playlist contents. Ships a hosted MCP server (12 tools, OAuth 2.1, no key handling) plus a single comprehensive `youtube` skill that routes each request to the right tool, keeps credit spend low, and falls back to the REST API for clients that load skills without MCP. Free tier: 100 credits, no card. TranscriptAPI is a third-party, independent service. It is not affiliated with, endorsed by, or sponsored by YouTube or Google.",
+    "longDescription": "One Agent Plugins 1.0.0 package that gives any compliant agent reliable access to YouTube: video transcripts, timestamped captions and subtitles, video and channel metadata, video and channel search, within-channel search, channel browsing and playlist contents. Ships a hosted MCP server (12 tools, OAuth 2.1, no key handling) plus a single `youtube` skill that routes each request to the right tool, keeps credit spend low, and falls back to the REST API for clients that load skills without MCP. Free tier: 100 credits, no card. TranscriptAPI is a third-party, independent service. It is not affiliated with, endorsed by, or sponsored by YouTube or Google.",
     "developerName": "TranscriptAPI",
     "category": "Productivity",
     "capabilities": [

.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "transcriptapi",
   "version": "1.2.0",
-  "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one comprehensive skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
+  "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
   "author": {
     "name": "TranscriptAPI",
     "email": "hello@transcriptapi.com",

.plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "transcriptapi",
   "version": "1.2.0",
-  "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one comprehensive skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
+  "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
   "author": {
     "name": "TranscriptAPI",
     "email": "hello@transcriptapi.com",

README.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <b>The complete YouTube toolkit as a single Agent Plugin, by <a href="https://transcriptapi.com">TranscriptAPI</a>.</b><br/>
-  YouTube transcripts, video &amp; channel metadata, captions and subtitles, video &amp; channel search, channel browsing, playlist extraction and new-upload polling: 12 hosted MCP tools plus one comprehensive skill.<br/>
+  YouTube transcripts, video &amp; channel metadata, captions and subtitles, video &amp; channel search, channel browsing, playlist extraction and new-upload polling: 12 hosted MCP tools plus one skill.<br/>
   One install. OAuth sign-in. No API key to manage. Free tier, no card.
 </p>
 
@@ -40,8 +40,8 @@ One install gives your agent both halves:
 **Just ask, in plain English:**
 
 ```txt
-Summarize this video for me: https://youtu.be/dQw4w9WgXcQ
-Find Andrew Huberman's three most-viewed videos about sleep and compare them.
+Summarize this video for me: https://youtu.be/UF8uR6Z6KLc
+Find @NASA's three most-viewed videos about the Moon landing and compare them.
 What has @TED posted in the last month?
 ```
 
@@ -62,7 +62,7 @@ Most YouTube integrations do one thing: pull a single transcript. **This is a fu
 | Channel & playlist extraction            | ✅ Yes             | ❌ No |
 | Latest-uploads monitoring (free)         | ✅ Yes             | ❌ No |
 | OAuth 2.1 + API key auth                 | ✅ Both            | ❌ Usually neither |
-| Production scale (15M+ req/mo)           | ✅ Yes             | ❌ Hobbyist scrapers |
+| Production scale                         | ✅ Yes             | ❌ No |
 | Works on mobile Claude & web Claude      | ✅ Yes             | ❌ No |
 | Agent-friendly error messages            | ✅ Yes             | ❌ Bare HTTP codes |
 | No yt-dlp, no headless browser, no binaries | ✅ Just an API call | ❌ Blocked on cloud IPs |
@@ -266,7 +266,7 @@ amp mcp add transcript-api https://transcriptapi.com/mcp --header "Authorization
 
 ## 🛠️ The 12 MCP tools
 
-All 12 are exposed automatically once you connect. **1 credit = 1 successful (HTTP 200) request.** Failed and rate-limited calls do not consume credits.
+All 12 are exposed automatically once you connect. **Successful calls cost 1 credit unless a tool states otherwise below.** Failed and rate-limited calls do not consume credits.
 
 > **Which video tool?** Use `get_youtube_video_info` (free) to discover transcript languages before fetching a transcript. Use `get_video_metadata` (1 credit) for view/like counts, publish date, description, duration, tags, or related videos.
 
@@ -314,7 +314,7 @@ JSON:
 
 ### 2. `get_youtube_video_info` <sub>· **FREE**</sub>
 
-Basic metadata (title, author, thumbnail) plus the available transcript languages — call before `get_youtube_transcript` to pick a language.
+Basic metadata (title, author, thumbnail) plus the available transcript languages: call before `get_youtube_transcript` to pick a language.
 
 | Parameter   | Type   | Default      | Description                                     |
 | ----------- | ------ | ------------ | ------------------------------------------------ |
@@ -360,7 +360,7 @@ A channel's profile: title, `@handle`, verified flag, subscriber/video-count tex
 
 ### 6. `get_channel_latest_videos` <sub>· **FREE**</sub>
 
-The ~15 most recent uploads from any channel via RSS. No credits. Perfect for monitoring, daily recaps, or triggering downstream pipelines.
+The ~15 most recent uploads from any channel via RSS. Perfect for monitoring, daily recaps, or triggering downstream pipelines.
 
 | Parameter | Type   | Default      | Description                                  |
 | --------- | ------ | ------------ | -------------------------------------------- |
@@ -405,7 +405,7 @@ Paginated list of the playlists on a channel (id, title, URL, video-count text,
 
 ### 10. `list_channel_posts`
 
-Paginated list of a channel's community (Posts tab) content — text, publish time, like-count text, and attachments. Channels without a community tab return an empty results list, not an error.
+Paginated list of a channel's community (Posts tab) content: text, publish time, like-count text, and attachments. Channels without a community tab return an empty results list, not an error.
 
 | Parameter      | Type   | Default | Description                          |
 | -------------- | ------ | ------- | ------------------------------------ |
@@ -416,7 +416,7 @@ Paginated list of a channel's community (Posts tab) content — text, publish ti
 
 ### 11. `get_channel_sections`
 
-The curated, grouped sections of a channel page — titled shelves of videos, playlists, shorts, or featured channels, in the channel's own order.
+The curated, grouped sections of a channel page: titled shelves of videos, playlists, shorts, or featured channels, in the channel's own order.
 
 | Parameter | Type   | Default      | Description                                                     |
 | --------- | ------ | ------------ | ---------------------------------------------------------------- |

marketplace.json

@@ -13,7 +13,7 @@
     {
       "name": "transcriptapi",
       "source": "./",
-      "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one comprehensive skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
+      "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
       "version": "1.2.0",
       "author": {
         "name": "TranscriptAPI",

plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "transcriptapi",
   "version": "1.2.0",
-  "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one comprehensive skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
+  "description": "YouTube MCP + YouTube Skill for AI agents: YouTube transcripts, video and channel metadata, captions, subtitles, video and channel search, channel browsing and playlist extraction. 12 hosted MCP tools plus one skill, powered by TranscriptAPI. OAuth sign-in, free tier, no API key to manage.",
   "author": {
     "name": "TranscriptAPI",
     "email": "hello@transcriptapi.com",

skills/youtube/SKILL.md

@@ -90,7 +90,7 @@ Full parameters, defaults and response shapes:
 
 ## Step 3: spend credits carefully
 
-1 credit = 1 successful (HTTP 200) request. Failed and rate-limited calls are never charged.
+Successful calls cost 1 credit unless a tool states otherwise below. Failed and rate-limited calls are never charged.
 
 - **`get_channel_latest_videos` is free.** Reach for it first for anything about recent
   uploads. Use `list_channel_videos` only when the user genuinely wants the whole catalogue.

skills/youtube/references/mcp-tools.md

@@ -4,7 +4,7 @@ The 12 tools exposed by the bundled `transcriptapi` MCP server
 (`https://transcriptapi.com/mcp`, streamable HTTP, OAuth 2.1).
 
 Authorization is handled by the client. There is no key to pass and no auth argument on any
-tool. 1 credit = 1 successful call; failures and rate limits are never charged.
+tool. Successful calls cost 1 credit unless a tool states otherwise below; failures and rate limits are never charged.
 
 **Which video tool?** Use `get_youtube_video_info` (free) to discover transcript languages
 before fetching a transcript. Use `get_video_metadata` (1 credit) for view/like counts,
@@ -31,30 +31,30 @@ moment. `"text"` is cheaper to reason over.
 ```markdown
 # Metadata
 
-## Title: Rick Astley - Never Gonna Give You Up
-## Author: RickAstleyVEVO
+## Title: Steve Jobs' 2005 Stanford Commencement Address
+## Author: Stanford
 
 # Transcript
 
-[0.0s] Never gonna give you up
-[4.12s] Never gonna let you down
+[0.0s] I am honored to be with you today at your commencement
+[4.12s] from one of the finest universities in the world.
 ```
 
 **`format="json"`**
 
 ```json
 {
-  "video_id": "dQw4w9WgXcQ",
+  "video_id": "UF8uR6Z6KLc",
   "language": "en",
   "transcript": [
-    { "text": "Never gonna give you up", "start": 0.0, "duration": 4.12 },
-    { "text": "Never gonna let you down", "start": 4.12, "duration": 3.85 }
+    { "text": "I am honored to be with you today at your commencement", "start": 0.0, "duration": 4.12 },
+    { "text": "from one of the finest universities in the world.", "start": 4.12, "duration": 3.85 }
   ],
   "metadata": {
-    "title": "Rick Astley - Never Gonna Give You Up",
-    "author_name": "RickAstleyVEVO",
-    "author_url": "https://www.youtube.com/@RickAstley",
-    "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
+    "title": "Steve Jobs' 2005 Stanford Commencement Address",
+    "author_name": "Stanford",
+    "author_url": "https://www.youtube.com/@stanford",
+    "thumbnail_url": "https://i.ytimg.com/vi/UF8uR6Z6KLc/maxresdefault.jpg"
   }
 }
 ```
@@ -63,8 +63,8 @@ moment. `"text"` is cheaper to reason over.
 
 ## `get_youtube_video_info`: FREE
 
-Basic metadata (title, author, thumbnail) plus the list of available transcript languages —
-call this before `get_youtube_transcript` to pick a language. No credit used.
+Basic metadata (title, author, thumbnail) plus the list of available transcript languages:
+call this before `get_youtube_transcript` to pick a language.
 
 | Parameter | Type | Default | Notes |
 | --- | --- | --- | --- |
@@ -90,7 +90,7 @@ Hidden counts are `null`, never `0`. When `details` can't be read, `details.avai
 `false` with a `reason` instead of a guessed value.
 
 ```json
-get_video_metadata({ video_url: "dQw4w9WgXcQ", include: ["details", "related"] })
+get_video_metadata({ video_url: "UF8uR6Z6KLc", include: ["details", "related"] })
 ```
 
 ---
@@ -108,7 +108,7 @@ Search YouTube for videos, channels, playlists, or movies. ~20 results per page.
 | `duration` | string | _none_ | `short` (under 4m), `medium` (4-20m), `long` (over 20m) (first call, videos only) |
 | `continuation` | string | `null` | Token from a prior call, for the next page |
 
-Provide either `query` (first call) or `continuation` (next pages) — not both. Filters apply to
+Provide either `query` (first call) or `continuation` (next pages), not both. Filters apply to
 the first call only; the `continuation` token already encodes them. Returns metadata only, no
 transcripts. Pick the best hits, then transcribe those.
 
@@ -123,7 +123,7 @@ keywords, tags, thumbnails, banners, and the tabs it exposes. Not paginated.
 | --- | --- | --- | --- |
 | `channel` | string | **required** | `@handle`, channel URL, or `UC…` ID |
 
-Counts are display strings (e.g. `27.8M subscribers`) and `null` when YouTube hides them —
+Counts are display strings (e.g. `27.8M subscribers`) and `null` when YouTube hides them,
 never `0`. Check `availableTabs` before calling `get_channel_sections` or `list_channel_videos`
 with a `tab`.
 
@@ -137,7 +137,7 @@ The ~15 most recent uploads from a channel, via RSS.
 | --- | --- | --- | --- |
 | `channel` | string | **required** | `@handle`, channel URL, or `UC…` ID |
 
-Costs nothing. Use it freely for anything about recent uploads, monitoring, or daily recaps.
+Use it freely for anything about recent uploads, monitoring, or daily recaps.
 Returns exact view counts and ISO publish timestamps.
 
 ---
@@ -187,7 +187,7 @@ Pass a returned playlist id to `list_playlist_videos` to get its videos.
 
 ## `list_channel_posts`: 1 credit per page
 
-Paginated list of a channel's community (Posts tab) content — text, publish time, like-count
+Paginated list of a channel's community (Posts tab) content: text, publish time, like-count
 text, and attachments (image, multi-image, video, playlist, or poll).
 
 | Parameter | Type | Default | Notes |
@@ -201,15 +201,15 @@ Channels without a community tab return an empty results list (not an error).
 
 ## `get_channel_sections`: 1 credit
 
-The curated, grouped sections of a channel page — titled shelves of videos, playlists, shorts,
+The curated, grouped sections of a channel page: titled shelves of videos, playlists, shorts,
 or featured channels, in the channel's own order. Not paginated.
 
 | Parameter | Type | Default | Notes |
 | --- | --- | --- | --- |
 | `channel` | string | **required** | `@handle`, channel URL, or `UC…` ID |
 | `tab` | string | `"featured"` | `featured` (Home), `podcasts`, or `releases` |
 
-`podcasts` and `releases` exist only on channels that have them (empty results otherwise — call
+`podcasts` and `releases` exist only on channels that have them (empty results otherwise: call
 `get_channel_info` to see a channel's tabs first).
 
 ---