YouTubeの検索キーワードと期待件数を指定すると、一致する公開動画、チャンネル、再生回数、公開日時を取得します。
概要
WeChat動画アカウントでトピックの現れ方を調べると、動画、投稿者、反応数が並ぶ検索画面から後で比較しにくい状態になりがちです。このアプリは1つの検索キーワードを、一致する公開動画の構造化セットにします。各レコードは動画、投稿アカウント、公開日時、収集時点で見えた反応数をまとめて保持するため、検索画面を手で再構成せずに絞り込み、順位付け、結合ができます。
結果は、ブランド、商品、トピック、キャンペーンに対して公開のWeChat動画アカウントコンテンツがどれだけ見つかるかを問う調査に向きます。検索ページから項目を控えるのに比べ、識別子、公開リンク、タイトル、反応数を1つの表に残せるため、モニタリングや投稿者調査に再利用できます。
データについて
各レコードは指定したキーワードに関連するWeChat動画アカウントの動画1件です。返却データセット内ではコンテンツIDで重複を除きます。コンテンツタイトルには提供元ページの検索ハイライト用タグが含まれる場合があります。いいね数、コメント数、転送数、お気に入り数、動画の長さは数値文字列として保存されます。収集日時、公開日時、公開日時テキストは提供元の表記に従い、タイムゾーンは明示されていません。公開日時と公開日時テキストは同じ公開時点の2つの表し方です。一致キーワードと元の検索項目は検索コンテキストを保持し、同一タスクの多くのレコードで繰り返される場合があります。
対象はWeChat動画アカウントのキーワード検索で見つかる公開動画です。削除済み、非公開、ログイン限定、検索できないコンテンツは範囲外です。データなしフラグは、一致コンテンツがないタスクメタデータと通常の一致レコードを区別します。
結果の例
各行は検索キーワードに関連する一致WeChat動画アカウント動画、またはデータなしフラグです。
| コンテンツID | アカウント名 | 公開日時 | いいね数 | コメント数 |
|---|---|---|---|---|
| 15015532379656687235 | 新能源产业家 | 2026-09-21T19:42:27 | 243 | 14 |
| 15016005683093052072 | 娟姐储能设备 | 2026-09-22T11:22:49 | 5 | 0 |
コンテンツタイトル、コンテンツURL、カバーURL、お気に入り数、転送数、動画の長さ、一致キーワード、元の検索項目、データなしフラグも、レコードに含まれる場合は利用できます。
活用シーン
- トピック発見では、一致キーワードごとに行をまとめ、いいね数、コメント数、コンテンツタイトルを比べて、その語句で注目を集める公開動画を見ます。
- 投稿者調査では、アカウント名、アカウントID、反応数列を組み合わせて、検索に現れる投稿アカウントを候補にします。
- モニタリングでは、キーワード収集を繰り返し、コンテンツIDの集合を比較し、新たに観測された項目の文脈として公開日時と収集日時を使います。
- 後続確認では、コンテンツURLを開き、データなしフラグで空検索のメタデータと使える一致動画を分けます。
適用範囲と境界
1タスクにつきWeChat動画アカウントのキーワードは1つ、最大200件です。実際の返却件数はこの指定を超えず、公開のキーワード検索一覧に限定されます。
- 適している用途
- ブランド、商品、トピック、キャンペーンに関する公開のWeChat動画アカウント動画を見つけたい場合。
- 動画、投稿アカウント、日時、反応数を含む構造化データセットがコンテンツ調査に必要な場合。
- 適さない用途
- 個別動画のコメントが必要な場合。このアプリはキーワード検索結果を返し、コメント詳細は返しません。
- WeChat動画アカウントの動画ではなく、WeChat公式アカウントの記事が必要な場合。
- 削除済み、非公開、ログイン限定、または検索できないWeChat動画アカウントのコンテンツが必要な場合。
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1一致レコードがない場合はキーワードを短くするか言い換えて、新しいタスクを提出してください。
- 2一部成功では完了済みレコードを保持し、失敗または期限切れでは同じ入力で再実行してください。
- 3レート制限、一時的なサービス障害、タイムアウトの後は時間を置いて再試行し、認証失敗時は実行環境の認証情報を確認してください。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- 検索キーワード
keyword必須stringWeChat動画アカウントで検索するブランド、商品、トピック、または語句です。1タスクにつき1~512文字のキーワードを1つ指定します。例家庭储能 - 最大結果件数
crawl_count必須integer収集する検索結果の上限で、1~200です。実際に返るレコード数はこの値を超えません。範囲1–200例10
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- コンテンツID
content_idstring一致したWeChat動画アカウントの動画の一意識別子です。例15015532379656687235 - 一致キーワード
keywordstring収集された動画に関連付けられた検索キーワードです。例家庭储能 - アカウントID
account_idstring投稿したWeChat動画アカウントの識別子です。例v2_060000231003b20faec8c7e18e19c4d5cd05eb3cb077c3f088abc955ba40c89baec0c58b0c18@finder - アカウント名
account_namestring投稿アカウントの表示名です。例新能源产业家
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"content_id": "15015532379656687235",
"keyword": "家庭储能",
"account_id": "v2_060000231003b20faec8c7e18e19c4d5cd05eb3cb077c3f088abc955ba40c89baec0c58b0c18@finder",
"account_name": "新能源产业家",
"account_type_code": "0",
"content_title": "充电宝王者居然在<em class=\"highlight\">储能</em>圈也跑出来了?从充电宝到<em class=\"highlight\">家庭</em>电站,安克、征拓、华宝新能正在一个137亿元的新市场里跑出“阳台<em class=\"highlight\">储能</em>新三强”。德国之后,英国也开始打开大门。#阳台<em class=\"highlight\">储能</em> #<em class=\"highlight\">家庭储能</em> #安克 #征拓 #华宝新能 #新能源产业家",
"content_url": "https://channels.weixin.qq.com/web/pages/feed?oid=0GHjJMLQDoM",
"cover_url": "https://finder.video.qq.com/251/20304/stodownload?encfilekey=KGDRibp2wkicJJttENJ1KpebhW9z91Yf1ttKlnBJtdMoTVUcduetpbf2pDVsu5ucd1nKr7SyrnoAGZhbXyicz37jQ&token=AxricY7RBHdV9VAsjV5rJCn5y1LxQYBzDovALm8HnI0fxBYQX5sEKguahsHknRHeDzkiaaKuFGAODMbwrlakDqDE1utbHJFZVTU5qLDDNPxfudEH7OtgoLZteM3FhGqsG5pQ583iaQIkYBpHNdPVib5ZclUV6Zs3Jb5d2zvibNEEicpHoEvX1BYQ6f6SFk0R6oGOnwEW5JEygXEdribiaiadBawricsfYiazG3d44Km&hy=SH&idx=1&m=&scene=2&uzid=1&picformat=200&wxampicformat=503",
"like_count": "243",
"comment_count": "14",
"forward_count": "1714",
"collect_count": "421",
"video_duration": "248",
"publish_time": "2026-09-21T19:42:27",
"publish_time_text": "2026-09-21 19:42:27",
"crawl_time": "2026-09-22T14:44:21",
"source_item": "家庭储能",
"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=super_ig/wechat-video-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 50 件を 1 つの課金単位とし、端数は 50 件に切り上げて課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。