Skip to main content

Documentation Index

Fetch the complete documentation index at: https://onecli.sh/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

OneCLI connects AI agents to YouTube through Google’s OAuth flow. Agents can search for videos, list channel content, manage playlists, and read analytics data. The gateway injects OAuth credentials into requests to the YouTube Data API automatically. This is useful for agents that manage video content, curate playlists, monitor channel performance, or gather video metadata.

​
Setup

1

Go to Connections

Open the OneCLI dashboard and navigate to Connections > YouTube.
2

Authorize

Click Connect YouTube. You’ll be redirected to Google to authorize OneCLI. Review the permissions and click Allow.

​
What agents can do

  • Search for videos by keyword, topic, or channel
  • List videos on a channel with metadata (title, description, publish date, view count)
  • Get detailed video information (duration, tags, category, thumbnail URLs)
  • Create, update, and delete playlists
  • Add and remove videos from playlists
  • Read channel analytics (views, watch time, subscribers gained/lost)
  • List and read video comments
  • Post comments on videos
  • Read video captions and transcripts
  • List channel subscriptions

​
Controlling access with rules

Use OneCLI’s rules engine to limit what agents can do with YouTube. For example, you can allow read-only access for analytics agents, or block comment posting. Rules are evaluated before credential injection, so a blocked request never reaches YouTube.