tubesaku.com

{
  "name": "search_cover_songs",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search TubeSaku's Japan YouTube Charts and cover-song observations. Use this to compare demand, recent cover supply, existing cover supply, and early spread performance. Song titles and artist names remain in their original language. Use require_playlist_video=true when the user also wants a listening playlist.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "scope": {
        "type": "string",
        "enum": [
          "all",
          "low_supply",
          "no_recent_covers",
          "shorts_growth",
          "popular_covers",
          "top_demand"
        ],
        "default": "all",
        "description": "Dataset slice. Use all for cross-signal comparison; low_supply for popular songs with few recent covers; no_recent_covers for songs with no recent high-confidence TubeSaku match; shorts_growth for songs whose cover Shorts spread strongly; popular_covers for songs receiving many recent covers; top_demand for strongest original-song demand."
      },
      "keyword": {
        "type": "string",
        "maxLength": 100,
        "description": "Optional title or artist substring."
      },
      "require_playlist_video": {
        "type": "boolean",
        "default": false,
        "description": "If true, only return songs with at least one validated cover video for the TubeSaku listening playlist."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 30
      }
    },
    "additionalProperties": false
  },
  "page": "/utattemita-ranking/"
}

{
  "name": "show_cover_playlist",
  "kind": "act",
  "impl": "imperative",
  "description": "Display songs selected from the latest search_cover_songs result as AI Cover Picks on the TubeSaku page, and build an in-page YouTube listening playlist from validated cover videos. Only song IDs returned by the latest search can be used. When useful, include selection_notes so TubeSaku can show the agent's reason for each choice in the page UI.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "song_ids": {
        "type": "array",
        "minItems": 1,
        "maxItems": 10,
        "items": {
          "type": "string",
          "minLength": 8,
          "maxLength": 40
        },
        "description": "TubeSaku song IDs selected from the most recent search_cover_songs result."
      },
      "heading": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100,
        "description": "Short title for the selected plan or listening playlist."
      },
      "selection_notes": {
        "type": "array",
        "maxItems": 10,
        "description": "Optional short agent-authored reasons for the selected songs. Use the user's language. Each song_id should also be present in song_ids.",
        "items": {
          "type": "object",
          "properties": {
            "song_id": {
              "type": "string",
              "minLength": 8,
              "maxLength": 40
            },
            "reason": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          "required": [
            "song_id",
            "reason"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "song_ids"
    ],
    "additionalProperties": false
  },
  "page": "/utattemita-ranking/"
}