youtube-research

YouTube リサーチ

PostPlus を通じて、公開されている YouTube チャンネルの概要、視聴者コメントのサンプル、ダウンロード可能な動画レコード、公開動画の指標を調べる場合にこのスキルを使用します。

収集範囲の境界

公開されている収集データからは、登録者の個人を特定できません。チャンネルのメタデータとコメントを公開情報に基づく代替指標として使用し、コメント投稿者を登録者層として示さないでください。

リサーチの経路

公開動画レコードには youtube-videos、チャンネル情報には youtube-channel-summary、視聴者が使う言葉の調査には youtube-comments を使用します。ダウンロード可能なレコードが明示的に必要な場合に限り、youtube-video-download を使用してください。実行の詳細は PostPlus が処理します。

エビデンスの品質

1. チャンネル情報、動画レコード、コメントが質問に即しているか確認してください。コメント投稿者は登録者全体を代表するものではありません。
2. 処理が完了しても該当する結果が得られなかった場合は、スニペットをコメントとして扱わず、チャンネルや動画の情報源、またはサポートされているクエリを見直してください。
3. 成功したものの結果が不十分な場合、承認された範囲と予算内で、変更を加えた追加パスは最大 2 回までにしてください。同一のリクエストを繰り返したり、失敗または保留中の操作を隠したりしないでください。
4. 十分な情報が得られたとき、上限に達したとき、または追加パスが役に立たないときは停止してください。有用なエビデンスと不確実性を報告し、生の結果と情報源へのリンクを保持してください。

公開動画の指標は特定時点の記録です。情報源の URL と日付を保持し、登録者の個人を推測しないでください。 機械処理用の全フィールドは postplus research schema --route <route> --json にあります。処理に必要な場合にのみ参照し、リクエストのたびに確認する必要はありません。

postplus research run youtube-channel-summary \
  --channel "@example" \
  --wait \
  --output ./result.json

CLI の構造化された結果と報告された次のアクションに従ってください。自由記述のメッセージから復旧方法を推測しないでください。 依頼された範囲と最大費用をすでにカバーするユーザーの明示的な承認がある場合は、それを再利用してください。それ以外の場合は、見積もりを確定する前に承認を得てください。タスクを依頼されたことだけを根拠に、支出の許可を推測してはいけません。 返されたチェックポイントまたはアクションを使って同じ操作を再開してください。不確かな処理を再送信したり、試行上限に達した復旧を繰り返したり、失敗を回避するためにプロバイダーを切り替えたりしないでください。

デフォルトのワークフロー

1. チャンネルを調べる場合は、チャンネル概要を収集します。
2. 視聴者を調べる場合は、少量のコメントサンプルを収集します。
3. 公開動画を広く探す場合は、少数の公開動画を対象とする計画を作成し、youtube-videos 経路を実行します。
4. 実行が保留中の場合は、結果ファイルを保持し、postplus research run --resume-from <result.json> で再開します。
5. 特に視聴者に関する主張では、観察結果と推論を区別してください。

実行が保留中の間は、保存済みのチェックポイントからリサーチを継続していることをユーザーに伝え、並行して依頼内容の確認や情報源の確認を進めてください。

動画レコードを読む

youtube-videos のレコードは output.items[] から読み取ります。フィールドは id、url、title、text（説明）、date、viewCount、likes、commentsCount、channelName、channelUrl、channelUsername、numberOfSubscribers、thumbnailUrl です。フィールドは省略される場合があります。存在しない指標は利用不可として示し、ゼロとしないでください。

duration は数値の秒数ではなく、時刻文字列（HH:MM:SS）です。既存の字幕は srt、language、type を含む subtitles[] に表示されます。タイムスタンプと言語をそのまま保持してください。字幕がない場合は、取得された字幕がないことを意味します。説明文を文字起こしの代わりにしたり、新たな音声の文字起こしを行ったかのように示したりしないでください。

hashtags は動画のタグ全体ではありません。isPaidContent は有料アクセスを意味し、スポンサー付きコンテンツを意味するものではありません。スポンサー情報は利用できません。確認できない場合は不明としてください。チャンネルの年齢制限を、動画の年齢制限が確認済みであるかのように解釈しないでください。このメタデータ経路ではダウンロード URL と画質は提供されません。依頼があった場合に限り、別のダウンロード経路を使用してください。

出力

チャンネルのメタデータ、公開動画レコード、コメントサンプルから得られた知見、情報源の URL、実際に存在した指標フィールドを提示し、登録者の個人を特定できないことを明確に記してください。

失敗時の対応

• リクエストにYouTube以外のプラットフォームが含まれている場合は、停止してください。
• 使用できる公開YouTube URL、チャンネル、または検索クエリがない場合は、停止してください。
• PostPlusでチャンネルのハンドルまたはURLを解決できない場合は、停止してください。
• PostPlusのサービス、認証、DNS、プロキシ、ネットワーク、または不正な出力に関する致命的なエラーが発生した場合は、停止してください。
• 非公開の視聴者の身元や、ログインが必要な分析情報について約束しないでください。

引き継ぎ

ベンチマークの調査結果は、benchmark-to-brief、media-analysis、またはより広範なクロスプラットフォームの統合分析に活用できます。

公開コマンドの境界

• ユーザーの入力に合致する最小のコマンドまたはワークフローを選択し、そのまま実行してください。

• 準備状況の診断：postplus doctor --skill youtube-research。

• ルートを調べる必要がある場合に限り、postplus research run <route> --helpを実行してください。

• postplus research run <route> --<url/channel flags> --limit <n> --wait --output <result.json>を実行してください。

• 選択したルートに示されている意味的なフラグのみを使用してください。

• 最初の調査は範囲を絞り、結果を確認してからのみ対象を広げてください。

• 依頼されたタスクでは、現在の価格と残高を確認したうえで、既存のPostPlusクレジットを使用してください。 見積もりのみの依頼では実行しません。クレジットが不足している場合は停止してください。チャージやサブスクリプションの購入を行わず、結果が不確かな有料操作を繰り返さないでください。