X To Notebooklm

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:

# Run from workspace root
node ~/.openclaw/workspace/skills/x-to-notebooklm/scripts/x-to-notebooklm.mjs <X_Article_URL>

# Example
node ~/.openclaw/workspace/skills/x-to-notebooklm/scripts/x-to-notebooklm.mjs "https://x.com/elonmusk/status/1234567890"

中文：

# 从工作区根目录运行
node ~/.openclaw/workspace/skills/x-to-notebooklm/scripts/x-to-notebooklm.mjs <X 文章 URL>

# 示例
node ~/.openclaw/workspace/skills/x-to-notebooklm/scripts/x-to-notebooklm.mjs "https://x.com/elonmusk/status/1234567890"

Advanced Usage / 高级用法

English:

# Specify notebook name
node ~/.openclaw/workspace/skills/x-to-notebooklm/scripts/x-to-notebooklm.mjs <URL> --notebook-name "X Articles"

# Use existing notebook
node ~/.openclaw/workspace/skills/x-to-notebooklm/scripts/x-to-notebooklm.mjs <URL> --notebook-id <existing_notebook_id>

# Verbose output mode
node ~/.openclaw/workspace/skills/x-to-notebooklm/scripts/x-to-notebooklm.mjs <URL> --verbose

中文：

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

Output Example / 输出示例

English:

✅ X article parsed and uploaded successfully

📄 Title: Elon Musk on X: "..."
🔗 URL: https://x.com/elonmusk/status/1234567890
📓 Notebook ID: notebook_abc123
📝 Source ID: source_xyz789
📊 Status: Processing complete

中文：

✅ X 文章解析上传成功

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

Configuration / 配置要求

Environment Variables / 环境变量（可选）

English:

# Default notebook name (if --notebook-name not specified)
export NOTEBOOKLM_DEFAULT_NOTEBOOK="X Articles"

# Verbose mode
export X_TO_NOTEBOOKLM_VERBOSE=true

中文：

# 默认 Notebook 名称（如不指定 --notebook-name）
export NOTEBOOKLM_DEFAULT_NOTEBOOK="X Articles"

# 详细模式
export X_TO_NOTEBOOKLM_VERBOSE=true

NotebookLM Authentication / NotebookLM 认证

English: Authenticate before first use:

# Login using NotebookLM CLI
node ~/.openclaw/skills/tiangong-notebooklm-cli/scripts/notebooklm.mjs login

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

# 使用 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:

# Run login command
node ~/.openclaw/skills/tiangong-notebooklm-cli/scripts/notebooklm.mjs login

中文：

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

Q: r.jina.ai cannot access X article / r.jina.ai 无法访问 X 文章

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 工具配合已登录的浏览器会话

Q: Script execution timeout / 脚本执行超时

English:

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

中文：

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

Q: Source ID shows "pending" / Source ID 显示为 "pending"

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

📓 Notebook ID: 6367c115-bcfa-42f3-b174-456df3537122
📝 Source ID: 658c3733-a02f-4b08-ae16-fc06475d1c19
📊 Status: processed

中文：

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

📓 Notebook ID: 6367c115-bcfa-42f3-b174-456df3537122
📝 Source ID: 658c3733-a02f-4b08-ae16-fc06475d1c19
📊 解析状态：processed

Related Files / 相关文件

English:

• Main script: scripts/x-to-notebooklm.mjs
• Metadata: _meta.json
• NotebookLM CLI docs: ~/.openclaw/skills/tiangong-notebooklm-cli/references/cli-commands.md

中文：

• 主脚本：scripts/x-to-notebooklm.mjs
• 元数据：_meta.json
• NotebookLM CLI 文档：~/.openclaw/skills/tiangong-notebooklm-cli/references/cli-commands.md

Version History / 版本历史

English:

• v1.1.0 (2026-03-12) - Add Chinese-English bilingual support
• v1.0.0 (2026-03-07) - Initial release
  • Support X article fetching
  • Automatic notebook creation
  • Upload and verify

中文：

• v1.1.0 (2026-03-12) - 添加中英双语支持
• v1.0.0 (2026-03-07) - 初始版本
  • 支持 X 文章抓取
  • 自动创建 Notebook
  • 上传并验证

Version 1.1.0 / 版本 1.1.0