360 Secure SkillHub
360 安全技能中心

SocialKit YouTube Research

针对用户指定的 YouTube 主题，调用 YouTube Data API v3 检索高播放视频及统计数据，分析标题模式、内容角度与未覆盖空白，并在项目目录生成含视频表格与选题建议的 research.md。需自备 YT_API_KEY。

分类：搜索
ahmadhussain0335
ahmadhussain0335
热度 36.30
最近更新 2026-11-06 15:11:47

安装

发给 Agent
帮我安装这个技能：npx secure-skills-cli add ahmadhussain0335/socialkit-youtube-research
兼容性
通用兼容
联网要求
需要联网
数据出网
必须出网
Metadata
name
socialkit-youtube-research
description
Researches a YouTube topic with the official YouTube Data API v3 - top videos, view and engagement statistics, titles, tags and gaps - and writes research.md for a video project. Use when the user wants topic ideas, competitor or trend research, or evidence for a YouTube video.
license
MIT
metadata
{"author":"Ahmad Hussain","platform":"youtube","requires":"socialkit-social-core"}

YouTube research

Requires YT_API_KEY. If it is missing, point the user to setup.

Steps

  1. Agree on 1-3 search queries with the user, plus region and language if relevant.
  2. For each query run: node scripts/research.mjs --query "<terms>" --max 15 --order viewCount Add --published-after <ISO date> for recent trends. Output is JSON on stdout. Each query costs one call from the 100/day search bucket; do not loop over many queries without asking.
  3. Analyse: recurring angles, title patterns, typical length, views per day since publishing, and what the top videos do not cover.
  4. Write research.md in the project folder with: queries used, a table of the top videos (title, channel, views, published, URL), patterns, gaps, and 3-5 proposed angles. Cite video URLs for every claim.

Rules

  • Research informs an original video. Do not copy titles, scripts or thumbnails.
  • Only report numbers from the script output. Do not estimate missing statistics.

Failure handling

  • YT_API_KEY_MISSING: stop and show the setup steps.
  • YT_QUOTA_EXCEEDED or YT_QUOTA_ESTIMATE_EXHAUSTED: stop; quotas reset at midnight Pacific Time.
  • Empty results: suggest broader terms; do not invent results.