explaingit

pennydinh/penny-notebooklm-research

Analysis updated 2026-05-18

15TypeScriptAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TLDR

Automates YouTube trend research by reading real video transcripts through NotebookLM to suggest ideas and write scripts.

Mindmap

mindmap
  root((repo))
    What it does
      Researches viral videos
      Analyzes real transcripts
    Tech stack
      TypeScript
      Brave Search API
      NotebookLM
    Use cases
      Find trending videos
      Generate video ideas
      Write full scripts
    Audience
      Content creators
      Claude Cowork users
    Setup
      Needs MCP plus skill
      Needs Brave API key

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Find viral YouTube videos on a topic and analyze their real transcripts for trends.

USE CASE 2

Generate five video ideas grounded in actual transcript content instead of guesses.

USE CASE 3

Automatically write a full YouTube script for a chosen video idea.

What is it built with?

TypeScriptNode.jsBrave Search APIApifyNotebookLM

How does it compare?

pennydinh/penny-notebooklm-researchaestheticsuraj234/chai-gpt-buildappariciojunior/motion-studio-open
Stars151515
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/5
Audiencevibe coderdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires both an MCP server and a separate Claude skill file, plus a Brave Search API key and a secondary Google account.

In plain English

Penny NotebookLM Research automates a specific YouTube research workflow for content creators: find popular videos on a topic, read their actual transcripts, and turn that research into video ideas and a written script. Instead of an AI model guessing what a trend looks like, this tool has Google's NotebookLM and its Gemini model read the real transcript of each video it finds, so the analysis is grounded in what was actually said. It works as two connected pieces that both need to be installed together: an MCP server, which is a small local program that runs searches through Brave Search and Apify and controls NotebookLM on your behalf, and a Claude skill file that teaches Claude Cowork how to run the whole process as one coordinated flow. Neither piece works without the other. Setup starts with an install script that clones the project, installs its dependencies, builds it, and registers it with Claude, after which you add your own Brave Search API key, which is free for a limited number of monthly searches, and optionally an Apify token for more accurate view counts. You then install the separate skill file through Claude's settings, and finish first time setup by signing into a secondary Google account, since the tool keeps cookies stored locally, followed by creating and sharing a NotebookLM notebook link. Once set up, a user simply types a research request in plain language, describing a topic, a minimum view count, and a time window, and the tool searches for matching videos, adds each one to the shared notebook, has Gemini analyze the real transcripts for trends, keywords, and thumbnail patterns, suggests five video ideas, and writes a full script for whichever idea is chosen. The project is written in TypeScript and released under the MIT license.

Copy-paste prompts

Prompt 1
Help me install the Penny NotebookLM Research MCP server using the provided install script.
Prompt 2
Walk me through setting up my Brave Search API key and optional Apify token for this tool.
Prompt 3
Explain how to run setup_auth to connect a secondary Google account to NotebookLM.
Prompt 4
Show me how to trigger a full research_workflow for a topic with a minimum view count.

Frequently asked questions

What is penny-notebooklm-research?

Automates YouTube trend research by reading real video transcripts through NotebookLM to suggest ideas and write scripts.

What language is penny-notebooklm-research written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Brave Search API.

How hard is penny-notebooklm-research to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is penny-notebooklm-research for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.