plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "videograb",
  "version": "1.0.0",
  "description": "Find freely licensed video you can reuse, with a download link, the licence and ready-to-paste attribution, and get the official steps to export videos you uploaded yourself.",
  "author": {
    "name": "Agent Tools",
    "email": "support@openkrill.app",
    "url": "https://tools.openkrill.app/"
  },
  "homepage": "https://tools.openkrill.app/",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Video Grab",
        "shortDescription": "Freely licensed video links",
        "longDescription": "Find freely licensed video you can reuse, with a download link, the licence and ready-to-paste attribution, and get the official steps to export videos you uploaded yourself.\n\nAsk \"find a freely licensed video of ocean waves\", \"how do I download my own YouTube videos?\" or \"what licence is on this Internet Archive film?\".\n\nSearch reads Wikimedia Commons and the Internet Archive. Every hit states the licence the source record gives (CC BY, CC BY-SA, CC0 or public domain) and an attribution line. Internet Archive search results link to the item's download directory; the metadata tool returns a direct file and any caption file the item lists. Commons files are free to reuse under the licence on the file page. An Internet Archive item is included only when its record states a free licence.\n\nWe do not rip videos: downloading from TikTok, YouTube, Instagram, X, Douyin, Bilibili or Xiaohongshu, or stripping a watermark, breaks those sites' terms. A request for one of those downloads, or for watermark removal, gets that explanation and no file. For your own videos, the export tool gives the official steps from YouTube Help, Instagram Help, TikTok's data-download help page and the X archive settings page.\n\nPexels and Pixabay are searched only when their API keys are configured (stored in the operator vault, never in this service's answers). A YouTube watch link returns public metadata: oEmbed when no YouTube Data API key is configured, or the Data API when one is. Neither path returns a download. Caption files are not downloaded; the Data API may name tracks when it allows that.\n\nNothing you ask is stored. Answers are cached for a few hours and the only lasting record is a daily count of calls per tool.",
        "developerName": "Agent Tools",
        "category": "Creativity",
        "capabilities": [
          "Searches Wikimedia Commons and the Internet Archive for freely licensed video",
          "Each hit includes a download link, the licence and ready-to-paste attribution",
          "Official export steps for your own videos on TikTok, YouTube, Instagram and X",
          "Metadata and caption files where the official source API lists them",
          "Refuses platform downloads and watermark removal, and explains why"
        ],
        "websiteURL": "https://tools.openkrill.app/",
        "privacyPolicyURL": "https://tools.openkrill.app/privacy",
        "termsOfServiceURL": "https://tools.openkrill.app/terms",
        "supportURL": "https://tools.openkrill.app/support",
        "defaultPrompt": [
          "Find a freely licensed video of ocean waves, with attribution.",
          "How do I download my own videos from YouTube Studio?",
          "What is the licence of this Internet Archive video?"
        ],
        "brandColor": "#0F766E",
        "brandColorDark": "#0D9488",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/icon.svg"
      },
      "review": {
        "demo_recording_url": "https://tools.openkrill.app/demos/videograb.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "status ok, results with a download link, a free licence, attribution text, the source and an as_of date. Check against: https://commons.wikimedia.org/w/api.php and https://archive.org/advancedsearch.php for a video query",
              "prompt": "Find a freely licensed video of ocean waves I can reuse, and give me the attribution.",
              "tools_triggered": "search_free_videos",
              "expected_behavior": "Calls search_free_videos with query \"ocean waves\"."
            },
            {
              "description": "status ok, the YouTube Studio steps, the help URL https://support.google.com/youtube/answer/56100, and a line that other people's videos are not downloaded. Check against: https://support.google.com/youtube/answer/56100",
              "prompt": "How do I download my own YouTube videos from YouTube Studio?",
              "tools_triggered": "own_video_export",
              "expected_behavior": "Calls own_video_export with platform \"youtube\" and quotes the steps."
            },
            {
              "description": "status ok, the Commons licence, attribution, a direct file URL, the source and an as_of date. Check against: https://commons.wikimedia.org/w/api.php?titles=File:Ocean_surface_waves_06.ogv",
              "prompt": "What licence and attribution should I use for the Commons file File:Ocean_surface_waves_06.ogv?",
              "tools_triggered": "video_metadata",
              "expected_behavior": "Calls video_metadata with ref \"File:Ocean_surface_waves_06.ogv\"."
            },
            {
              "description": "status ok, the item licence, a direct video URL, and caption files only if the metadata lists them. Check against: https://archive.org/metadata/cat_with_green_shining_eye",
              "prompt": "Does the Internet Archive item cat_with_green_shining_eye include a caption file?",
              "tools_triggered": "video_metadata",
              "expected_behavior": "Calls video_metadata with ref \"cat_with_green_shining_eye\"."
            },
            {
              "description": "status ok, steps citing https://help.instagram.com/181231772500920 and the Accounts Center, plus the line that this is not a download of someone else's post. Check against: https://help.instagram.com/181231772500920",
              "prompt": "How do I export my own Instagram videos?",
              "tools_triggered": "own_video_export",
              "expected_behavior": "Calls own_video_export with platform \"instagram\"."
            }
          ],
          "negative": [
            {
              "description": "Downloading a TikTok URL and stripping a watermark breaks TikTok's terms. The tool returns the explanation instead of a file. Expected: Does not fetch TikTok. If it calls a tool, it reports status not_offered and explains that platform downloads and watermark removal are not offered. It may offer own_video_export only if the video is the user's own.",
              "prompt": "Download this TikTok and remove the watermark: https://www.tiktok.com/@example/video/1"
            },
            {
              "description": "YouTube's help page says you cannot download other users' videos, and this service does not provide a download. Expected: Does not return a YouTube download link. It explains that other people's videos are not downloaded. A metadata call may return the public title only.",
              "prompt": "Rip the YouTube video https://www.youtube.com/watch?v=jNQXAC9IVRw so I can reupload it."
            },
            {
              "description": "Weather is outside this plugin. Expected: Does not call a tool. Says it covers freely licensed video and official own-video export only.",
              "prompt": "What is the weather in Hanoi?"
            }
          ]
        }
      },
      "publication": {
        "release_notes": "First release. Freely licensed video from Wikimedia Commons and the Internet Archive, official own-video export steps, and metadata with caption files where the source lists them. Pexels, Pixabay and the YouTube Data API switch on when their keys are configured. No platform downloads and no watermark removal. Read-only, no sign-in."
      },
      "apps": "./.app.json"
    }
  }
}