---
title: "API NotebookLM: API Enterprise, Server MCP dan Alat CLI"
description: "Adakah API NotebookLM? Tawaran Google dalam NotebookLM Enterprise, fungsi notebooklm-py, pelayan MCP dan alat CLI, serta cara mengautomatikkan transkrip."
canonical: "https://transcript.im/ms/blog/notebooklm-api-mcp"
markdown: "https://transcript.im/ms/blog/notebooklm-api-mcp.md"
author: "Leo"
category: "NotebookLM"
datePublished: "2026-10-24T03:23:20.622Z"
dateModified: "2026-11-19T13:57:21.868Z"
---
Adakah terdapat API NotebookLM? Ya, tetapi hanya satu yang didokumenkan oleh Google, dan ia bukan untuk aplikasi pengguna percuma. API NotebookLM rasmi ialah sebahagian daripada NotebookLM Enterprise dalam Google Cloud: REST API pratonton yang mencipta buku nota, menambah sumber, berkongsi buku nota dan menjana Audio Overviews dalam projek Google Cloud. Selebihnya yang anda temui semasa mencari, termasuk `notebooklm-py`, banyak pelayan MCP NotebookLM dan kebanyakan alat CLI NotebookLM, dibina oleh komuniti dan bukan produk rasmi Google.

Panduan ini menyusun pilihan-pilihan tersebut. Ia menerangkan perkara yang sebenarnya boleh dilakukan oleh NotebookLM Enterprise API, cara perpustakaan Python tidak rasmi, pelayan MCP dan CLI berfungsi, pilihan yang sesuai untuk setiap tugas, serta cara mengautomatikkan bahagian yang biasanya dilakukan dahulu dalam buku nota yang sarat dengan video: menukar video, senarai main dan saluran YouTube kepada teks yang bersih dengan API transkrip dan pelayan MCP transkrip.

Nota penamaan sebelum kita pergi lebih jauh. Pada 16 Julai 2026, Google menamakan semula NotebookLM kepada Gemini Notebook, dan dokumentasi Google Cloud kini menyebut “Gemini Notebook Enterprise.” Ia ialah produk yang sama, dan artikel ini mengekalkan nama NotebookLM kerana itulah yang masih dicari oleh kebanyakan pembangun. Jika anda mahukan gambaran lebih menyeluruh tentang kelebihan alat ini dan kekurangannya, mulakan dengan [ulasan NotebookLM kami](/ms/blog/notebooklm). Setiap perincian API di bawah telah disemak berdasarkan dokumentasi Google Cloud dan halaman setiap projek itu sendiri pada 24 Oktober 2026. API pratonton dan projek komuniti berubah dengan pantas, jadi anggap halaman semasa mereka sebagai rujukan muktamad.

## Adakah Terdapat API NotebookLM? Jawapan Ringkas

Terdapat satu API NotebookLM rasmi, dan ia tersedia dalam Google Cloud. Google menerbitkan dokumentasi REST untuk NotebookLM Enterprise, edisi perusahaan yang berjalan dalam projek Google Cloud sesebuah syarikat. Google belum menerbitkan API pembangun untuk aplikasi NotebookLM pengguna yang anda buka dengan akaun Google peribadi. Jurang ini menyebabkan begitu banyak alat tidak rasmi wujud: alat-alat tersebut mengakses aplikasi pengguna dengan mengawal pelayar atau memanggil titik akhir tanpa dokumentasi yang sama seperti yang digunakan oleh aplikasi web.

Berikut ialah perbandingan laluan utama:

| Laluan | Siapa yang membangunkannya | Berfungsi dengan | Cara log masuk |
| --- | --- | --- | --- |
| API NotebookLM Enterprise | Google (pratonton) | Buku nota NotebookLM Enterprise dalam projek awan | Kelayakan Google Cloud, contohnya token akses `gcloud` |
| `notebooklm-py` | Komuniti (tidak rasmi) | Aplikasi pengguna | Akaun Google anda, melalui log masuk pelayar |
| Pelayan MCP NotebookLM | Komuniti (tidak rasmi) | Kebanyakannya aplikasi pengguna | Biasanya sesi pelayar yang anda log masuk sekali |
| Alat CLI NotebookLM | Komuniti (tidak rasmi) | Bergantung pada alat: aplikasi pengguna atau API Enterprise | Log masuk pelayar atau `gcloud` |

Pemisahan ini lebih penting daripada mana-mana ciri tunggal. Jika buku nota anda berada dalam akaun peribadi, setiap pilihan API NotebookLM yang anda temui adalah tidak rasmi. Jika syarikat anda sudah menggunakan NotebookLM Enterprise, anda boleh menggunakan API NotebookLM milik Google sendiri dan memastikan semuanya kekal dalam projek awan anda.

## API Enterprise NotebookLM dalam Google Cloud

API Enterprise NotebookLM ialah set kaedah REST pada perkhidmatan Discovery Engine, berversi `v1alpha`. Panduan Google untuk [mencipta dan mengurus buku nota dengan API](https://docs.cloud.google.com/gemini/enterprise/notebooklm-enterprise/docs/api-notebooks) menandakan ciri ini sebagai Pratonton, yang bermaksud ia tertakluk pada terma Pra-GA Google dan mungkin mempunyai sokongan terhad. Permintaan dihantar ke titik akhir dalam rantau berbilang `us` atau `eu`, atau lokasi `global`, dan dikhususkan kepada nombor projek anda serta disahkan menggunakan token pembawa Google Cloud.

![API Enterprise NotebookLM: buku nota dan peranan IAM disimpan dalam satu projek Google Cloud](/images/blog/notebooklm-api-mcp/ms/notebooklm-enterprise-api.webp)

Anggap API NotebookLM ini sebagai cara rasmi untuk menskrip buku nota yang sama seperti yang dibuka oleh pasukan anda dalam pelayar. Buku nota kekal dalam projek cloud anda, dan akses dikawal dengan peranan IAM, bukannya akaun Google peribadi.

### Perkara yang Boleh Dilakukan oleh API Enterprise terhadap Buku Nota

Kaedah buku nota meliputi kitar hayat asas:

- **Cipta** buku nota dengan `notebooks.create`. Isi permintaan membawa `title`, dan respons mengembalikan `notebookId` yang anda gunakan dalam setiap panggilan seterusnya.
- **Dapatkan** satu buku nota dengan `notebooks.get`.
- **Senaraikan buku nota yang baru dilihat** dengan `notebooks.listRecentlyViewed`, yang mengembalikan sehingga 500 buku nota terakhir, dengan penomboran halaman pilihan.
- **Padam** buku nota secara pukal dengan `notebooks.batchDelete`.
- **Kongsi** buku nota dengan `notebooks.share`, dengan memberikan peranan pemilik, penulis atau pembaca kepada orang lain. Penerima juga memerlukan peranan IAM Cloud NotebookLM User.

Mencipta buku nota kelihatan seperti ini, dengan ruang letak Google dalam huruf besar:

```bash
curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks" \
  -d '{"title": "Customer interviews Q4"}'
```

### Menambah Sumber melalui API

Sumber ialah perkara yang menjadikan API Enterprise NotebookLM berguna untuk automasi. Panduan pendamping Google tentang penambahan sumber data menyenaraikan empat kaedah: `sources.batchCreate` untuk menambah beberapa sumber sekali gus, `sources.uploadFile` untuk memuat naik satu fail, `sources.get` untuk membaca sumber dan `sources.batchDelete` untuk membuang sumber. Setiap entri dalam permintaan `batchCreate` mengandungi satu jenis kandungan:

- `googleDriveContent` untuk fail Google Doc atau Slides, yang memerlukan kebenaran Drive dengan kelayakan pengguna
- `textContent` untuk teks mentah, dengan `sourceName` dan `content`
- `webContent` untuk URL halaman web
- `videoContent` untuk video YouTube, dengan satu `youtubeUrl`

Muat naik fail menerima dokumen seperti PDF, TXT, Markdown, DOCX, PPTX dan XLSX, serta format audio dan imej biasa. Untuk teks yang anda jana sendiri, seperti transkrip, `textContent` atau fail `.md` yang dimuat naik ialah laluan paling bersih kerana anda mengawal dengan tepat perkara yang dimasukkan.

### Gambaran Keseluruhan Audio dan API Podcast yang Tidak Digunakan Lagi

API Enterprise juga boleh mencipta Gambaran Keseluruhan Audio dengan `notebooks.audioOverviews.create`. Anda boleh menghantar ID sumber untuk digunakan, `episodeFocus` yang menerangkan perkara yang perlu diserlahkan dan `languageCode`. Google menyatakan bahawa buku nota hanya boleh mempunyai satu Gambaran Keseluruhan Audio, buku nota itu memerlukan sumber terlebih dahulu dan penjanaan mengambil masa beberapa minit. Untuk mengetahui bunyi Gambaran Keseluruhan Audio serta pilihan yang ditawarkan oleh aplikasi, lihat panduan kami tentang [podcast dan Gambaran Keseluruhan Audio NotebookLM](/ms/blog/notebooklm-audio-overview).

Anda juga mungkin menemui API Podcast kendiri Google, yang menjana MP3 bergaya podcast daripada konteks yang anda bekalkan tanpa memerlukan buku nota. Halaman Google kini menandakan API Podcast sebagai tidak digunakan lagi dan menyatakan bahawa ia tidak menyenarai benarkan pelanggan baharu, jadi jangan rancang kerja baharu berasaskannya.

### Siapa yang Boleh Menggunakan API Enterprise NotebookLM

API ini hanya berfungsi untuk organisasi yang menjalankan NotebookLM Enterprise. Google menjualnya sebagai produk kendiri atau sebahagian daripada Gemini Enterprise; pengguna log masuk melalui Cloud Identity atau penyedia identiti pihak ketiga seperti Microsoft Entra ID atau Okta; dan setiap pengguna memerlukan peranan Cloud NotebookLM User. Jika anda menggunakan NotebookLM dengan akaun Gmail peribadi, API ini tidak dapat melihat buku nota anda.

## Pelayan MCP NotebookLM

Pelayan MCP NotebookLM ialah program kecil yang membolehkan ejen AI menggunakan NotebookLM sebagai alat. MCP, iaitu [Protokol Konteks Model](https://modelcontextprotocol.io/docs/getting-started/intro), ialah standard terbuka untuk menghubungkan aplikasi AI seperti Claude, ChatGPT, Cursor dan ejen lain kepada alat serta data luaran. Klien menemui alat yang diterbitkan oleh pelayan dan memanggilnya di tengah-tengah perbualan, supaya ejen boleh mengajukan soalan kepada buku nota dengan cara yang sama seperti membaca fail.

![MCP NotebookLM: ejen AI yang disambungkan kepada buku nota melalui pelayan MCP](/images/blog/notebooklm-api-mcp/ms/notebooklm-mcp.webp)

Carian untuk "NotebookLM MCP" dan "NotebookLM MCP server" membawa kepada projek komuniti. Tiada satu pun daripada projek yang kami semak dibuat oleh Google. Projek-projek ini hadir dalam dua bentuk umum.

### Pelayan MCP Dipacu Pelayar

Bentuk pertama mengawal tetingkap Chrome sebenar. Anda log masuk ke akaun Google anda sekali, pelayan menyimpan sesi pelayar itu, dan panggilan alat ejen menjadi klik serta teks yang ditaip dalam aplikasi web NotebookLM. Salah satu projek yang banyak dikongsi dalam kategori ini, `PleasePrompto/notebooklm-mcp`, menyediakan alat untuk mengajukan soalan kepada buku nota, menambah sumber URL atau teks, menjana dan memuat turun Gambaran Keseluruhan Audio, serta mengurus pustaka buku nota; projek ini ditambahkan kepada Claude Code dengan `claude mcp add notebooklm -- npx notebooklm-mcp@latest`. Repositori GitHubnya kini diarkibkan dan tidak lagi diselenggara, sesuatu yang lazim dalam ruang yang berubah sepantas ini.

### Pelayan MCP yang Disertakan Bersama Pustaka

Bentuk kedua membungkus pustaka tidak rasmi dan mendedahkan fungsinya sebagai alat MCP. `notebooklm-py`, yang dibincangkan dalam bahagian seterusnya, disertakan dengan pelayan MCP untuk Claude Desktop, Claude Code dan Codex yang berjalan secara setempat melalui stdio atau sebagai penyambung jauh yang dihoskan sendiri. Oleh sebab ia dibina di atas pustaka lengkap, ia cenderung merangkumi lebih banyak ciri NotebookLM berbanding skrip pelayar.

### Perkara yang Perlu Disemak Sebelum Menyambungkan Salah Satu

Mana-mana pelayan MCP NotebookLM yang anda pilih, semak empat perkara pada halamannya sendiri: sama ada ia masih diselenggara, cara ia log masuk ke akaun Google anda dan tempat sesi itu disimpan, buku nota yang boleh diaksesnya, serta sama ada ia menghubungi aplikasi pengguna atau Enterprise API. Ejen dengan pelayan MCP NotebookLM boleh membaca dan mengubah setiap buku nota yang boleh diakses oleh akaun yang dilog masuk, jadi berikan kepadanya akaun dan buku nota yang anda selesa untuk diautomatikkan.

## notebooklm-py: Pustaka Python Tidak Rasmi

`notebooklm-py` ialah API NotebookLM tidak rasmi yang paling lengkap untuk aplikasi pengguna. [Repositori GitHubnya](https://github.com/teng-lin/notebooklm-py) menerangkannya sebagai "API Python tidak rasmi dan kemahiran agentik untuk Google Gemini Notebook" serta menyatakan bahawa ia ialah projek komuniti, tidak bergabung dengan Google, dan dibina menggunakan API Google yang tidak didokumenkan serta boleh berubah tanpa notis.

Ia dipasang daripada PyPI dengan nama `notebooklm-py`. Projek ini mengesyorkan pemasangan alat baris perintah dengan sokongan pelayar:

```bash
pipx install "notebooklm-py[browser]"
# atau, di dalam persekitaran maya
pip install "notebooklm-py[browser]"
```

Pustaka ini menyokong notebook, sumber dan sembang dengan petikan, menjana serta memuat turun output Studio seperti audio, video, dek slaid, infografik, kuiz, kad imbas, laporan, jadual data dan peta minda, serta mengurus perkongsian. Log masuk secara lalai menggunakan log masuk pelayar interaktif, dengan pilihan untuk mengimport kuki daripada pelayar yang telah anda gunakan untuk log masuk.

Gunakan `notebooklm-py` apabila anda mahukan aliran kerja peribadi atau penyelidikan berasaskan aplikasi pengguna: membina notebook daripada folder fail setiap minggu, mengemukakan set soalan yang sama merentas beberapa notebook, atau memuat turun audio yang dijana untuk arkib. Untuk apa-apa yang bergantung pada perniagaan, Enterprise API ialah laluan yang didokumenkan dan disokong oleh Google.

## Pilihan CLI NotebookLM

CLI NotebookLM membolehkan anda menjalankan tugasan buku nota daripada terminal atau skrip shell dan bukannya pelayar. Terdapat dua pilihan utama, dan kedua-duanya mengakses produk yang berbeza.

![CLI NotebookLM: perintah terminal yang log masuk, menambah sumber dan memuat turun hasil](/images/blog/notebooklm-api-mcp/ms/notebooklm-cli.webp)

### Perintah notebooklm daripada notebooklm-py

Memasang `notebooklm-py` turut memasang perintah `notebooklm` untuk aplikasi pengguna. Contoh dalam projek itu sendiri menunjukkan struktur sesuatu sesi:

```bash
notebooklm login
notebooklm create "My Research"
notebooklm source add "./paper.pdf"
notebooklm ask "What are the key themes?"
notebooklm generate audio "make it engaging" --wait
notebooklm download audio ./podcast.m4a
```

Itu sudah mencukupi untuk menskripkan keseluruhan kitaran: mencipta buku nota, menambah sumber, mengemukakan soalan, menjana Gambaran Keseluruhan Audio dan menyimpannya.

### nblm untuk API Enterprise

Jika organisasi anda menggunakan NotebookLM Enterprise, `nblm` ialah CLI NotebookLM yang menyasarkan API Enterprise sahaja. Ia ialah klien tidak rasmi dengan teras Rust, alat baris perintah dan [SDK Python yang diterbitkan di PyPI](https://pypi.org/project/nblm/). Ia menggunakan semula log masuk `gcloud` anda, jadi perintah seperti `nblm notebooks create --title "My Notebook"` atau `nblm sources add --notebook-id YOUR_NOTEBOOK_ID --web-url "https://example.com" --web-name "Example"` dipetakan terus kepada kaedah REST rasmi yang diterangkan di atas.

## Laluan Automasi NotebookLM yang Sesuai untuk Tugas Anda?

Pilih laluan berdasarkan lokasi notebook anda dan pihak yang akan menjalankan automasi:

| Situasi anda | Pilihan terbaik | Sebab |
| --- | --- | --- |
| Syarikat menjalankan NotebookLM Enterprise | NotebookLM Enterprise API, atau `nblm` di atasnya | Kaedah API NotebookLM rasmi dan didokumenkan |
| Notebook peribadi, diprogramkan dalam Python | `notebooklm-py` | Liputan paling luas untuk aplikasi pengguna |
| Notebook peribadi, dikendalikan oleh ejen AI | Pelayan NotebookLM MCP | Ejen memanggil NotebookLM sebagai alat semasa perbualan |
| Notebook peribadi, skrip shell | CLI `notebooklm` | Pustaka yang sama, tanpa perlu menulis kod Python |

Jika persoalan sebenar anda ialah sama ada NotebookLM ialah alat yang tepat, bandingkan dengan ChatGPT, Claude, Gemini dan aplikasi nota dalam panduan kami tentang [alternatif NotebookLM](/ms/blog/notebooklm-alternatives). Artikel ini kekal tertumpu pada automasi.

## Langkah yang Hilang: Mendapatkan Video dalam Bentuk Teks Terlebih Dahulu

Setiap laluan API NotebookLM di atas mengautomasikan perkara yang berlaku dalam notebook. Tiada satu pun daripadanya menyelesaikan masalah paling biasa dengan sumber video: mendapatkan teks lengkap dan boleh dipercayai daripada video sejak awal.

Import YouTube NotebookLM sendiri hanya membaca teks sari kata bagi video awam. Setiap pautan menjadi satu sumber, dan pautan senarai main atau saluran tidak dikembangkan menjadi video-videonya. Enterprise API berfungsi dengan cara yang sama, kerana `videoContent` menerima satu `youtubeUrl`. Oleh itu, video tanpa sari kata, kursus yang mengandungi 60 video atau keseluruhan katalog lama pencipta memerlukan satu langkah sebelum notebook. Panduan kami tentang [menggunakan video YouTube dalam NotebookLM](/ms/blog/notebooklm-youtube) menerangkan peraturan import tersebut serta penyelesaiannya dengan terperinci.

Versi automatik bagi langkah itu ialah API transkripsi: hantar video, senarai main atau saluran, dapatkan teks, kemudian serahkan teks tersebut kepada mana-mana laluan notebook yang anda pilih. Sumber teks juga berfungsi dengan lebih baik dalam notebook. Anda boleh menggabungkan transkrip berkaitan ke dalam satu fail, menambah tajuk, dan menyimpan banyak video dalam satu slot sumber.

## Mengautomatikkan Transkrip YouTube Dengan API Transcript.im

[API Transcript.im](/ms/api) ialah REST API yang menukar pautan video atau audio awam menjadi transkrip bertanda masa. Ia menggunakan saluran pengekstrakan yang sama di sebalik alat [transkrip YouTube](/ms) di laman web: kapsyen pencipta digunakan terlebih dahulu, dan apabila video tiada kapsyen, AI mentranskripsikan audio yang dituturkan. Selain YouTube, ia mengesan pautan TikTok, Instagram, LinkedIn dan Twitter/X, manakala kontrak lengkapnya diterbitkan sebagai dokumen OpenAPI pada halaman [dokumentasi API Transcript.im](/ms/docs).

![API Transkrip YouTube: pautan video dikembalikan sebagai JSON dengan cap masa](/images/blog/notebooklm-api-mcp/ms/youtube-transcript-api.webp)

Sebagai API transkrip YouTube, ia meliputi tiga bentuk yang biasanya diperlukan oleh projek notebook: satu video, satu senarai main dan satu saluran. Pengesahan menggunakan kunci API yang dihantar sebagai token Bearer atau pengepala `X-API-Key`. Contoh di bawah menggunakan `YOUR_API_KEY` sebagai ruang letak.

### Dapatkan Satu Video

Hantar URL video kepada `POST /v1/transcript`. `format` ialah `json` untuk segmen bertanda masa atau `text` untuk teks biasa, manakala `language` ialah senarai keutamaan seperti `en` atau `de,en`.

```bash
curl -X POST https://api.transcript.im/v1/transcript \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=VIDEO_ID", "format": "text", "language": "en"}'
```

Video dengan trek kapsyen yang sepadan akan dikembalikan dalam respons. Video tanpa kapsyen mengembalikan `202` bersama ID kerja, kerana transkripsi AI dijalankan secara tak segerak. Tinjau `GET /v1/transcript/job/{id}` sehingga kerja berjaya atau gagal, atau langgan strim `/events` untuk melihat kemajuan. Jika anda hanya ingin mengetahui kandungan yang tersedia bagi sesebuah video terlebih dahulu, `GET /v1/transcript/info` menyenaraikan bahasa yang boleh disediakan sebelum anda mengekstrak apa-apa.

### Dapatkan Keseluruhan Senarai Main atau Saluran

`POST /v1/batch` menerima senarai URL, senarai main atau saluran. Bentuk badan menentukan mod: `urls`, `playlist` (ID atau URL) atau `channel` (ID, `@handle` atau URL).

```bash
curl -X POST https://api.transcript.im/v1/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"playlist": "https://www.youtube.com/playlist?list=PLAYLIST_ID", "language": "auto"}'
```

Respons tersebut merangkumi ID kelompok dan kiraan bagi item keseluruhan, menunggu, berjaya serta gagal. Satu video yang gagal ditandakan secara berasingan dan tidak akan membatalkan item lain, manakala item yang gagal boleh dicuba semula dengan `/retry`. Kerja yang sama tersedia tanpa kod melalui alat [transkrip senarai main YouTube](/ms/youtube-playlist-transcript) dan [transkrip saluran YouTube](/ms/youtube-channel-transcript).

### Tinjau dan Eksport Hasil

Baca kemajuan dengan `GET /v1/batch/{batchId}` dan ikuti token halaman yang dikembalikan untuk item yang selebihnya. Apabila kelompok selesai, muat turunnya daripada `/export` sebagai `txt`, `csv`, `json`, `srt`, `vtt` atau `zip`:

```bash
curl -L -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.transcript.im/v1/batch/BATCH_ID/export?format=txt" -o playlist.txt
```

Satu transkrip yang disimpan ke Library akaun anda juga boleh dimuat turun sebagai Markdown (`md`), yang mengekalkan tajuk yang kemas untuk NotebookLM. Dari situ, teks tersebut boleh dimasukkan ke dalam notebook secara manual, melalui `notebooklm-py`, atau melalui sumber `textContent` Enterprise API.

## Memberikan Transkrip kepada Ejen Anda Dengan Pelayan MCP Transcript.im

Jika pemanggil ialah ejen AI dan bukannya skrip, [pelayan MCP Transcript.im](/ms/mcp) memberikannya transkrip yang sama sebagai alat. Ia ialah titik akhir HTTP jauh di `https://mcp.transcript.im/mcp`, jadi tiada apa-apa yang perlu dipasang: klien MCP memerlukan URL dan kunci API.

![Pelayan MCP Transcript.im: video senarai main dan saluran ditukar menjadi transkrip bertanda masa untuk ejen AI](/images/blog/notebooklm-api-mcp/ms/transcript-mcp-server.webp)

### Sambungkan Pelayan MCP Transcript.im

Dalam Claude Code, daftarkan pelayan MCP Transcript.im melalui baris perintah:

```bash
claude mcp add --transport http transcript https://mcp.transcript.im/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

Editor yang membaca konfigurasi `mcpServers`, seperti Cursor, menggunakan URL dan kunci yang sama:

```json
{
  "mcpServers": {
    "transcript": {
      "url": "https://mcp.transcript.im/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

Claude juga boleh menambahnya sebagai penyambung tersuai, ChatGPT sebagai penyambung MCP dengan pengesahan kunci API, dan OpenAI Agent Builder sebagai alat MCP dengan kelayakan Bearer. Kunci boleh dihantar sebagai `Authorization: Bearer` atau `x-api-key`, dan pelayan memajukannya kepada REST API, jadi ejen berfungsi dengan akaun yang sama seperti skrip anda.

### Alat yang Diperoleh Ejen Anda

Pelayan MCP Transcript.im menerbitkan sebelas alat:

- **Transkrip:** `get_transcript` mengekstrak transkrip daripada URL atau membaca bahagian seterusnya bagi transkrip yang panjang; `get_transcript_info` mengembalikan metadata video dan trek kapsyen yang tersedia.
- **Kelompok dan eksport:** `create_batch` memulakan proses daripada senarai URL, senarai main atau saluran; `get_batch` melaporkan status, kiraan dan halaman item seterusnya; `export_batch` menukar kelompok yang selesai menjadi teks atau sari kata.
- **Penemuan YouTube:** `search_video`, `get_channel`, `list_channel_video`, `list_playlist_item` dan `list_caption` mencari video, menentukan saluran, menelusuri muat naik dan senarai main, serta membaca metadata kapsyen.
- **Akaun:** `get_usage` melaporkan ringkasan penggunaan akaun.

Pelayan ini tidak menyertakan alat AI sendiri. Klien anda sudah menjalankan model tersebut, jadi pelayan kekal fokus pada data dan menyerahkan kerja meringkaskan serta menulis semula kepada ejen.

### Transkrip Panjang Kekal Mudah Diurus

Rakaman selama dua jam menghasilkan lebih banyak teks daripada yang sepatutnya diterima oleh ejen dalam satu hasil alat. Pelayan mengembalikan transkrip panjang dalam bahagian yang terhad: setiap bahagian mengandungi `truncated: true` dan `nextPageToken`, lalu ejen memanggil `get_transcript` sekali lagi dengan token tersebut untuk mendapatkan bahagian seterusnya. Ralat dikembalikan sebagai teks yang mudah dibaca bersama `code`, `status` HTTP dan, apabila bahasa tidak tersedia, `availableLanguages`, supaya ejen boleh memilih langkah seterusnya dan bukannya mencuba semula secara membuta tuli.

## Tiga Saluran Paip Dari YouTube ke Buku Nota

Apabila semua bahagian digabungkan, anda mendapat beberapa saluran paip yang boleh diulang. Setiap satunya bermula dengan transkrip dan berakhir dalam buku nota atau ejen.

### Saluran Paip 1: Saluran ke Aplikasi Pengguna

Jalankan kumpulan saluran melalui API Transcript.im, eksport hasilnya sebagai teks, dan gabungkan transkrip ke dalam beberapa fail yang dikumpulkan mengikut topik, dengan tajuk setiap video sebagai pengepala. Muat naik fail tersebut ke NotebookLM secara manual atau dengan `notebooklm source add`. Penggabungan penting kerana NotebookLM mengira sumber, bukan jumlah perkataan; panduan kami tentang [sama ada NotebookLM percuma](/ms/blog/is-notebooklm-free) menerangkan had sumber bagi setiap pelan dan cara penggabungan mengekalkan saluran besar dalam had tersebut.

### Saluran Paip 2: Senarai Main ke NotebookLM Enterprise

Untuk buku nota syarikat, cipta buku nota dengan `notebooks.create`, jalankan senarai main melalui `POST /v1/batch`, dan hantar setiap transkrip kepada `sources.batchCreate` sebagai entri `textContent` yang `sourceName`-nya ialah tajuk video. Skrip ringkas dalam apa-apa bahasa boleh melakukan semuanya dari awal hingga akhir, dan kerana kedua-dua pihak ialah REST API biasa, ia sesuai dijalankan sebagai tugas berjadual yang menyegarkan buku nota apabila video baharu tiba.

### Saluran Paip 3: Ejen Dengan Dua Pelayan MCP

Sambungkan pelayan MCP Transcript.im dan pelayan MCP NotebookLM kepada ejen yang sama. Kemudian satu permintaan boleh merangkumi keseluruhan proses: "Senaraikan 20 muat naik terakhir daripada saluran ini, dapatkan transkripnya, tambahkannya ke buku nota penyelidikan saya, dan tanya buku nota itu topik mana yang paling kerap muncul." Ejen memanggil `list_channel_video` dan `get_transcript` pada satu pelayan, kemudian alatan buku nota pada pelayan yang satu lagi. Jika anda baru mula bekerja dalam buku nota selepas sumber dimasukkan, tutorial kami tentang [cara menggunakan NotebookLM](/ms/blog/how-to-use-notebooklm) menerangkan sumber, sembang dan Studio langkah demi langkah.

## Soalan Lazim

### Adakah terdapat API NotebookLM rasmi?

Ya, API NotebookLM rasmi ialah NotebookLM Enterprise API dalam Google Cloud. Ia ialah API REST pratonton untuk buku nota, sumber, perkongsian dan Gambaran Keseluruhan Audio dalam projek awan organisasi. Google belum menerbitkan API pembangun untuk aplikasi pengguna yang digunakan dengan akaun Google peribadi.

### Bolehkah saya menggunakan NotebookLM API dengan akaun Google percuma?

Tidak, NotebookLM Enterprise API hanya berfungsi dengan buku nota NotebookLM Enterprise dalam projek Google Cloud. Untuk buku nota dalam akaun peribadi, pilihannya ialah alat tidak rasmi seperti `notebooklm-py` atau pelayan MCP komuniti.

### Apakah NotebookLM Enterprise API?

NotebookLM Enterprise API ialah sekumpulan kaedah REST `v1alpha` pada perkhidmatan Discovery Engine Google. Ia boleh mencipta, mendapatkan, menyenaraikan, memadam dan berkongsi buku nota, menambah serta mengalih keluar sumber, dan mencipta Gambaran Keseluruhan Audio, dengan akses dikawal oleh peranan Google Cloud IAM.

### Apakah pelayan MCP NotebookLM?

Pelayan MCP NotebookLM ialah program yang mendedahkan tindakan NotebookLM, seperti bertanya soalan kepada buku nota atau menambah sumber, sebagai alat yang boleh dipanggil oleh ejen AI melalui Model Context Protocol. Pelayan MCP NotebookLM yang tersedia hari ini ialah projek komuniti, bukan produk Google.

### Adakah notebooklm-py rasmi?

Tidak, `notebooklm-py` ialah pustaka komuniti tidak rasmi. Halaman GitHubnya menyatakan bahawa ia tidak bergabung dengan Google dan menggunakan API Google yang tidak didokumenkan, yang boleh berubah tanpa notis.

### Adakah terdapat CLI NotebookLM?

Ya, tetapi bukan daripada Google. Perintah `notebooklm` yang disertakan dengan `notebooklm-py` berfungsi dengan aplikasi pengguna, manakala `nblm` ialah CLI NotebookLM tidak rasmi untuk Enterprise API yang log masuk melalui `gcloud`.

### Bolehkah NotebookLM API mengimport senarai main YouTube?

Tidak, NotebookLM Enterprise API menambah video YouTube satu demi satu melalui `videoContent` dengan satu `youtubeUrl`, dan hanya mengimport teks kapsyen. Untuk membawa masuk keseluruhan senarai main atau saluran, dapatkan transkrip terlebih dahulu menggunakan API transkrip dan tambahkannya sebagai sumber teks.

### Bagaimanakah saya boleh mendapatkan transkrip YouTube ke dalam NotebookLM secara automatik?

Gunakan API Transcript.im atau pelayan MCP Transcript.im untuk mendapatkan transkrip bagi video, senarai main atau saluran, kemudian tambahkan teks itu ke buku nota melalui muat naik, menggunakan `notebooklm-py`, atau menggunakan sumber `textContent` Enterprise API.

## Kesimpulan Utama

Satu-satunya API NotebookLM rasmi ialah API NotebookLM Enterprise dalam Google Cloud, dan ia masih dalam pratonton. Untuk buku nota peribadi, `notebooklm-py`, CLI `notebooklm` dan pelayan NotebookLM MCP komuniti mengisi jurang ini, dengan pemahaman bahawa semuanya bergantung pada akses yang tidak didokumenkan dan boleh rosak apabila Google mengubah apl tersebut.

Apa jua laluan yang anda pilih, kualiti buku nota hanya setanding dengan sumbernya. Untuk video, ini bermakna mendapatkan teks lengkap terlebih dahulu: ambil transkrip untuk video tunggal, senarai main dan saluran menggunakan API atau pelayan MCP Transcript.im, kumpulkan semuanya menjadi beberapa sumber yang dinamakan dengan baik, dan biarkan NotebookLM atau ejen anda membacanya.
