README.md

---

title: Notion2API Node.js
emoji: 🚀
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
---

# Notion API 轻量级客户端

这个项目提供了一个轻量级的 Notion API 客户端，可以在资源受限的环境（如 Termux）中运行，无需完整的浏览器环境。

## 特点

- 使用 `node-fetch` 代替 Playwright 浏览器自动化
- 轻量级设计，适合在移动设备和资源受限环境中运行
- 支持 Notion AI 的流式响应
- 兼容 OpenAI API 格式的请求和响应

## 安装

### 依赖项

确保安装以下依赖：

```bash

npm install

```

### 环境变量

创建 `.env` 文件，设置以下环境变量：

```

NOTION_COOKIE=your_notion_cookie_here

NOTION_SPACE_ID=optional_space_id

NOTION_ACTIVE_USER_HEADER=optional_user_id

PROXY_URL=optional_proxy_url

PROXY_AUTH_TOKEN=your_auth_token

PORT=7860

```

## 使用方法

### 启动服务

运行轻量级服务器：

```bash

npm start

```

服务器将在指定端口（默认 7860）启动。

如果需要使用原始的基于 Playwright 的版本（不推荐在 Termux 中使用）：

```bash

npm run original

```

### API 端点

- `GET /v1/models` - 获取可用模型列表
- `POST /v1/chat/completions` - 聊天完成端点
- `GET /health` - 健康检查

### 在 Termux 中运行

1. 安装 Termux 和 Node.js：
```bash

pkg update

pkg install nodejs

```

2. 克隆项目并安装依赖：
```bash

git clone https://github.com/yourusername/notion2api-nodejs.git

cd notion2api-nodejs

npm install

```

3. 设置环境变量并运行：
```bash

npm start

```

## 作为模块集成

你也可以将轻量级客户端作为模块导入到你自己的项目中：

```javascript

import {

  initialize,

  streamNotionResponse,

  buildNotionRequest,

  FETCHED_IDS_SUCCESSFULLY

} from './lightweight-client.js';



// 初始化客户端

await initialize();



// 检查是否成功获取 Notion IDs

if (FETCHED_IDS_SUCCESSFULLY) {

  // 构建请求

  const requestData = {

    notion_model: "openai-gpt-4.1",

    messages: [

      { role: "user", content: "你好，请介绍一下自己" }

    ]

  };

  

  const notionRequestBody = buildNotionRequest(requestData);

  

  // 获取响应流

  const stream = await streamNotionResponse(notionRequestBody);

  

  // 处理响应

  stream.on('data', chunk => {

    console.log(chunk.toString());

  });

}

```

## 故障排除

- 如果无法获取 Notion IDs，请确保提供了有效的 NOTION_COOKIE

- 对于网络问题，可以尝试设置 PROXY_URL
- 查看日志输出以获取详细的错误信息

## 依赖说明

- `node-fetch`: 用于发送 HTTP 请求
- `jsdom`: 提供 DOM API 的轻量级模拟
- `dotenv`: 加载环境变量
- `express`: Web 服务器框架
- `https-proxy-agent`: 支持 HTTPS 代理

## Cookie管理功能

本项目新增了Cookie管理功能，可以更方便地管理多个Notion Cookie，避免在.env文件中手动编辑长字符串。

### 使用方法

#### 1. 通过文件管理Cookie

在项目根目录创建一个`cookies.txt`文件，每行一个完整的Cookie字符串：

```

cookie1_string_here

cookie2_string_here

cookie3_string_here

```

然后在`.env`文件中设置：

```

COOKIE_FILE=cookies.txt

```

系统启动时会自动从该文件加载Cookie。

#### 2. 使用Cookie管理工具

项目提供了一个命令行工具来管理Cookie：

```bash

# 使用npm脚本运行

npm run cookie



# 或者全局安装后运行

npm link

notion-cookie

```

命令行工具支持以下功能：

- `help`: 显示帮助信息
- `list`: 列出所有已加载的Cookie
- `add`: 添加新的Cookie
- `validate`: 验证所有Cookie的有效性
- `remove`: 删除指定的Cookie
- `save`: 保存Cookie到文件
- `load`: 从文件加载Cookie
- `exit`: 退出程序

### Cookie轮询机制

系统会自动轮询使用所有有效的Cookie，当一个Cookie返回401错误（未授权）时，会自动将其标记为无效并切换到下一个Cookie。这样可以提高系统的可靠性和可用性。

### 文件格式支持

Cookie管理器支持两种文件格式：

1. 文本格式（.txt）：每行一个Cookie
2. JSON格式（.json）：包含Cookie数组的JSON文件

```json

{

  "cookies": [

    "cookie1_string_here",

    "cookie2_string_here"

  ],

  "updatedAt": "2023-08-01T12:00:00.000Z",

  "count": 2

}

```

或者简单的数组：

```json

[

  "cookie1_string_here",

  "cookie2_string_here"

]

```