Metadata-Version: 2.4
Name: youtube-skillbox
Version: 0.4.13
Summary: Free YouTube research toolkit — search, keywords, competition, rank tracking, SEO scorecard, outliers, content gap, trends. No user-supplied YouTube Data API key required.
Home-page: https://github.com/hackers-reality/youtube-skillbox
Author: hackers-reality
Author-email: hackers-reality <phulariarnav@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/hackers-reality/youtube-skillbox
Project-URL: Repository, https://github.com/hackers-reality/youtube-skillbox
Project-URL: Issues, https://github.com/hackers-reality/youtube-skillbox/issues
Project-URL: Documentation, https://github.com/hackers-reality/youtube-skillbox#readme
Project-URL: Changelog, https://github.com/hackers-reality/youtube-skillbox/blob/main/CHANGELOG.md
Project-URL: Funding, https://github.com/sponsors/hackers-reality
Keywords: youtube,seo,keyword,research,rank,tracking,competition,analysis,outliers,trends,scorecard,content-gap,transcript,shorts,metadata,api-free
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Linguistic
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yt-dlp>=2026.10.26
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Requires-Dist: pytest-cov>=4.0; extra == "test"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# YouTube Skillbox

Free YouTube research toolkit — search, keywords, competition, rank tracking, SEO scorecard, outliers, content gap, trends. No user-supplied YouTube Data API key required.

## Quick Start

```bash
pip install youtube-skillbox
ytdata --help
```

## Commands

| Command | Description |
|---------|-------------|
| `search <query>` | Search YouTube videos (locale-pinned via `--gl`/`--hl`) |
| `channel <handle>` | List channel uploads / shorts / streams |
| `latest <handle>` | Most recent uploads |
| `info <url>` | Full metadata for one video (views, likes, tags, description) |
| `scorecard <url>` | SEO checklist for a video (title/desc/tags/keyword fit) |
| `outliers <handle>` | Videos overperforming their channel (views/subs ratio) |
| `keywords <seed>` | Keyword ideas + relative volume from YouTube suggest |
| `compete <query>` | Competition score (0–100) from live SERP |
| `trends <seed>` | Historical trend for a seed keyword |
| `track <query> --video <url>` | Rank tracking for a video |
| `gap <seed> --competitor <handle>` | Content gap analysis |
| `profile <handle>` | Channel About/profile section |
| `sections <handle>` | Count every tab/section of a channel |
| `posts <handle>` | Community posts (paginated) |
| `shows <handle>` | Channel Shows (episode collections) |
| `home <handle>` | Home tab shelves (featured video, sections, Featured Channels) |
| `playlist <url>` | List playlist videos |

## Common Flags

- `--json` — Emit structured JSON output
- `--limit N` — Max results (default 10)
- `--gl XX --hl YY` — Pin region + language (default US/en)
- `--full-meta` — Enrich results with full metadata (upload_date, live_status, tags, likes, subscribers, categories)

## Use Cases

- **Keyword research** — `ytdata keywords "youtube seo" --json`
- **Competition analysis** — `ytdata compete "MrBeast challenge" --json`
- **Video SEO audit** — `ytdata scorecard "https://youtu.be/..." --json`
- **Channel research** — `ytdata channel "@MrBeast" --limit 20 --full-meta --json`
- **Rank tracking** — `ytdata track "youtube seo" --video "https://youtu.be/..." --json`
- **Find outliers** — `ytdata outliers "@channel" --json`
- **Content gap** — `ytdata gap "my topic" --competitor "@competitor" --json`

## No API Key Required

All data via `yt-dlp` + custom YouTube scrapers. Zero credits, no expiry, $0 forever.

## License

MIT
