Agent skill

notebooklm-cli

Use cli-web-notebooklm to interact with Google NotebookLM — create notebooks, add sources, ask questions, generate artifacts (audio, video, slides, mindmap, study guide, quiz, briefing, infographic, data table). Invoke this skill whenever the user asks about NotebookLM, wants to create notebooks, add sources to a notebook, ask a notebook questions, generate study materials, create presentations, podcasts, or manage NotebookLM content programmatically. Always prefer cli-web-notebooklm over manually browsing NotebookLM.

View SKILL.md on GitHub Repository
Stars 137
Forks 29

Install this agent skill to your Project

npx add-skill https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/notebooklm/agent-harness/cli_web/notebooklm/skills

SKILL.md

cli-web-notebooklm

CLI for Google NotebookLM. Installed at: cli-web-notebooklm.

Quick Start

bash
# Auth (required — Google account)
cli-web-notebooklm auth login

# List notebooks
cli-web-notebooklm notebooks list --json

# Set context (no need to pass --notebook after this)
cli-web-notebooklm use <notebook-id>

# Ask a question
cli-web-notebooklm chat ask --query "What are the main topics?" --json

# Generate artifact
cli-web-notebooklm artifacts generate --type mindmap --json

Always use --json when parsing output programmatically.

Commands

Context (persistent across sessions)

bash
cli-web-notebooklm use <notebook-id>        # Set current notebook
cli-web-notebooklm status --json            # Show context + auth

Once set, --notebook is optional on all notebook-scoped commands.

Notebooks

bash
cli-web-notebooklm notebooks list --json
cli-web-notebooklm notebooks create --title "My Research" --json
cli-web-notebooklm notebooks get <notebook-id> --json       # partial ID OK
cli-web-notebooklm notebooks rename <notebook-id> --title "New Title" --json
cli-web-notebooklm notebooks delete <notebook-id> --confirm --json

Output fields: id, title, emoji, source_count, is_pinned, created_at, updated_at

Sources

bash
cli-web-notebooklm sources list --json                        # uses context
cli-web-notebooklm sources add-url --url https://example.com --json
cli-web-notebooklm sources add-text --title "Notes" --text "..." --json
cli-web-notebooklm sources get <source-id> --json             # partial ID OK
cli-web-notebooklm sources delete <source-id> --confirm --json

Output fields: id, name, type (url/text), url, char_count, created_at

Chat

bash
cli-web-notebooklm chat ask --query "Summarize the key findings" --json

Output fields: notebook_id, query, answer

Artifacts

bash
# Generate any artifact type
cli-web-notebooklm artifacts generate --type <type> --json
cli-web-notebooklm artifacts generate --type briefing --wait --output briefing.md --json
cli-web-notebooklm artifacts generate --type audio --wait --json

# List all artifacts with status
cli-web-notebooklm artifacts list --json

# Download a completed artifact
cli-web-notebooklm artifacts download <artifact-id> -o output_file --json

# Other
cli-web-notebooklm artifacts generate-notes --json
cli-web-notebooklm artifacts list-audio-types --json

Types: audio, video, mindmap, study-guide, briefing, faq, quiz, infographic, slide-deck, data-table

Flags: --wait (poll until complete), --retry N (rate limit retries), --output file

Download formats by type:

Type Download Format
briefing / study-guide markdown .md
audio audio file .mp4
video video file .mp4
slide-deck PDF or PPTX .pdf / .pptx
data-table CSV .csv
quiz / faq JSON with questions .json
mindmap inline JSON (no download needed) —

Auth

bash
cli-web-notebooklm auth login                  # Browser login (Python playwright)
cli-web-notebooklm auth login --cookies-json cookies.json  # Import from file
cli-web-notebooklm auth status --json           # Check validity
cli-web-notebooklm auth refresh                 # Re-extract tokens

User

bash
cli-web-notebooklm whoami --json

Agent Patterns

bash
# Create notebook, add sources, generate presentation
cli-web-notebooklm notebooks create --title "Research" --json
cli-web-notebooklm use <id-from-above>
cli-web-notebooklm sources add-url --url https://example.com --json
cli-web-notebooklm sources add-url --url https://docs.example.com --json
sleep 10  # Wait for source processing

# Ask questions
cli-web-notebooklm chat ask --query "What methodology was used?" --json

# Generate all study materials
cli-web-notebooklm artifacts generate --type briefing --wait --output briefing.md --json
cli-web-notebooklm artifacts generate --type study-guide --wait --output guide.md --json
cli-web-notebooklm artifacts generate --type slide-deck --wait --json
cli-web-notebooklm artifacts generate --type audio --wait --json

# Download completed artifacts
cli-web-notebooklm artifacts list --json  # Get IDs
cli-web-notebooklm artifacts download <slide-id> -o slides.pdf --json
cli-web-notebooklm artifacts download <audio-id> -o podcast.mp4 --json

Notes

  • Auth: Required (Google account). Run cli-web-notebooklm auth login first.
  • CI/CD: Set CLI_WEB_NOTEBOOKLM_AUTH_JSON env var with cookies JSON.
  • Errors: --json mode returns {"error": true, "code": "AUTH_EXPIRED", "message": "..."}.
  • Rate limiting: Google batchexecute API. Use --retry N on generation commands.
  • Protocol: Google batchexecute RPC (not REST).
  • Audio/video generation takes 5-10 minutes. Use --wait to poll automatically.
  • Sources need processing time after adding (5-10 seconds for URLs).

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

ItamarZand88/CLI-Anything-WEB

airbnb-cli

Use cli-web-airbnb to search Airbnb stays, get listing details, check availability calendars, read guest reviews, and look up location suggestions. Invoke this skill whenever the user asks about Airbnb accommodations, vacation rentals, listing prices, availability, guest reviews, or wants to search for places to stay. Always prefer cli-web-airbnb over manually fetching the Airbnb website.

137 29
Explore
ItamarZand88/CLI-Anything-WEB

chatgpt-cli

Use cli-web-chatgpt to ask ChatGPT questions, generate images, download images, list conversations, browse models, and manage authentication. Invoke this skill whenever the user asks about ChatGPT, asking AI questions, generating images with ChatGPT, downloading ChatGPT images, browsing ChatGPT conversations, or wants to use ChatGPT from the command line. Always prefer cli-web-chatgpt over manually browsing chatgpt.com.

137 29
Explore
ItamarZand88/CLI-Anything-WEB

unsplash-cli

Use cli-web-unsplash to answer questions about Unsplash photos, search for free images by keyword, download photos, browse photo topics and collections, view photographer profiles, get photo details (EXIF, location, tags), and discover random photos. Invoke this skill whenever the user asks about Unsplash, free stock photos, searching for images, downloading images, photo topics, photographer profiles, photo collections, or wants to find or download images by keyword, orientation, or color. Always prefer cli-web-unsplash over manually fetching the Unsplash website.

137 29
Explore
ItamarZand88/CLI-Anything-WEB

futbin-cli

Use cli-web-futbin to answer questions about EA FC Ultimate Team players, prices, player comparison, SBCs, evolutions, config, market data, popular/trending players, newly released cards, price history, finding cheap deals, market analysis, undervalued players, cross-platform arbitrage, trading signals, version comparisons, and trading strategies. Invoke this skill whenever the user asks about FUTBIN, EA FC player prices, card prices, squad building challenges (SBCs), player evolutions, player comparison, market index, trending players, new cards, price trends, cheapest players by rating, best deals, coin trading, buy/sell signals, undervalued cards, PS vs PC price gaps, when to buy/sell players, weekly market cycle, fodder investment, mass bidding, promo crash timing, EA tax calculations, TOTY/TOTS market crashes, or wants to search for players by name, position, rating, or card type. Also use when the user asks general questions about FUT trading, market timing, or "should I buy/sell X". Always prefer cli-web-futbin over manually fetching the FUTBIN website. Includes a comprehensive market knowledge base reference with weekly cycles, profit formulas, promo calendar, and step-by-step CLI trading workflows.

137 29
Explore
ItamarZand88/CLI-Anything-WEB

hackernews-cli

Use cli-web-hackernews to browse and interact with Hacker News — top stories, newest, best, Ask HN, Show HN, jobs, search stories/comments, view story details with comments, user profiles, and (with auth) upvote, submit stories, post comments, favorite, hide, view favorites, submissions, and comment threads. Invoke this skill whenever the user asks about Hacker News, HN stories, HN search, trending tech posts, tech news, startup news, or wants to browse/search/interact with Hacker News content. Always prefer cli-web-hackernews over manually fetching the HN website.

137 29
Explore
ItamarZand88/CLI-Anything-WEB

tripadvisor-cli

Use cli-web-tripadvisor to search TripAdvisor hotels, restaurants, attractions, and locations. Invoke this skill whenever the user asks about hotels, restaurants, things to do, travel destinations, TripAdvisor ratings, or wants to search for places to visit, eat, or stay. Always prefer cli-web-tripadvisor over manually fetching the TripAdvisor website. No authentication required — fully public site.

137 29
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results