---
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` | string | はい | YouTube動画の検索クエリ |
| `maxResults` | number | いいえ | 返す動画の最大数 |
| `apiKey` | string | はい | YouTube APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `items` | array | 検索クエリに一致するYouTube動画の配列 |

### `youtube_video_details`

特定のYouTube動画に関する詳細情報を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `videoId` | string | はい | YouTube動画ID |
| `apiKey` | string | はい | YouTube APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `videoId` | string | YouTube動画ID |
| `title` | string | 動画タイトル |
| `description` | string | 動画の説明 |
| `channelId` | string | チャンネルID |
| `channelTitle` | string | チャンネル名 |
| `publishedAt` | string | 公開日時 |
| `duration` | string | ISO 8601形式の動画の長さ |
| `viewCount` | number | 視聴回数 |
| `likeCount` | number | 高評価数 |
| `commentCount` | number | コメント数 |
| `thumbnail` | string | 動画サムネイルURL |
| `tags` | array | 動画タグ |

### `youtube_channel_info`

YouTubeチャンネルに関する詳細情報を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `channelId` | string | いいえ | YouTubeチャンネルID（channelIdまたはusernameのいずれかを使用） |
| `username` | string | いいえ | YouTubeチャンネルのユーザー名（channelIdまたはusernameのいずれかを使用） |
| `apiKey` | string | はい | YouTube APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `channelId` | string | YouTubeチャンネルID |
| `title` | string | チャンネル名 |
| `description` | string | チャンネルの説明 |
| `subscriberCount` | number | 登録者数 |
| `videoCount` | number | 動画数 |
| `viewCount` | number | チャンネル総再生回数 |
| `publishedAt` | string | チャンネル作成日 |
| `thumbnail` | string | チャンネルサムネイルURL |
| `customUrl` | string | チャンネルカスタムURL |

### `youtube_playlist_items`

YouTubeプレイリストから動画を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | YouTubeプレイリストID |
| `maxResults` | number | いいえ | 返す動画の最大数 |
| `pageToken` | string | いいえ | ページネーション用のページトークン |
| `apiKey` | string | はい | YouTube APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `items` | array | プレイリスト内の動画の配列 |

### `youtube_comments`

YouTube動画からコメントを取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `videoId` | string | はい | YouTube動画ID |
| `maxResults` | number | いいえ | 返すコメントの最大数 |
| `order` | string | いいえ | コメントの並び順：time（時間順）またはrelevance（関連性順） |
| `pageToken` | string | いいえ | ページネーション用のページトークン |
| `apiKey` | string | はい | YouTube APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `items` | array | 動画からのコメントの配列 |

## 注意事項

- カテゴリー: `tools`
- タイプ: `youtube`
