# YouTube data for AI agents

> ToolSocket gives Claude, ChatGPT, Cursor, Codex and any MCP or REST client live access to YouTube — videos, channels, comments, search and shorts — through 30 ready-made tools. No YouTube account, scraper or API key of your own is needed: connect https://toolsocket.top/mcp once and pay per call (most calls $0.0015).

ToolSocket 让 Claude、ChatGPT、Cursor、Codex 等任何支持 MCP 或 REST 的 AI 智能体，直接读取YouTube的实时数据：视频、频道、评论、搜索和 Shorts 数据，共 30 个工具。不用注册YouTube账号、不用写爬虫，接入一个地址即可，按次计费（大多 $0.0015/次）。

## Connect

- MCP (Claude.ai, ChatGPT, Claude Code, Cursor, VS Code, Codex): `https://toolsocket.top/mcp` — OAuth sign-in or `Authorization: Bearer ts_live_…`
- Claude Code: `claude mcp add --transport http toolsocket https://toolsocket.top/mcp`
- Any agent that reads skills: `set up https://toolsocket.top/SKILL.md`
- Setup for every client: https://toolsocket.top/docs.md

## Example

Ask your agent: "Summarize the comments on this YouTube video." / 「总结这个 YouTube 视频的评论。」

```bash
curl -s -X POST https://toolsocket.top/v1/run -H "Authorization: Bearer $TOOLSOCKET_API_KEY" \
  -H "content-type: application/json" -d '{"tool":"youtube#web/search_video","input":{"search_query":"Minecraft","language_code":"en","order_by":"this_month","country_code":"us"},"wait":30}'
```

## Tools (30)

| Tool | ID | Price | What it does |
|---|---|---|---|
| YouTube · Get related videos (web) · YouTube · 获取推荐视频（web） | `youtube#web/get_relate_video` | $0.0015 / call | Get related videos by video ID. |
| YouTube · Search video (web) · YouTube · 搜索视频（web） | `youtube#web/search_video` | $0.0015 / call | Search video. |
| YouTube · Get channel ID (web) · YouTube · 获取频道ID（web） | `youtube#web/get_channel_id` | $0.0015 / call | Get channel ID. |
| YouTube · Get channel ID from URL V2 (web) · YouTube · 从频道URL获取频道ID V2（web） | `youtube#web/get_channel_id_v2` | $0.0015 / call | Convert YouTube channel URL to channel ID. |
| YouTube · Get channel URL from channel ID (web) · YouTube · 从频道ID获取频道URL（web） | `youtube#web/get_channel_url` | $0.0015 / call | Convert YouTube channel ID to channel handle (@username) |
| YouTube · Get channel information (web) · YouTube · 获取频道信息（web） | `youtube#web/get_channel_info` | $0.0015 / call | Get channel information. |
| YouTube · Get channel short videos (web) · YouTube · 获取频道短视频（web） | `youtube#web/get_channel_short_videos` | $0.0015 / call | Get channel short videos. |
| YouTube · Search channel (web) · YouTube · 搜索频道（web） | `youtube#web/search_channel` | $0.0015 / call | Search channel. |
| YouTube · Get video information (web v2) · YouTube · 获取视频详情（web v2） | `youtube#web_v2/get_video_info` | $0.0015 / call | Get YouTube video details |
| YouTube · Get video information V2 (web v2) · YouTube · 获取视频详情 V2（web v2） | `youtube#web_v2/get_video_info_v2` | $0.0015 / call | Fetch YouTube video details via an alternative extraction path (more stable field extraction) |
| YouTube · Get video comments (web v2) · YouTube · 获取视频评论（web v2） | `youtube#web_v2/get_video_comments` | $0.0015 / call | Get YouTube video first-level comments |
| YouTube · Get channel description (web v2) · YouTube · 获取频道描述信息（web v2） | `youtube#web_v2/get_channel_description` | $0.0015 / call | Get YouTube channel description information (subscribers, videos, views, creation date, social links, etc.) |
| YouTube · General search (raw data, recommend V2) (web v2) · YouTube · 综合搜索（原始数据，推荐使用V2）（web v2） | `youtube#web_v2/get_general_search` | $0.0015 / call | YouTube comprehensive search with multiple filter options for precise result filtering |
| YouTube · General search V2 (web v2) · YouTube · 综合搜索V2（web v2） | `youtube#web_v2/get_general_search_v2` | $0.003 / call | Search YouTube videos, Shorts, channels, and playlists |
| YouTube · Shorts search (raw data, recommend V2) (web v2) · YouTube · Shorts搜索（原始数据，推荐使用V2）（web v2） | `youtube#web_v2/get_shorts_search` | $0.0015 / call | YouTube Shorts specialized search using native YouTube API |
| YouTube · Shorts search V2 (web v2) · YouTube · Shorts搜索V2（web v2） | `youtube#web_v2/get_shorts_search_v2` | $0.003 / call | Search specifically for YouTube Shorts |
| YouTube · Get channel ID from URL (web v2) · YouTube · 从频道URL获取频道ID（web v2） | `youtube#web_v2/get_channel_id` | $0.0015 / call | Convert YouTube channel URL to channel ID. |
| YouTube · Get channel URL from channel ID (web v2) · YouTube · 从频道ID获取频道URL（web v2） | `youtube#web_v2/get_channel_url` | $0.0015 / call | Convert YouTube channel ID to channel handle (@username) |
| YouTube · Get channel videos (web v2) · YouTube · 获取频道视频（web v2） | `youtube#web_v2/get_channel_videos` | $0.0015 / call | Get YouTube channel video list |
| YouTube · Get video streams info (web v2) · YouTube · 获取视频流信息（web v2） | `youtube#web_v2/get_video_streams` | $0.0015 / call | Get all quality format information for YouTube video |
| YouTube · Get video streams info V2 (web v2) · YouTube · 获取视频流信息 V2（web v2） | `youtube#web_v2/get_video_streams_v2` | $0.006 / call | Get all quality format information and playback URLs for YouTube video |
| YouTube · Get signed video stream URL (web v2) · YouTube · 获取已签名的视频流URL（web v2） | `youtube#web_v2/get_signed_stream_url` | $0.0015 / call | Get signed playback URL for specific itag (ready to play) |
| YouTube · Get video captions (web v2) · YouTube · 获取视频字幕（web v2） | `youtube#web_v2/get_video_captions` | $0.012 / call | Get video caption list or caption content for a specific language |
| YouTube · Get related videos (web v2) · YouTube · 获取视频相似内容（web v2） | `youtube#web_v2/get_related_videos` | $0.0015 / call | Get YouTube video's related content recommendations (recommended videos list) |
| YouTube · Get channel shorts (web v2) · YouTube · 获取频道短视频列表（web v2） | `youtube#web_v2/get_channel_shorts` | $0.0015 / call | Get YouTube channel's Shorts (short videos) list |
| YouTube · Get search suggestions (web v2) · YouTube · 获取搜索推荐词（web v2） | `youtube#web_v2/get_search_suggestions` | $0.0015 / call | Get YouTube search suggestions (autocomplete) |
| YouTube · Search channels (web v2) · YouTube · 搜索频道（web v2） | `youtube#web_v2/search_channels` | $0.0015 / call | Search YouTube channels |
| YouTube · Get channel community posts (web v2) · YouTube · 获取频道帖子列表（web v2） | `youtube#web_v2/get_channel_community_posts` | $0.0015 / call | Get YouTube channel's community posts list |
| YouTube · Get post detail (web v2) · YouTube · 获取帖子详情（web v2） | `youtube#web_v2/get_post_detail` | $0.0015 / call | Get YouTube post (community post) detail information |
| YouTube · Get post comments (web v2) · YouTube · 获取帖子评论（web v2） | `youtube#web_v2/get_post_comments` | $0.0015 / call | Get YouTube post (community post) comments |
