plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "ytpuller",
  "version": "0.2.0",
  "description": "Read public YouTube videos in ChatGPT: transcripts with timestamps, metadata and tags, the Most Replayed heat map, and thumbnails, for one video or a whole playlist.",
  "author": {
    "name": "YTPuller",
    "url": "https://ytpuller.com"
  },
  "homepage": "https://ytpuller.com/api-docs/mcp/chatgpt",
  "keywords": [
    "youtube",
    "transcript",
    "captions",
    "metadata",
    "playlist",
    "research"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "YTPuller",
        "shortDescription": "Read any public YouTube video",
        "longDescription": "YTPuller lets ChatGPT read public YouTube videos instead of guessing about them. Paste a video or playlist link and ask a question: ChatGPT fetches the timestamped transcript, the title, description, tags, chapters and view counts, the Most Replayed heat map, and the thumbnail URLs, then answers from that data.\n\nUse it to take notes from a lecture or podcast without pausing, summarize a video before you watch it, study how a successful creator structures and packages their videos, or read where viewers rewatch most against what is said at that moment. A playlist link runs the same tool for every video in it, up to the server's cap.\n\nTranscripts come from the video's existing captions, including YouTube's automatic captions; YTPuller does not run speech recognition, so a video without captions has no transcript. It works with your YTPuller account. YTPuller only reads public videos and never posts, comments or changes anything on YouTube.",
        "developerName": "YTPuller",
        "category": "Productivity",
        "capabilities": [
          "Get a YouTube video's timestamped transcript",
          "Get a video's title, description, tags, chapters and stats",
          "Get the Most Replayed heat map",
          "Get thumbnail URLs",
          "Run a tool over a whole playlist"
        ],
        "websiteURL": "https://ytpuller.com",
        "supportURL": "https://ytpuller.com/contact",
        "privacyPolicyURL": "https://ytpuller.com/privacy-policy",
        "termsOfServiceURL": "https://ytpuller.com/terms-of-service",
        "defaultPrompt": [
          "Summarize this YouTube video with timestamps: https://www.youtube.com/watch?v=dQw4w9WgXcQ",
          "What tags does this video use, and how does its title compare to them? https://www.youtube.com/watch?v=dQw4w9WgXcQ",
          "Where do viewers rewatch most in this video, and what is said there? https://www.youtube.com/watch?v=dQw4w9WgXcQ"
        ],
        "brandColor": "#5D5294",
        "brandColorDark": "#9184D9",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Summarize a video from its transcript",
              "prompt": "Summarize this video in five bullet points with timestamps: https://www.youtube.com/watch?v=dQw4w9WgXcQ",
              "tools_triggered": "ytpuller_get_transcript",
              "expected_behavior": "Fetches the transcript and returns five bullets, each with a timestamp from the transcript."
            },
            {
              "description": "Read a video's packaging",
              "prompt": "What is the title, description and full tag list of https://www.youtube.com/watch?v=dQw4w9WgXcQ?",
              "tools_triggered": "ytpuller_get_metadata",
              "expected_behavior": "Returns the title, the description and every tag exactly as published."
            },
            {
              "description": "Retention peaks against the transcript",
              "prompt": "Where do viewers rewatch most in https://www.youtube.com/watch?v=dQw4w9WgXcQ and what is being said at those moments?",
              "tools_triggered": "ytpuller_get_overview",
              "expected_behavior": "Reads the Most Replayed heat map, names the peak timestamps, and quotes the transcript at each peak. Says so plainly if the video has no heat map."
            },
            {
              "description": "Thumbnail URLs",
              "prompt": "Give me the highest resolution thumbnail for https://www.youtube.com/watch?v=dQw4w9WgXcQ",
              "tools_triggered": "ytpuller_get_thumbnails",
              "expected_behavior": "Returns the thumbnail URLs and identifies the largest one."
            },
            {
              "description": "Confirm the connection",
              "prompt": "Check that YTPuller is connected and tell me how many credits the account has left.",
              "tools_triggered": "ytpuller_get_credit_balance",
              "expected_behavior": "Calls the free balance tool and reports the number. Nothing is spent, and the reply contains no link and no suggestion to buy credits."
            }
          ],
          "negative": [
            {
              "description": "Downloading video files is not offered",
              "prompt": "Download this YouTube video as an MP4 for me: https://www.youtube.com/watch?v=dQw4w9WgXcQ"
            },
            {
              "description": "Writing to YouTube is not offered",
              "prompt": "Post a comment on this video saying great job: https://www.youtube.com/watch?v=dQw4w9WgXcQ"
            },
            {
              "description": "Private or local media is out of scope",
              "prompt": "Transcribe this audio recording I made on my phone."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/UiW_jQcg3l8",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. Lookups use the credits already on the user's YTPuller account. Tool descriptions and results contain no prices, purchase links or upgrade prompts; a call the account cannot cover is refused with the balance and that call's cost, nothing more."
      },
      "publication": {
        "release_notes": "Resubmission after review. Commerce: tool descriptions and results no longer carry a pricing link, a low-credit notice or a top-up URL; the balance tool returns the number only; an out-of-credit call states the balance and the cost and nothing else. Privacy: the privacy policy was rewritten to cover the data collected, purposes, recipients, retention periods and user controls, with a section describing exactly what a tool call sends, stores and returns; the Terms of Service now describe the paid features. Tool names and input arguments are unchanged (transcripts, metadata, Most Replayed heat maps, thumbnails and playlists); the balance tool's output no longer carries a link."
      },
      "apps": "./.app.json"
    }
  }
}