youtubea_skill

Overview

This skill provides an integration with the YouTube Data API v3 via a managed OAuth gateway. It lets you search videos, fetch channel and video details, manage playlists and subscriptions, and read or post comments using a simple proxied endpoint with token management.

How this skill works

Requests are sent to the gateway URL which proxies to the official YouTube API and injects OAuth credentials tied to your account. You authenticate with a Maton API key in the Authorization header and optionally select a specific Google connection using a Maton-Connection header. Standard YouTube API query parameters and JSON bodies are supported for reads and writes.

When to use it

• Search YouTube for videos, channels, or playlists programmatically
• Retrieve detailed video or channel metadata and statistics
• Create, update, delete playlists and manage playlist items
• List, post, reply to, or delete comments on videos
• Manage subscriptions and check subscription status for the authenticated user
• Access your authenticated channel data and uploaded videos

Best practices

• Set MATON_API_KEY as an environment variable and include it as Authorization: Bearer $MATON_API_KEY
• Use the Maton control endpoint to create and manage Google OAuth connections before making writes
• Always include the required part parameter to limit returned data and reduce quota usage
• Use pageToken for paginated endpoints and respect rate limits (10 req/sec per account)
• Prefer read-only endpoints when possible to conserve quota; search calls are expensive

Example use cases

• Build a search UI that queries videos and displays thumbnails and stats
• Automate playlist creation and populate playlists with selected video IDs
• Monitor channel analytics and fetch subscriber/view counts programmatically
• Implement comment moderation tools to list, reply to, or remove comments
• Automate subscribing/unsubscribing to channels on behalf of an authenticated account