---
title: YouTube
description: 与 YouTube 视频、频道和播放列表互动
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="youtube"
  color="#FF0000"
  icon={true}
  iconSvg={`<svg className="block-icon"
      
      
      viewBox='0 0 28 20'
      fill='currentColor'
      xmlns='http://www.w3.org/2000/svg'
      
    >
      <path
        d='M11.2 14L18.466 9.8L11.2 5.6V14ZM27.384 3.038C27.566 3.696 27.692 4.578 27.776 5.698C27.874 6.818 27.916 7.784 27.916 8.624L28 9.8C28 12.866 27.776 15.12 27.384 16.562C27.034 17.822 26.222 18.634 24.962 18.984C24.304 19.166 23.1 19.292 21.252 19.376C19.432 19.474 17.766 19.516 16.226 19.516L14 19.6C8.134 19.6 4.48 19.376 3.038 18.984C1.778 18.634 0.966 17.822 0.616 16.562C0.434 15.904 0.308 15.022 0.224 13.902C0.126 12.782 0.0839999 11.816 0.0839999 10.976L0 9.8C0 6.734 0.224 4.48 0.616 3.038C0.966 1.778 1.778 0.966 3.038 0.616C3.696 0.434 4.9 0.308 6.748 0.224C8.568 0.126 10.234 0.0839999 11.774 0.0839999L14 0C19.866 0 23.52 0.224 24.962 0.616C26.222 0.966 27.034 1.778 27.384 3.038Z'
        fill='currentColor'
      />
    </svg>`}
/>

{/* MANUAL-CONTENT-START:intro */}
[YouTube](https://www.youtube.com/) 是全球最大的视频分享平台，拥有数十亿个视频，并为超过 20 亿的登录月活跃用户提供服务。

通过 YouTube 的强大 API 功能，您可以：

- **搜索内容**：使用特定关键词、过滤器和参数，在 YouTube 的庞大视频库中找到相关视频
- **访问元数据**：获取视频的详细信息，包括标题、描述、观看次数和互动指标
- **分析趋势**：识别特定类别或地区内的热门内容和趋势话题
- **提取洞察**：收集关于观众偏好、内容表现和互动模式的数据

在 Sim 中，YouTube 集成使您的代理能够以编程方式搜索和分析 YouTube 内容，作为其工作流程的一部分。这为需要最新视频信息的强大自动化场景提供了可能。您的代理可以搜索教学视频、研究内容趋势、从教育频道收集信息，或监控特定创作者的新上传内容。此集成弥合了您的 AI 工作流程与全球最大视频库之间的差距，使自动化更加复杂且内容感知。通过将 Sim 与 YouTube 连接，您可以创建能够跟上最新信息的代理，提供更准确的响应，并为用户带来更多价值——这一切都无需人工干预或自定义代码。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 YouTube 集成到工作流程中。可以搜索视频、获取视频详情、获取频道信息、获取播放列表项目以及获取视频评论。

## 工具

### `youtube_search`

使用 YouTube Data API 搜索 YouTube 视频。

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `query` | 字符串 | 是 | YouTube 视频的搜索查询 |
| `maxResults` | 数字 | 否 | 返回视频的最大数量 |
| `apiKey` | 字符串 | 是 | YouTube API 密钥 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `items` | 数组 | 匹配搜索查询的 YouTube 视频数组 |

### `youtube_video_details`

获取特定 YouTube 视频的详细信息。

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `videoId` | 字符串 | 是 | YouTube 视频 ID |
| `apiKey` | 字符串 | 是 | YouTube API 密钥 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `videoId` | 字符串 | YouTube 视频 ID |
| `title` | 字符串 | 视频标题 |
| `description` | 字符串 | 视频描述 |
| `channelId` | 字符串 | 频道 ID |
| `channelTitle` | 字符串 | 频道名称 |
| `publishedAt` | 字符串 | 发布日期和时间 |
| `duration` | 字符串 | 视频时长（ISO 8601 格式） |
| `viewCount` | 数字 | 查看次数 |
| `likeCount` | 数字 | 点赞次数 |
| `commentCount` | 数字 | 评论数量 |
| `thumbnail` | 字符串 | 视频缩略图 URL |
| `tags` | 数组 | 视频标签 |

### `youtube_channel_info`

获取 YouTube 频道的详细信息。

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `channelId` | 字符串 | 否 | YouTube 频道 ID \(使用 channelId 或 username\) |
| `username` | 字符串 | 否 | YouTube 频道用户名 \(使用 channelId 或 username\) |
| `apiKey` | 字符串 | 是 | YouTube API 密钥 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `channelId` | 字符串 | YouTube 频道 ID |
| `title` | 字符串 | 频道名称 |
| `description` | 字符串 | 频道描述 |
| `subscriberCount` | 数字 | 订阅者数量 |
| `videoCount` | 数字 | 视频数量 |
| `viewCount` | 数字 | 频道总观看次数 |
| `publishedAt` | 字符串 | 频道创建日期 |
| `thumbnail` | 字符串 | 频道缩略图 URL |
| `customUrl` | 字符串 | 频道自定义 URL |

### `youtube_playlist_items`

从 YouTube 播放列表中获取视频。

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | 字符串 | 是 | YouTube 播放列表 ID |
| `maxResults` | 数字 | 否 | 返回视频的最大数量 |
| `pageToken` | 字符串 | 否 | 分页的页面令牌 |
| `apiKey` | 字符串 | 是 | YouTube API 密钥 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `items` | 数组 | 播放列表中的视频数组 |

### `youtube_comments`

从 YouTube 视频中获取评论。

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `videoId` | 字符串 | 是 | YouTube 视频 ID |
| `maxResults` | 数字 | 否 | 返回评论的最大数量 |
| `order` | 字符串 | 否 | 评论排序方式：时间或相关性 |
| `pageToken` | 字符串 | 否 | 分页的页面令牌 |
| `apiKey` | 字符串 | 是 | YouTube API 密钥 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `items` | 数组 | 视频评论的数组 |

## 注意事项

- 类别：`tools`
- 类型：`youtube`
