TubeWhale
🥈SilverTubeWhale is an open-source AI framework that streamlines YouTube video search and content analysis. By automating transcript retrieval and summarization, it helps researchers and analysts to efficiently explore video content with ease.
1510Updated 2mo ago
Intermediate30 minutes to implementresearch
Saves ~105 min per use
Quick InstallView Source
claude install yaninsanity/TubeWhaleOverview
About This Skill
TubeWhale is an open-source AI framework that streamlines YouTube video search and content analysis. By automating transcript retrieval and summarization, it helps researchers and analysts to efficiently explore video content with ease.
How to Use
[{"step":"Install TubeWhale and configure your YouTube API credentials.","action":"Follow the [TubeWhale GitHub setup guide](https://github.com/tubewhale/tubewhale) to install the framework. Ensure you have a YouTube Data API key (create one via [Google Cloud Console](https://console.cloud.google.com/)).","tip":"Use a dedicated Google Cloud project for API keys to avoid rate limits. Enable the 'YouTube Data API v3' and restrict the key to your domain/IP for security."},{"step":"Define your research scope and search parameters.","action":"Open TubeWhale and input your search query (e.g., '[TOPIC/KEYWORD]'). Set filters for video count (e.g., top 20 results), upload date (e.g., last 2 years), and language (e.g., English).","tip":"For niche topics, use advanced search operators like `intitle:\"renewable energy\"` or `\"solar panel efficiency\" after:2022` to refine results."},{"step":"Run the analysis and extract transcripts.","action":"Execute the TubeWhale script to fetch video metadata, transcripts (via YouTube’s auto-generated captions), and comments. Save the output to a structured format (e.g., JSON or CSV).","tip":"For longer videos (>1 hour), split the transcript extraction into chunks to avoid API timeouts. Use the `--chunk-size` flag in TubeWhale for large files."},{"step":"Summarize and analyze the data.","action":"Use the TubeWhale summarization module to generate key takeaways, thematic clusters, and timestamped highlights. Export the report to PDF or Google Sheets for sharing.","tip":"For deeper analysis, integrate TubeWhale with Python libraries like `pandas` (for data manipulation) or `spaCy` (for NLP-based theme extraction)."},{"step":"Automate follow-up research with Automa.","action":"Set up an Automa workflow to monitor new videos matching your topic weekly. Use the workflow to re-run TubeWhale analysis and alert you to significant updates (e.g., new efficiency records).","tip":"Configure Automa’s webhook to send Slack/email notifications when new high-impact videos (e.g., >100K views) are published. Use the `YouTube Data API` to filter by view count."}]
Use Cases
Automating video content research
Extracting summaries from educational videos
Enhancing market analysis with video insights
Facilitating content creation for YouTube channels
Best For
Research
Tags
Setup & Installation
Quick Install
Terminal
claude install yaninsanity/TubeWhaleAlternative Install (Git Clone)
git clone https://github.com/yaninsanity/TubeWhaleRequirements
- Claude Code or compatible AI agent
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Use TubeWhale to analyze YouTube content for [TOPIC/KEYWORD]. Extract transcripts from the top [NUMBER] videos, summarize key themes, and identify recurring arguments or insights. Focus on extracting timestamps for critical moments in the videos. Provide a structured report with: 1) Video titles and links, 2) Key takeaways per video, 3) Thematic analysis, and 4) Timestamped highlights. Prioritize videos uploaded in the last [TIMEFRAME, e.g., 2 years].
Example Output
### YouTube Content Analysis Report: "Renewable Energy Breakthroughs 2024" **Generated on:** October 10, 2024 **Topic:** Renewable Energy Breakthroughs (Focus: Solar Panel Efficiency) **Videos Analyzed:** 10 (Top results from YouTube search) **Timeframe:** Last 2 years --- #### **1. Video Titles and Links** 1. **"Perovskite Solar Cells: The Next Big Thing in Solar?"** - [Watch Here](https://youtu.be/abc123) 2. **"How Tesla’s New Solar Roof Tiles Work"** - [Watch Here](https://youtu.be/def456) 3. **"The Future of Solar Energy: AI-Optimized Panels"** - [Watch Here](https://youtu.be/ghi789) 4. **"Why Solar Panels Are Getting Cheaper Every Year"** - [Watch Here](https://youtu.be/jkl012) 5. **"Breakthrough in Solar Panel Efficiency: 50%+ in 2024"** - [Watch Here](https://youtu.be/mno345) 6. **"Solar Energy Storage: The Missing Piece of the Puzzle"** - [Watch Here](https://youtu.be/pqr678) 7. **"How China Dominates the Solar Panel Market"** - [Watch Here](https://youtu.be/stu901) 8. **"The Dark Side of Solar Panels: Environmental Costs"** - [Watch Here](https://youtu.be/vwx234) 9. **"Solar Panel Recycling: Can We Fix the Waste Problem?"** - [Watch Here](https://youtu.be/yz5678) 10. **"Solar vs. Wind: Which Energy Source Wins in 2024?"** - [Watch Here](https://youtu.be/abc901) --- #### **2. Key Takeaways per Video** | **Video Title** | **Key Takeaways** | **Sentiment** | |-----------------|-------------------|---------------| | Perovskite Solar Cells | Perovskite cells now achieve 30%+ efficiency (vs. 22% for silicon). Commercialization expected in 2026. | Optimistic | | Tesla Solar Roof Tiles | Tesla’s solar tiles integrate with Powerwall for 24/7 energy. Installation cost: ~$50,000 for average home. | Mixed (high cost) | | AI-Optimized Panels | AI-driven tracking boosts panel output by 25-30%. Companies like Aurora Solar leading this space. | Positive | | Solar Panel Costs | Price dropped 80% since 2010. 2024 average: $2.50/Watt (vs. $12/Watt in 2010). | Positive | | 50%+ Efficiency Breakthrough | New tandem cells (silicon + perovskite) hit 50% efficiency in lab tests. | Revolutionary | | Solar Storage | Lithium-ion batteries now cost $137/kWh (down from $1,100/kWh in 2010). Still a bottleneck for 24/7 solar. | Neutral | | China’s Solar Dominance | China produces 80% of global solar panels. Trade tensions may disrupt supply chains. | Cautionary | | Environmental Costs | Solar panel production emits ~50g CO2/kWh (vs. 40g for wind, 1000g for coal). Recycling infrastructure lagging. | Critical | | Solar Panel Recycling | Only 10% of panels are recycled today. New EU regulations aim for 85% by 2030. | Urgent | | Solar vs. Wind | Solar wins in scalability; wind wins in land use efficiency. Hybrid systems emerging. | Balanced | --- #### **3. Thematic Analysis** **Top 3 Emerging Trends:** 1. **Perovskite Solar Cells:** The most discussed breakthrough, with 4/10 videos mentioning it. Expected to disrupt the market by 2026. 2. **AI Integration:** AI-driven solar optimization is gaining traction, with companies like Aurora Solar raising $50M in 2024. 3. **Efficiency Records:** Lab tests showing 50%+ efficiency in tandem cells are reshaping industry expectations. **Controversies:** - **Environmental Impact:** 3 videos highlighted the carbon footprint of panel production and recycling challenges. - **Supply Chain Risks:** Dependence on China for 80% of panel production is a recurring concern. **Gaps Identified:** - No video addressed the **social impact** of solar panel manufacturing (e.g., labor conditions in China). - Limited discussion on **policy incentives** for solar adoption in emerging markets. --- #### **4. Timestamped Highlights** **Critical Moments (Top 5):** 1. **03:45 - Perovskite Efficiency Breakthrough** (Video 1): "Lab tests show perovskite cells achieving 33% efficiency, surpassing silicon’s theoretical limit of 29%." 2. **12:10 - Tesla’s Solar Roof Cost Reality** (Video 2): "Despite the hype, the average installation costs $50,000, making it inaccessible for most homeowners." 3. **07:30 - AI Optimization Impact** (Video 3): "AI-driven solar tracking systems can increase energy output by 30% in cloudy regions like Seattle." 4. **18:22 - China’s Solar Monopoly** (Video 7): "80% of global solar panel production is controlled by Chinese firms, creating geopolitical vulnerabilities." 5. **22:45 - Solar Panel Recycling Crisis** (Video 9): "By 2030, we’ll have 8 million tons of solar panel waste. Current recycling rates are below 10%." --- #### **Recommendations for Further Research:** 1. Investigate **perovskite solar cell commercialization timelines** (focus on companies like Oxford PV and Saule Technologies). 2. Explore **policy incentives** for solar adoption in Africa and Southeast Asia (e.g., Nigeria’s solar subsidies). 3. Assess **alternative solar technologies** like organic photovoltaics or quantum dot cells. --- **Next Steps:** - Use TubeWhale to **monitor updates** on perovskite solar cells over the next 6 months. - Cross-reference these findings with **academic papers** (e.g., Nature Energy, Solar Energy Materials) for validation. - Share this report with the **R&D team** to align product development with market trends.
Apply to these tools
Browse all tools
Compatible MCP servers
Browse all MCP servers
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan