hyperfx-ai/marketing-skills

youtube

Work with YouTube content end to end — fetch transcripts and turn them into summaries, blog posts, social content, quotes, or show notes; create high-CTR thumbnails (with the user's face from an upload), clone the style of top-ranking thumbnails; and produc…

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/hyperfx-ai/marketing-skills --skill youtube

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

YouTube

Fetch the full transcript of any YouTube video and turn it into whatever the user needs — summaries, blog posts, social content, quotes, show notes, or raw text. Then package videos for upload: high-CTR thumbnails, SEO titles, and descriptions.

Routing

User intentWhere to go
Transcript, summary, repurposing, quotes, chaptersThis guide (below)
Thumbnails, style cloning, SEO titles/descriptionsreferences/thumbnails.md

Requirements

If youtube_video_transcripts_fetch is not in the tool list, stop and tell the user to enable the YouTube toolkit in Hyper.

Two tools — pick the right one

ToolWhen to useReturns
youtube_video_transcripts_fetchYou need the raw transcript text or timestamped segments. Fast, reliable, always get this first.Full text string + segments with start/duration timestamps
youtube_videos_readYou need AI-powered extraction from the video — summaries, Q&A, topic segmentation, translation, visual descriptions.Free-form answer to your instruction

Default: start with `youtube_video_transcripts_fetch`. Use youtube_videos_read when you need something the raw text can't give you (e.g. visual descriptions, translation, or a structured extraction from a very long video).

Critical rules

  1. `youtube_video_transcripts_fetch` takes 15–30 seconds. It spins up an isolated sandbox. Tell the user it's running and to expect a short wait — don't make them think it's stuck.
  2. Both video IDs and full URLs are accepted. "NZLAdOL9fP8" and "https://www.youtube.com/watch?v=NZLAdOL9fP8" both work.
  3. Don't fabricate transcript content. Always fetch before summarizing. Never rely on training knowledge about what a specific video says.
  4. Very long videos (>2 hours): youtube_video_transcripts_fetch handles these fine. Only use youtube_videos_read on long videos if you specifically need AI-powered extraction — it can hit token limits on very long content.
  5. No transcript available: Some videos have transcripts disabled. If youtube_video_transcripts_fetch fails, try youtube_videos_read as a fallback — it uses a different extraction method.

Fetching the transcript

python
youtube_video_transcripts_fetch(
    video_id_or_url="https://www.youtube.com/watch?v=NZLAdOL9fP8",
    language="en"   # optional — omit to auto-detect
)

Response structure:

json
{
  "success": true,
  "video_id": "NZLAdOL9fP8",
  "language": "English (auto-generated)",
  "text": "Full transcript as one string...",
  "segments": [
    { "text": "This week we launched Hyper MCP.", "start": 0.0, "duration": 3.2 },
    { "text": "It brings Hyper's built-in tools...", "start": 3.2, "duration": 4.1 }
  ],
  "total_duration": 342.0
}

Use text for most tasks. Use segments when you need timestamps (e.g. chapters, clip references, karaoke captions).

Using youtubevideosread for AI-powered extraction

python
youtube_videos_read(
    url="https://www.youtube.com/watch?v=NZLAdOL9fP8",
    instruction="Summarize the key points. Then list the main features demonstrated, with timestamps."
)

Good instruction examples:

  • "Extract every claim made about pricing or cost."
  • "List the action items mentioned, in order."
  • "Translate this to Spanish."
  • "What tools or products does the speaker mention by name?"
  • "Identify the main sections of this video and give me a timestamp for each."

What to do with the transcript

Once you have the text, ask the user what they need — or infer it from context:

What the user wantsWhat to produce
Blog postRestructure the transcript into intro → sections → CTA. Clean up filler words. Add subheadings.
LinkedIn / Twitter postExtract the 1–2 sharpest insights. Rewrite in first person if it's the user's own video.
Summary3–5 bullet points of key takeaways.
Show notes / descriptionTitle, 2-sentence summary, timestamped chapters, links mentioned.
Quote extractionPull verbatim quotes with start timestamps from the segments array.
Repurpose for emailRewrite as a narrative email — opening hook, key insight, CTA.
Research / competitive analysisSummarize what the speaker claims, what products they recommend, and what pain points they describe.

Thumbnails and SEO packaging

For making or refreshing thumbnails, cloning the style of top-ranking thumbnails, adding the user's face, and generating SEO titles/descriptions, read references/thumbnails.md. Every thumbnail workflow is a sandbox script under scripts/ (generate_thumbnail.py, research_top_thumbnails.py, clone_top_thumbnail_style.py, analyze_thumbnail_concepts.py, generate_seo_titles.py, generate_seo_description.py) — the reference doc is the routing table and the rules for using them.

Example outputs

Input: "Get the transcript of https://www.youtube.com/watch?v=NZLAdOL9fP8 and write a LinkedIn post from it"

Flow:

  1. Call youtube_video_transcripts_fetch(video_id_or_url="https://www.youtube.com/watch?v=NZLAdOL9fP8")
  2. Read the returned text
  3. Identify the 1–2 sharpest moments — what's surprising, useful, or quotable
  4. Draft a LinkedIn post in the speaker's voice (first person) with a hook and a clear point

Input: "Summarize this video for me: [URL]"

Flow:

  1. Call youtube_video_transcripts_fetch(video_id_or_url="[URL]")
  2. Return 4–6 bullet points of key takeaways, without padding or filler

Input: "Make me a thumbnail like the top videos for 'AI agents'"

Flow:

  1. Read references/thumbnails.md
  2. Run scripts/clone_top_thumbnail_style.py with query="AI agents" and the user's topic
  3. Show the top thumbnails, let the user pick a rank, re-run with chosen_rank to generate

Related skills

When to hand offSkill
Mining comments from YouTube videos for customer research`customer-research`
Finding top YouTube videos by topicUse youtube_videos_search_top directly
Generating video content`video-generation`

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills
hyperfx-ai
社区

meta-ads-library

Research competitor Facebook and Instagram ads from the Meta Ads Library via the Hyper MCP — search by keyword, pull full ad creative and metadata, enrich with page contact info for lead generation, and surface structured ad-intelligence summaries in chat. Use when the user wants to scrape the Meta Ads Library, spy on competitor ads, monitor new ads in a category, build a lead list from advertisers, or surface creative trends across an industry.

1小时安装量
1
GitHub Stars
116
最近更新
11月21日
hyperfx-ai
社区

blog-generation

Generate one excellent, on-brand blog post per run for any business, built to rank on Google and get cited by AI search (ChatGPT, Claude, Perplexity, AI Overviews). A stateful engine: reads a brand strategy doc, picks a fresh topic (never repeats), researches, writes in the brand's voice, and logs the post back. Use when the user wants to write a blog post, run a daily or recurring blog task, or generate SEO / AEO / blog content. For keyword data and audits, defer to seo-research.

1小时安装量
1
GitHub Stars
91
最近更新
9月26日
hyperfx-ai
社区

reddit-ads

Plan and create Reddit Ads campaigns end-to-end via the Hyper MCP — campaign, ad group, ad build order with subreddit / interest / geo targeting, promoted posts, custom and saved audiences, Reddit pixel conversion tracking, and reporting, with micro-currency budgets. Use when the user wants to launch Reddit ads, promote a Reddit post, target subreddits, set up a Reddit pixel, or pull Reddit ad reports. Also triggers on reddit campaign, reddit ppc, or reddit ads manager.

1小时安装量
1
GitHub Stars
91
最近更新
9月26日
hyperfx-ai
社区

ad-creative-generation

Generate on-brand ad creatives — visuals + copy — for Google, Meta (Facebook / Instagram), and other paid platforms via the Hyper MCP. Extracts brand identity from a website, writes ad copy variants, and produces brand-consistent images using reference-based image generation. Use when the user asks for ad creative, ad copy variants, RSA headlines, Meta ad creative, display ads, carousel ads, or A/B test variants.

1小时安装量
1
GitHub Stars
83
最近更新
8月25日