Turn public YouTube video URLs into transcript text and video metadata for research, analysis, and content workflows.
概要
YouTube 検索には、ブランド、製品、話題に関連するさまざまなクリエイターの動画が集まります。このアプリは公開検索結果を表にまとめ、各ページを手作業で整理することなく、タイトル、チャンネル、公開日時、長さ、視聴状況を比較できるようにします。
各動画に検索キーワードを残すことで、コンテンツ調査の基準をそろえられます。特定の検索語で見つかるクリエイターや話題を比較し、キャンペーンに関連する動画を確認し、詳しく調べるために元の動画へのリンクを保持できます。
データについて
各行は YouTube の公開検索結果の一件を表します。「公開期間」と「収集の優先基準」によって収集対象が変わります。結果は「公開日時」の新しい順に並び、重複する「動画ID」は一度だけ残ります。
「再生回数」「登録者数」「再生時間ms」は情報源のテキストを保持します。「表示再生時間」は画面に表示された長さ、「表示公開」は元の相対時間表現です。「公開日時」と「収集日時」のタイムゾーンは明示されていません。画像、バッジ、「動画要約」も提供されたテキスト表現を保持します。
チャンネル情報、共同制作者情報、要約は空の場合があります。空値は情報源がその情報を提供していないことを意味し、登録者がゼロであることや認証されていないことを意味しません。対象は公開検索結果に限られ、コメント、文字起こし、非公開動画、検索結果にない情報は含まれません。
結果の例
各行は、キーワード検索で返された公開動画の一件です。
| 動画タイトル | チャンネル名 | 動画URL | 再生回数 | 公開日時 | 表示再生時間 |
|---|---|---|---|---|---|
| PACK WITH ME: MALDIVES! 🧳🌴 2-week beach holiday, long-haul flight essentials & how I pack it all 👙 | Brogan Tate | https://www.youtube.com/watch?v=AVHljwcqB7s | 11541 | 2026-10-16T01:22:36 | 37:48 |
| Shokz OpenFit Pro Review: I Put Them Through a Hybrid Workout | Gritty Soldier | https://www.youtube.com/watch?v=AWkCGpRAdcM | 3649 | 2026-10-15T23:22:36 | 10:36 |
情報源に含まれる場合は、「動画ID」「チャンネルID」「チャンネルハンドル」「チャンネルバッジ」「チャンネル説明」「登録者数」「動画要約」も取得できます。
活用例
- ブランド調査では、「キーワード」「動画タイトル」「チャンネル名」を比較し、その検索語で見つかるクリエイターや話題を把握します。
- 競合の動向確認では、「公開日時」「再生回数」「認証チャンネル」を比較し、最近のコンテンツと公開された視聴反応を確認します。
- コンテンツ企画では、「動画タイトル」と「動画説明」「動画要約」「表示再生時間」を合わせて読み、テーマや形式を比較します。
- クリエイター調査では、「チャンネルハンドル」「チャンネルURL」「登録者数」を組み合わせ、「動画URL」から元の動画を確認します。
適用範囲と境界
1回のタスクにつきYouTube検索キーワードは1つ、期待件数は1〜600件。結果は20件単位の完全バッチで返り、切り上げられる場合があります。対象は公開のキーワード検索一覧のみで、プラットフォームが返す動画は最大600件です。
- 適している用途
- 1つのキーワードに対する公開のYouTube検索一覧が必要なとき。動画タイトル、チャンネル、再生回数、公開日時を含みます。
- 同じ検索キーワードで競合動画がどう並ぶかを比較したいとき。
- 適さない用途
- コメント、文字起こし、チャンネルの全ホームが必要な場合。このAppが返すのはキーワード検索一覧のみです。
- 非公開、限定公開、ログイン後のみのYouTubeデータが必要な場合。このAppは公開検索結果のみです。
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1動画が1件も返らない場合は、より一般的なキーワードに変えて、公開YouTubeで検索できることを確認してください。
- 2部分成功の完了レコードは残し、失敗または期限切れのタスクは同じ入力で再提出してください。
- 3レート制限、一時的な利用不可、タイムアウトの後は時間をおいて再試行してください。
- 4認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- 検索キーワード
keyword必須stringYouTubeで検索するブランド、商品、トピック、語句です。1回のタスクで受け付けるキーワードは1つ、1〜512文字です。例Shokz - 期待収集件数
crawl_count必須integer期待する動画件数です。1〜600。結果は20件単位の完全バッチで返るため、実際の件数は切り上げられる場合があります。20件未満でも20件として課金されます。範囲1–600例1 - 公開期間
time_range任意string(enum)検索する動画の公開期間を今日、今週、今月、今年から選択します。省略時は今月です。選択可能な値今日today今週week今月month今年toyearデフォルトmonth - 収集の優先基準
priority_filter任意string(enum)関連性の高い動画または人気の高い動画を優先して収集します。省略時は関連性を優先し、返却結果は公開日時の新しい順に並びます。選択可能な値関連性relevance人気hotデフォルトrelevance
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- チャンネルバッジ
account_badge_liststringチャンネルに表示されるバッジ。ある場合はJSONテキストで返ります。 提供されない場合は空値です。例["Verified"] - チャンネルハンドル
account_display_idstringチャンネルの公開ハンドル。表示される場合は@付きです。 提供されない場合は空値です。例@brogantatexo - チャンネルID
account_idstringこの一覧を公開したチャンネルの安定したYouTubeチャンネルIDです。 提供されない場合は空値です。例UCbk7poTBSh1x6aNg_IjLu9Q - チャンネル名
account_namestringこの一覧を公開したチャンネルの表示名です。 提供されない場合は空値です。例Brogan Tate
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"account_badge_list": "[\"Verified\"]",
"account_display_id": "@brogantatexo",
"account_id": "UCbk7poTBSh1x6aNg_IjLu9Q",
"account_name": "Brogan Tate",
"article_type": "video",
"biz_id": "Shokz",
"channel_banner_url": "<channel_banner_url>",
"channel_description": "<channel_description>",
"channel_description_links": "<channel_description_links>",
"channel_thumbnail_list": "[{\"height\": 68, \"url\": \"https://yt3.ggpht.com/p5mrXo8WXN1Jp7eoZCTgxODfWtE2oGOYu-5OMXrjTwxzbvnfj40PzEQZZz44gRqb0sPHb8rnJg=s68-c-k-c0x00ffffff-no-rj\", \"width\": 68}]",
"channel_total_videos": "<channel_total_videos>",
"channel_url": "<channel_url>",
"co_creator_info": "<co_creator_info>",
"content_badge_list": "[\"New\", \"4K\"]",
"content_id": "AVHljwcqB7s",
"content_rich_thumbnail_list": "<content_rich_thumbnail_list>",
"content_status": "RUNNING",
"content_text": "Welcome to my Maldives pack with me! We're spending 2 weeks exploring some of the best resorts, in partnership with ...",
"content_title": "PACK WITH ME: MALDIVES! 🧳🌴 2-week beach holiday, long-haul flight essentials & how I pack it all 👙",
"content_url": "https://www.youtube.com/watch?v=AVHljwcqB7s",
"cover_image_list": "[{\"height\": 202, \"url\": \"https://i.ytimg.com/vi/AVHljwcqB7s/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLDafd0r3K9Ai8G8i9ms4_dN7sOPWQ\", \"width\": 360}, {\"height\": 404, \"url\": \"https://i.ytimg.com/vi/AVHljwcqB7s/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAJk-jvivrEgKRoyb9Ni3XTMjbHtQ\", \"width\": 720}]",
"crawl_time": "2026-10-16T14:22:36",
"is_collaboration": false,
"is_verified": true,
"is_verified_artist": false,
"keyword": "Shokz",
"keyword_type": "keyword",
"list_order": 0,
"number_of_subscribers": "<number_of_subscribers>",
"publish_time": "2026-10-16T01:22:36",
"raw_duration": "37:48",
"raw_publish_time": "13h ago",
"video_duration": "2268000",
"video_summary": "{\"summary\": \"Brogan Tate demonstrates effective organization strategies for a two-week tropical trip by categorizing clothing, tech, and toiletries into various packing cubes. These methods optimize luggage space for domestic transfers while ensuring all necessary travel essentials and camera gear are readily available for documenting the upcoming vacation across three different island resorts.\", \"title\": \"AI-generated video summary\"}",
"view_count": "11541",
"view_count_text": "11,541 views",
"task_item": "Shokz",
"no_data": false
}連携方法
この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます:キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。
MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。
クライアント設定
Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/youtube-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。
detail.access.mcp.composeHint
料金
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。