X to NotebookLM / X 文章转 NotebookLM

Overview / 概述

English: Quickly parse X (Twitter) articles and upload to Google NotebookLM for deep reading and analysis.

中文： 快速解析 X (Twitter) 文章并上传到 Google NotebookLM，便于深度阅读和分析。

Dependencies / 依赖项

English:

• - r.jina.ai - Free web content extraction service (no API key required)
• NotebookLM CLI - Installed and authenticated (run notebooklm login to authenticate)
• Node.js - Script runtime environment

中文：

• - r.jina.ai - 免费的网页内容提取服务（无需 API Key）
• NotebookLM CLI - 已安装并认证（运行 notebooklm login 完成认证）
• Node.js - 运行脚本环境

Usage / 使用方法

Basic Usage / 基本用法

English:
CODEBLOCK0

中文：
CODEBLOCK1

Advanced Usage / 高级用法

English:
CODEBLOCK2

中文：

# 指定 Notebook 名称
node ~/.openclaw/workspace/skills/x-to-notebooklm/scripts/x-to-notebooklm.mjs <URL> --notebook-name "X Articles"

# 使用现有 Notebook
node ~/.openclaw/workspace/skills/x-to-notebooklm/scripts/x-to-notebooklm.mjs <URL> --notebook-id <existing_notebook_id>

# 详细输出模式
node ~/.openclaw/workspace/skills/x-to-notebooklm/scripts/x-to-notebooklm.mjs <URL> --verbose

Workflow / 工作流程

English:

1. 1. Fetch Content - Use curl + r.jina.ai to extract plain text from X articles
2. Create Notebook - Automatically create a new NotebookLM Notebook (or reuse existing)
3. Upload Article - Upload parsed content as Source to Notebook
4. Verify - Check upload status and return Notebook ID and Source ID

中文：

1. 1. 抓取内容 - 使用 curl + r.jina.ai 提取 X 文章的纯文本内容
2. 创建 Notebook - 自动创建新的 NotebookLM Notebook（或复用现有的）
3. 上传文章 - 将解析后的内容作为 Source 上传到 Notebook
4. 验证效果 - 检查上传状态并返回 Notebook ID 和 Source ID

Output Example / 输出示例

English:
CODEBLOCK4

中文：

✅ X 文章解析上传成功

📄 文章标题：Elon Musk on X: "..."
🔗 原始链接：https://x.com/elonmusk/status/1234567890
📓 Notebook ID: notebook_abc123
📝 Source ID: source_xyz789
📊 解析状态：已处理完成

Configuration / 配置要求

Environment Variables / 环境变量（可选）

English:
CODEBLOCK6

中文：
CODEBLOCK7

NotebookLM Authentication / NotebookLM 认证

English:
Authenticate before first use:
CODEBLOCK8

中文：
首次使用前需要认证：

# 使用 NotebookLM CLI 登录
node ~/.openclaw/skills/tiangong-notebooklm-cli/scripts/notebooklm.mjs login

Troubleshooting / 故障排除

Common Issues / 常见问题

Q: "NotebookLM CLI not authenticated" error / 提示 "NotebookLM CLI not authenticated"

English:
CODEBLOCK10

中文：

# 运行登录命令
node ~/.openclaw/skills/tiangong-notebooklm-cli/scripts/notebooklm.mjs login

English:

• - Check if URL is correct
• X articles may require login to access
• Try using a logged-in browser session
• Note: Most X (Twitter) content now requires login; r.jina.ai may not be able to fetch content requiring login
• Alternative: Use browser tool with logged-in browser session

中文：

• - 检查 URL 是否正确
• X 文章可能需要登录才能访问
• 尝试使用已登录的浏览器会话
• 注意：X (Twitter) 大部分内容现在需要登录，r.jina.ai 可能无法抓取需要登录的内容
• 替代方案：使用 browser 工具配合已登录的浏览器会话

English:

• - Increase timeout: add --timeout 60 parameter
• Check network connection

中文：

• - 增加超时时间：添加 --timeout 60 参数
• 检查网络连接

English:

• - This is normal; NotebookLM is processing the uploaded content
• Wait a few minutes and check in NotebookLM interface

中文：

• - 这是正常现象，NotebookLM 正在处理上传的内容
• 等待几分钟后在 NotebookLM 界面中查看

X Article Fetching Limitations / X 文章抓取限制

English:
Due to stricter access restrictions implemented by X (Twitter) after 2023:

• - ✅ Public articles - r.jina.ai can fetch
• ⚠️ Articles requiring login - r.jina.ai cannot fetch
• 💡 Solution - Use browser tool with logged-in browser session, or manually copy content

中文：
由于 X (Twitter) 在 2023 年后实施了更严格的访问限制：

• - ✅ 公开文章 - r.jina.ai 可以抓取
• ⚠️ 需要登录的文章 - r.jina.ai 无法抓取
• 💡 解决方案 - 使用 browser 工具配合已登录的浏览器会话，或手动复制内容

Test Results / 测试结果

English:

• - Test Time: 2026-03-07 23:46 (Beijing Time)
• Test URL: https://github.com/openclaw/openclaw
• Result: ✅ Success

CODEBLOCK12

中文：

• - 测试时间: 2026-03-07 23:46 (北京时间)
• 测试 URL: https://github.com/openclaw/openclaw
• 测试结果: ✅ 成功

CODEBLOCK13

Related Files / 相关文件

English:

• - Main script: INLINECODE6
• Metadata: INLINECODE7
• NotebookLM CLI docs: INLINECODE8

中文：

• - 主脚本：INLINECODE9
• 元数据：INLINECODE10
• NotebookLM CLI 文档：INLINECODE11

Version History / 版本历史

English:

• - v1.1.0 (2026-03-12) - Add Chinese-English bilingual support
• v1.0.0 (2026-03-07) - Initial release

中文：

• - v1.1.0 (2026-03-12) - 添加中英双语支持
• v1.0.0 (2026-03-07) - 初始版本