mk-youtube-search

📁 kouko/monkey-knowledge-youtube-skills 📅 3 days ago

总安装量

周安装量

#70315

全站排名

安装命令

npx skills add https://github.com/kouko/monkey-knowledge-youtube-skills --skill mk-youtube-search

Agent 安装分布

mcpjam 2

command-code 2

claude-code 2

junie 2

windsurf 2

zencoder 2

Skill 文档

YouTube Search

Search YouTube videos and list results.

Quick Start

/mk-youtube-search <query> [count] [mode]

Parameters

Parameter	Required	Default	Description
query	Yes	–	Search keywords
count	No	10	Number of results
mode	No	fast	`fast` or `full` (see below)

Mode Selection

Mode	Speed	Metadata	Use When
`fast`	~1-2s	Basic (no upload_date)	General searches, topic exploration
`full`	~5-8s	Complete (includes upload_date, description)	Time-sensitive searches, recent content

When to use full mode:

User asks for “recent” or “latest” videos on a topic
Search query includes time indicators (e.g., “2024”, “this week”, “new”)
User wants to sort or filter by upload date
Content is time-sensitive (news, events, updates)

When to use fast mode (default):

General topic searches
Tutorial or educational content
Evergreen content that doesn’t require recency

Examples

/mk-youtube-search AI tutorial â fast mode (general topic)
/mk-youtube-search "machine learning" 10 â fast mode
/mk-youtube-search "Claude AI news" 5 full â full mode (time-sensitive)
/mk-youtube-search "latest iPhone review" 10 full â full mode (recent content)

How it Works

Execute: {baseDir}/scripts/search.sh "<query>" <count> <mode>
Parse JSON output
Write video metadata to centralized store (/tmp/monkey_knowledge/youtube/meta/)
Display results in table format

Output Format

#	Title	Channel	Duration	Views	Upload Date	URL
1	…	…	10:23	1.2M	2024-01-15	https://…

Note: Upload Date is only available in full mode.

JSON Output

{
  "status": "success",
  "videos": [
    {
      "video_id": "dQw4w9WgXcQ",
      "title": "Video Title",
      "url": "https://www.youtube.com/watch?v=...",
      "channel": "Channel Name",
      "channel_url": "https://www.youtube.com/channel/UC...",
      "duration_string": "10:23",
      "view_count": 1234567,
      "upload_date": "20240115",
      "live_status": "not_live",
      "description": "First 200 chars..."
    }
  ]
}

Note: In fast mode, upload_date, live_status, and description will be null.

Notes

Default result limit: 10 videos
Default mode: fast (use full for time-sensitive searches)
Uses system yt-dlp/jq if available, otherwise auto-downloads on first run
Search results are saved to centralized metadata store for use by other skills (only in full mode)

GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台