Bilibili Cookie Acquisition Tool

https://github.com/wittf/bilibili-qr-login
Admin
A tool that enables users to quickly log into Bilibili by scanning a QR code, obtain their cookies,...
Tokens:9,880
Snippets:26
Trust Score:8.4
License:MIT
Update:1 year ago
Show doc for...
Tokens:
Raw
### Docker Deployment for Bilibili QR Login (Bash)

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

This section provides commands for deploying the Bilibili QR Login service using Docker. It covers pulling the latest image, basic deployment, production setups with custom ports and environment variables (like PORT, NODE_ENV, TRUST_ORIGIN, DEBUG), development setups with debug logging, checking container logs, and stopping/removing containers.

```bash
# Pull latest image
docker pull wittf/bilibili-qr-login:latest

# Basic deployment
docker run -d \
  --name bili-qrlogin \
  -p 3000:3000 \
  wittf/bilibili-qr-login:latest

# Production with custom port and trusted origins
docker run -d \
  --name bili-qrlogin \
  -p 8080:3000 \
  -e PORT=3000 \
  -e NODE_ENV=production \
  -e TRUST_ORIGIN="https://app.example.com,https://admin.example.com" \
  -e DEBUG=0 \
  --restart unless-stopped \
  wittf/bilibili-qr-login:latest

# Development with debug logging
docker run -d \
  --name bili-qrlogin-dev \
  -p 3000:3000 \
  -e NODE_ENV=development \
  -e DEBUG=1 \
  -e TRUST_ORIGIN="*" \
  wittf/bilibili-qr-login:latest

# Check logs
docker logs -f bili-qrlogin

# Stop and remove
docker stop bili-qrlogin
docker rm bili-qrlogin

```

--------------------------------

### JavaScript: Initialize Page Metadata and Language Settings

Source: https://github.com/wittf/bilibili-qr-login/blob/main/dev/index.html

This script initializes the page's language and metadata, including SEO and Open Graph tags. It calls `detectLanguage` and `getDevTranslations` to get the appropriate content. It also sets the HTML `lang` attribute, title, description, keywords, and various social media tags. Includes error handling for default settings.

```javascript
try {
    const currentLang = detectLanguage();
    const t = getDevTranslations(currentLang);
    const currentUrl = window.location.href;
    const imageUrl = new URL(t.image.url, window.location.origin).href;

    // 设置HTML lang属性
    document.documentElement.lang = currentLang;

    // 设置基本SEO标签
    document.title = t.title;
    setMetaTag('description', t.description);
    setMetaTag('keywords', t.keywords);

    // 设置Open Graph标签
    setMetaTag('og:url', currentUrl, true);
    setMetaTag('og:title', t.title, true);
    setMetaTag('og:description', t.description, true);
    setMetaTag('og:image', imageUrl, true);
    setMetaTag('og:image:alt', t.image.alt, true);
    setMetaTag('og:site_name', t.siteName, true);
    setMetaTag('og:locale', currentLang, true);

    // 设置Twitter Cards标签
    setMetaTag('twitter:url', currentUrl);
    setMetaTag('twitter:title', t.title);
    setMetaTag('twitter:description', t.description);
    setMetaTag('twitter:image', imageUrl);
    setMetaTag('twitter:image:alt', t.image.alt);

    // 设置canonical URL
    const canonicalLink = document.getElementById('canonical-url');
    if (canonicalLink) {
        canonicalLink.href = currentUrl;
    }

    // 更新网站名称
    const ogSiteName = document.querySelector('meta[property="og:site_name"]');
    if (ogSiteName) {
        ogSiteName.setAttribute('content', t.siteName);
    }
} catch (error) {
    console.error('语言初始化失败，使用默认设置:', error);
    document.documentElement.lang = 'zh-CN';
    document.title = '开发专用页面';
    // 设置默认meta标签
    setMetaTag('description', '哔哩哔哩二维码登录工具开发版 - 开发测试专用页面');
    setMetaTag('keywords', '哔哩哔哩,bilibili,开发版,测试,二维码登录,开发工具');
    setMetaTag('og:title', '开发专用页面', true);
    setMetaTag('og:description', '哔哩哔哩二维码登录工具开发版 - 开发测试专用页面', true);
    setMetaTag('twitter:title', '开发专用页面');
    setMetaTag('twitter:description', '哔哩哔哩二维码登录工具开发版 - 开发测试专用页面');
}
```

--------------------------------

### Utility: Load Sample Cookie Data

Source: https://github.com/wittf/bilibili-qr-login/blob/main/demo/example.html

Loads predefined sample cookie data into the cookie input field. This function is intended to provide users with example data for testing the cookie conversion functionality.

```javascript
function loadSample() {
    document.getElementById('cookieInput').value = 'SESSDATA=cb06b5c2%2C1641234567%2Cb1a2c*31; bili_jct=abc123def456; DedeUserID=12345678';
}
```

--------------------------------

### Send Login Results via PostMessage (TypeScript)

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

This snippet demonstrates how to send login success messages with cookies to a parent window or opener for iframe/popup integrations. It includes an example of listening for these messages in the parent window, verifying the origin for security, and handling different integration modes ('iframe' or 'window'). It also shows how to create and append an iframe or open a popup window for embedded login.

```typescript
import { postQrMessage } from './utils/postMessage';
import { PARAM_MODE } from './utils/const';

// When login succeeds
if (state.status === QrStatus.SUCCESS && state.cookie) {
  postQrMessage({
    type: 'success',
    data: state.cookie
  });
}

// In parent window, listen for the message
window.addEventListener('message', (event) => {
  // Verify origin for security
  if (event.origin !== 'https://login.bilibili.bi') {
    return;
  }

  const { type, mode, data } = event.data;
  if (type === 'success') {
    console.log('Login mode:', mode); // 'iframe' or 'window' 
    console.log('Cookie received:', data);
    // Store cookie, close popup, etc.
    if (mode === 'window') {
      window.close(); // Close popup window
    }
  }
});

// Open embedded login in iframe
const iframe = document.createElement('iframe');
iframe.src = 'https://login.bilibili.bi/?mode=iframe&theme=dark&lang=en';
document.body.appendChild(iframe);

// Open embedded login in popup
const popup = window.open(
  'https://login.bilibili.bi/?mode=window&theme=light',
  'BilibiliLogin',
  'width=500,height=600'
);

```

--------------------------------

### JavaScript: Get Multilingual Translations for Bilibili QR Login Tool

Source: https://github.com/wittf/bilibili-qr-login/blob/main/dev/index.html

This function retrieves translation strings based on the provided language code. It supports Chinese (Simplified and Traditional), English, and Japanese, returning localized text for titles, descriptions, keywords, and site names. It defaults to 'zh-CN' if the language is not found.

```javascript
function getDevTranslations(lang) {
    const translations = {
        'zh-CN': {
            title: '开发专用页面',
            description: '哔哩哔哩二维码登录工具开发版 - 开发测试专用页面',
            keywords: '哔哩哔哩,bilibili,开发版,测试,二维码登录,开发工具',
            siteName: '哔哩哔哩二维码登录工具开发版',
            image: {
                url: '../favicon.svg',
                alt: '哔哩哔哩二维码登录工具开发版图标'
            }
        },
        'zh-TW': {
            title: '開發專用頁面',
            description: 'bilibili 二維碼登入工具開發版 - 開發測試專用頁面',
            keywords: 'bilibili,開發版,測試,二維碼登入,開發工具',
            siteName: 'bilibili 二維碼登入工具開發版',
            image: {
                url: '../favicon.svg',
                alt: 'bilibili 二維碼登入工具開發版圖標'
            }
        },
        'en': {
            title: 'Development Page',
            description: 'Bilibili QR Code Login Tool Development Version - Development and testing page',
            keywords: 'bilibili,development,testing,QR code,login,dev tools',
            siteName: 'Bilibili QR Login Tool Development',
            image: {
                url: '../favicon.svg',
                alt: 'Bilibili QR Login Tool Development Icon'
            }
        },
        'jp': {
            title: '開発専用ページ',
            description: 'bilibili QRコードログインツール開発版 - 開発・テスト専用ページ',
            keywords: 'bilibili,開発版,テスト,QRコード,ログイン,開発ツール',
            siteName: 'bilibili QRログインツール開発版',
            image: {
                url: '../favicon.svg',
                alt: 'bilibili QRログインツール開発版アイコン'
            }
        }
    };
    return translations[lang] || translations['zh-CN'];
}
```

--------------------------------

### Docker 部署 Bilibili Cookie 获取工具 (Bash)

Source: https://github.com/wittf/bilibili-qr-login/blob/main/README.md

使用 Docker 部署 Bilibili Cookie 获取工具。首先拉取预构建的 Docker 镜像，然后运行一个容器并将宿主机的 3000 端口映射到容器的 3000 端口。

```bash
# 拉取镜像
docker pull wittf/bilibili-qr-login:latest

# 运行容器
docker run -d \
  --name bili-qrlogin \
  -p 3000:3000 \
  wittf/bili-qrlogin:latest
```

--------------------------------

### Bilibili QR Code Authentication Backend Classes (TypeScript)

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

These classes, `LoginQr` and `LoginQrTV`, handle the backend authentication protocols for Bilibili's QR code login, supporting both web and TV clients. They are responsible for generating QR codes and polling for authentication status. Inputs include user agent, last event ID, session ID, and auth code, with outputs ranging from QR code details to authentication cookies. Dependencies are not explicitly listed but imply interaction with Bilibili's authentication APIs.

```typescript
// server/app.ts - Web client authentication
const qr = new LoginQr(userAgent, lastEventID, sessionId);

// Generate QR code
const genRes = await qr.generate();
if (genRes.code === 0) {
  console.log('QR URL:', genRes.url);
  console.log('QR Key:', genRes.key);
}
// Returns: { code: 0, msg: "成功", url: "https://...", key: "abc123" }

// Poll for authentication status
const pollResult = await qr.poll();
switch (pollResult.code) {
  case 0: // Success
    console.log('Cookie:', pollResult.cookie);
    console.log('Validation:', pollResult.cookieValidation);
    break;
  case 86101: // Not scanned
    console.log('Waiting for scan...');
    break;
  case 86090: // Scanned, not confirmed
    console.log('User scanned, waiting for confirmation...');
    break;
  case 86038: // Expired
    console.log('QR code expired');
    break;
  default:
    console.error('Error:', pollResult.msg);
}

// TV client authentication
const qrTV = new LoginQrTV(userAgent, authCode, sessionId);

// Generate TV QR code
const tvGenRes = await qrTV.generate();
// Returns: { code: 0, msg: "成功", url: "https://...", key: "auth_code_here" }

// Poll TV authentication
const tvPollResult = await qrTV.poll();
// Returns cookie with access_token, refresh_token, and mid for TV clients

```

--------------------------------

### Configure Trusted Origins for Embedded Login (Bash)

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

These commands demonstrate how to configure the TRUST_ORIGIN environment variable for development and production environments. This variable controls which domains are allowed to receive authentication data in embedded mode, enhancing security. Options include allowing all origins for development, restricting to the same origin for production, specifying single or multiple trusted domains, and setting it for Docker deployments.

```bash
# Development - Allow all origins
TRUST_ORIGIN="*" npm run dev

# Production - Same origin only (most secure)
TRUST_ORIGIN="" npm run build && npm run preview

# Production - Single trusted domain
TRUST_ORIGIN="https://yourdomain.com" npm run preview

# Production - Multiple trusted domains
TRUST_ORIGIN="https://app.com,https://admin.app.com,https://mobile.app.com" npm run preview

# Docker deployment with trusted origins
docker run -d \
  --name bili-qrlogin \
  -p 3000:3000 \
  -e TRUST_ORIGIN="https://yourdomain.com" \
  wittf/bilibili-qr-login:latest

# Enable debug logging
DEBUG=1 npm run preview
# Shows detailed logs: API calls, cookie parsing, validation steps

# Production mode without debug
NODE_ENV=production npm run preview
# Shows only important logs: connection events, errors, warnings

```

--------------------------------

### Sign Bilibili TV Client API Request Parameters (TypeScript)

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

The `signTVParams` function and `generateSign` utility are used to create signed parameters for Bilibili TV client API requests. This is crucial for authenticating requests made from TV devices. The `signTVParams` function takes an object of parameters and returns a signed object including `appkey`, `ts`, `local_id`, and the `sign`. The `generateSign` function allows for manual signature creation using a payload and the app secret. Dependencies include `TV_APPKEY` and `TV_APPSEC` from './server/sign'.

```typescript
import { signTVParams, TV_APPKEY, TV_APPSEC } from './server/sign';

// Sign TV authentication request
const params = signTVParams({
  local_id: 0,
});
console.log(params);
// Output:
// {
//   appkey: '4409e2ce8ffd12b8',
//   local_id: 0,
//   ts: 1672567890,
//   sign: 'a3d5e8c9f1b2e4d6...' // MD5 hash
// }

// Sign TV polling request
const pollParams = signTVParams({
  auth_code: 'abc123def456',
  local_id: 0,
});
// Use with form-urlencoded POST requests to Bilibili TV endpoints

// Manual signature generation
import { generateSign } from './server/sign';
const signature = generateSign(
  { appkey: TV_APPKEY, ts: 1672567890, local_id: 0 },
  TV_APPSEC
);
console.log(signature); // '9f7e5d3c1a...'

```

--------------------------------

### Generate Bilibili TV Client QR Code and Stream Events

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

This endpoint generates a QR code specifically for Bilibili TV client authentication and streams real-time authentication status updates via Server-Sent Events (SSE). It requires the `client=tv` query parameter. The output format is identical to the web client stream, providing QR code URLs, scan status, and session cookies upon successful authentication.

```bash
curl -N "http://localhost:3000/api/qr?client=tv"
```

--------------------------------

### 本地部署 Bilibili Cookie 获取工具 (Bash)

Source: https://github.com/wittf/bilibili-qr-login/blob/main/README.md

用于在本地克隆并运行 Bilibili Cookie 获取工具。需要安装 Node.js 和 Yarn。首先克隆仓库，然后安装依赖，最后启动项目。

```bash
# 克隆仓库
git clone https://github.com/WittF/bilibili-qr-login.git

# 进入项目目录
cd bilibili-qr-login

# 运行项目（根据项目实际运行方式调整）
yarn install
yarn start
```

--------------------------------

### Vue Composable for QR Code Authentication State Management (TypeScript)

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

The `useQrSSE` composable manages the reactive state for the QR code authentication flow in Vue applications. It handles connection management, status updates, and retrieval of authentication tokens. Dependencies include the `QrStatus` enum from './utils/qrSSE'. It takes a client type ('web' or 'tv') as an argument and returns reactive state, getters, and control functions.

```typescript
import { useQrSSE, QrStatus } from './utils/qrSSE';

// Initialize with web client
const { state, getters, restart, stop, setClientType } = useQrSSE('web');

// Reactive state object
console.log(state.status); // QrStatus.LOADING
console.log(state.url); // QR code URL (empty until generated)
console.log(state.cookie); // Retrieved cookie string (empty until success)
console.log(state.errMsg); // Error message if any
console.log(state.cookieValidation); // Cookie validation result

// Get human-readable status text
console.log(getters.statusText); // "正在加载..." / "请扫码登录" / "登录成功" etc.

// Switch to TV client mode
setClientType('tv');

// Restart the authentication flow
restart();

// Stop SSE connection (cleanup on component unmount)
stop();

// Status enum values:
// QrStatus.LOADING - Initial state, connecting to server
// QrStatus.WAIT - QR code generated, waiting for scan
// QrStatus.SCANNED - QR code scanned, waiting for confirmation
// QrStatus.EXPIRED - QR code expired, user must refresh
// QrStatus.SUCCESS - Login successful, cookie retrieved
// QrStatus.ERROR - Error occurred, check state.errMsg

// Example usage in Vue component:
import { watch } from 'vue';

watch(() => state.status, (newStatus) => {
  if (newStatus === QrStatus.SUCCESS) {
    console.log('Login successful!');
    console.log('Cookie:', state.cookie);
    // Cookie validation result
    if (state.cookieValidation?.status === 'success') {
      console.log('Cookie is valid and functional');
    } else {
      console.warn('Cookie may have limited functionality:',
        state.cookieValidation?.message);
    }
  } else if (newStatus === QrStatus.EXPIRED) {
    console.log('QR code expired, please refresh');
    restart();
  }
});

```

--------------------------------

### Bilibili Login: Popup Window Mode

Source: https://github.com/wittf/bilibili-qr-login/blob/main/demo/example.html

Opens a new browser window for Bilibili login in popup mode. It uses `window.open()` with specified dimensions and settings, and provides user feedback via status messages, including an error if popups are blocked by the browser.

```javascript
const SERVICE_URL = 'https://login.bilibili.bi';

function openWindow() {
    const popup = window.open(
        `${SERVICE_URL}/?mode=window`,
        'bili_login',
        'width=420,height=610,resizable=no,scrollbars=no'
    );
    if (!popup) {
        showStatus('弹窗被阻止，请允许弹窗后重试', 'error');
        return;
    }
    showStatus('登录窗口已打开，请在弹窗中完成登录', 'info');
}
```

--------------------------------

### Generate Bilibili Web Client QR Code and Stream Events

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

This endpoint generates a QR code for Bilibili web client authentication and streams real-time authentication status updates using Server-Sent Events (SSE). It requires no input parameters for the default web client mode. The output includes QR code URLs, scan status (unscanned, scanned, confirmed), and eventually the Bilibili session cookies upon successful authentication.

```bash
curl -N "http://localhost:3000/api/qr?client=web"

# Example SSE events received:
# event: generate
# data: {"code":0,"msg":"成功","url":"https://passport.bilibili.com/...","key":"abc123"}
#
# event: poll
# data: {"code":86101,"msg":"未扫码"}
#
# event: poll
# data: {"code":86090,"msg":"已扫码未确认"}
#
# event: poll
# data: {"code":0,"msg":"成功","cookie":"SESSDATA=xxx; bili_jct=yyy; DedeUserID=123","cookieValidation":{"status":"success","message":"Cookie验证通过"}}
#
# event: end
# data:
```

--------------------------------

### QR Code Authentication Stream

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

This endpoint provides a Server-Sent Events (SSE) stream for generating QR codes and monitoring authentication status in real-time. It supports both web and TV client modes.

```APIDOC
## GET /api/qr

### Description
Provides a Server-Sent Events (SSE) stream for generating Bilibili QR codes and monitoring authentication status in real-time. Supports different client modes.

### Method
GET

### Endpoint
`/api/qr`

### Query Parameters
- **client** (string) - Optional - Specifies the client mode. Accepted values are `web` (default) or `tv`.

### Response
#### Success Response (200) - SSE Stream
- **event: generate**: Data contains `url` and `key` for QR code generation.
- **event: poll**: Data contains status codes (`code`) and messages (`msg`) indicating scan status. May include `cookie` and `cookieValidation` upon successful login.
- **event: end**: Indicates the end of the stream.

#### Response Example (SSE)
```
event: generate
data: {"code":0,"msg":"成功","url":"https://passport.bilibili.com/qrcode/mlogin?qrurl=xxx","key":"abc123"}

event: poll
data: {"code":86090,"msg":"已扫码未确认"}

event: poll
data: {"code":0,"msg":"成功","cookie":"SESSDATA=xxx; bili_jct=yyy; DedeUserID=123","cookieValidation":{"status":"success","message":"Cookie验证通过"}}

event: end
data:
```
```

--------------------------------

### JavaScript: Set Meta Tags for SEO and Open Graph

Source: https://github.com/wittf/bilibili-qr-login/blob/main/dev/index.html

This utility function safely creates or updates meta tags in the HTML document's head. It handles both standard 'name' attributes and 'property' attributes for Open Graph tags. It ensures tags exist before setting their content, and is used for SEO and social sharing optimization.

```javascript
function setMetaTag(name, content, property = false) {
    const attribute = property ? 'property' : 'name';
    let meta = document.querySelector(`meta[${attribute}="${name}"]`);
    if (!meta) {
        meta = document.createElement('meta');
        meta.setAttribute(attribute, name);
        document.head.appendChild(meta);
    }
    meta.setAttribute('content', content);
}
```

--------------------------------

### Bilibili Login: Iframe Mode

Source: https://github.com/wittf/bilibili-qr-login/blob/main/demo/example.html

Handles the opening and closing of an iframe for Bilibili login. It dynamically creates an iframe element, sets its source to the Bilibili login page in iframe mode, and updates button text and status messages. It also manages the visibility and content of a designated container element.

```javascript
const SERVICE_URL = 'https://login.bilibili.bi';
let isIframeOpen = false;

function openIframe() {
    const container = document.getElementById('iframeContainer');
    const btn = event.target;
    if (!isIframeOpen) {
        container.innerHTML = '';
        container.style.display = 'block';
        const iframe = document.createElement('iframe');
        iframe.src = `${SERVICE_URL}/?mode=iframe`;
        container.appendChild(iframe);
        btn.textContent = '❌ 关闭iframe';
        isIframeOpen = true;
        showStatus('iframe登录已打开，请扫码登录', 'info');
    } else {
        container.style.display = 'none';
        container.innerHTML = '';
        btn.textContent = '📱 iframe模式';
        isIframeOpen = false;
        hideStatus();
    }
}
```

--------------------------------

### Utility: Show and Hide Login Status

Source: https://github.com/wittf/bilibili-qr-login/blob/main/demo/example.html

Manages the display of status messages related to the login process. `showStatus` updates the text content and class of a status element, optionally setting a timeout to hide it. `hideStatus` simply hides the status element.

```javascript
function showStatus(message, type = 'info') {
    const status = document.getElementById('loginStatus');
    status.textContent = message;
    status.className = `status ${type}`;
    status.style.display = 'block';
    if (type === 'info') {
        setTimeout(hideStatus, 3000);
    }
}

function hideStatus() {
    const status = document.getElementById('loginStatus');
    status.style.display = 'none';
}
```

--------------------------------

### Bilibili Login: Message Event Listener

Source: https://github.com/wittf/bilibili-qr-login/blob/main/demo/example.html

Listens for messages from the Bilibili login service to handle login success events. It verifies the message origin, logs received data, and updates the UI based on the login status and mode. For iframe mode, it includes a timeout to automatically close the login UI.

```javascript
window.addEventListener('message', (event) => {
    const SERVICE_URL = 'https://login.bilibili.bi';
    if (event.origin !== SERVICE_URL) {
        console.warn('[Demo] 收到非预期来源的消息:', event.origin, '预期:', SERVICE_URL);
        return;
    }
    console.log('[Demo] 收到登录消息:', event.data);
    const { type, mode, data } = event.data;
    if (type === 'success') {
        showStatus(`✅ ${mode}模式登录成功！Cookie已获取`, 'success');
        document.getElementById('cookieInput').value = data;
        if (mode === 'iframe') {
            setTimeout(() => {
                const container = document.getElementById('iframeContainer');
                container.style.display = 'none';
                document.querySelector('[onclick="openIframe()"]').textContent = '📱 iframe模式';
                isIframeOpen = false;
            }, 2000);
        }
    }
});
```

--------------------------------

### Utility: Display Conversion Result

Source: https://github.com/wittf/bilibili-qr-login/blob/main/demo/example.html

Displays the result of the cookie conversion process in a designated result box. It updates the text content and applies a CSS class based on the success or error status of the conversion.

```javascript
function showResult(message, type) {
    const resultBox = document.getElementById('convertResult');
    resultBox.textContent = message;
    resultBox.className = `result-box ${type}`;
    resultBox.style.display = 'block';
}
```

--------------------------------

### Convert Cookie Array to JSON

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

This API endpoint converts Bilibili cookies provided in a JSON array format into a structured JSON format suitable for TinyDB. It accepts a JSON payload where the `cookies` field is an array of cookie objects, each with properties like `name`, `value`, and `domain`. Invalid input data will result in a 400 error response.

```bash
curl -X POST http://localhost:3000/api/convert \
  -H "Content-Type: application/json" \
  -d '{ "cookies": [{"name": "SESSDATA", "value": "xxx", "domain": ".bilibili.com"}, {"name": "bili_jct", "value": "yyy"}] }'

# Error response (400):
# {"error": "无效的cookie数据"}
```

--------------------------------

### Cookie Format Conversion API

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

This API endpoint allows conversion of Bilibili cookie strings into a structured JSON format compatible with TinyDB, often used in browser automation tools.

```APIDOC
## POST /api/convert

### Description
Converts cookie strings or JSON arrays into a structured JSON format compatible with TinyDB. This is useful for integrating with browser automation tools.

### Method
POST

### Endpoint
`/api/convert`

### Request Body
- **cookies** (string | array) - Required - Either a string containing semi-colon separated cookies or an array of cookie objects.
  - If array: each object should have at least `name` and `value` properties. Optional properties include `domain`, `path`, `expires`, `httpOnly`, `secure`, `sameSite`.

### Request Example (String Input)
```json
{
  "cookies": "SESSDATA=cb06b5c2%2C1641234567%2Cb1a2c*31; bili_jct=abc123def456; DedeUserID=123456789"
}
```

### Request Example (Array Input)
```json
{
  "cookies": [
    {"name": "SESSDATA", "value": "xxx", "domain": ".bilibili.com"},
    {"name": "bili_jct", "value": "yyy"}
  ]
}
```

### Response
#### Success Response (200)
- **_default** (object) - Contains cookie data organized for TinyDB.
  - **1** (object) - Represents a set of cookies.
    - **key** (string) - Typically "cookie".
    - **value** (array) - An array of cookie objects, each with properties like `name`, `value`, `domain`, `path`, `expires`, `httpOnly`, `secure`, `sameSite`.

#### Response Example (Success)
```json
{
  "_default": {
    "1": {
      "key": "cookie",
      "value": [
        {
          "name": "SESSDATA",
          "value": "cb06b5c2%2C1641234567%2Cb1a2c*31",
          "domain": ".bilibili.com",
          "path": "/",
          "expires": 1672567890.123,
          "httpOnly": true,
          "secure": true,
          "sameSite": "Lax"
        },
        {
          "name": "bili_jct",
          "value": "abc123def456",
          "domain": ".bilibili.com",
          "path": "/",
          "expires": 1672567890.123,
          "httpOnly": false,
          "secure": false,
          "sameSite": "Lax"
        },
        {
          "name": "DedeUserID",
          "value": "123456789",
          "domain": ".bilibili.com",
          "path": "/",
          "expires": 1672567890.123,
          "httpOnly": false,
          "secure": false,
          "sameSite": "Lax"
        }
      ]
    }
  }
}
```

#### Error Response (400)
- **error** (string) - Description of the error, e.g., "无效的cookie数据".

#### Error Response Example
```json
{
  "error": "无效的cookie数据"
}
```
```

--------------------------------

### Bilibili Cookie: Conversion Utility

Source: https://github.com/wittf/bilibili-qr-login/blob/main/demo/example.html

An asynchronous function to convert raw cookie strings into a structured JSON format using a remote API. It sends a POST request with the cookies and displays the formatted JSON result or any errors encountered. Includes loading indicators and status updates for the user.

```javascript
const API_URL = 'https://login.bilibili.bi/api/convert';

async function convertCookies() {
    const input = document.getElementById('cookieInput').value.trim();
    const resultBox = document.getElementById('convertResult');
    const btn = event.target;
    if (!input) {
        showResult('请输入Cookie数据', 'error');
        return;
    }
    const originalText = btn.innerHTML;
    btn.innerHTML = '<div class="spinner"></div> 转换中...';
    btn.disabled = true;
    try {
        const response = await fetch(API_URL, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify({ cookies: input })
        });
        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }
        const result = await response.json();
        const formattedJson = JSON.stringify(result, null, 2);
        const cookieCount = result._default['1'].value.length;
        showResult(`✅ 转换成功！(${cookieCount}个Cookie)\n\n${formattedJson}`, 'success');
    } catch (error) {
        showResult(`❌ 转换失败: ${error.message}`, 'error');
    } finally {
        btn.innerHTML = originalText;
        btn.disabled = false;
    }
}
```

--------------------------------

### Detect and Set Language - JavaScript

Source: https://github.com/wittf/bilibili-qr-login/blob/main/index.html

Detects the user's preferred language based on URL parameters, localStorage, and browser settings. It then sets the HTML lang attribute and retrieves translations for the detected language. Supports Chinese (Simplified and Traditional), English, and Japanese. Includes fallback to Chinese (Simplified).

```javascript
function detectLanguage() {
  const urlParams = new URLSearchParams(window.location.search);
  const langParam = urlParams.get('lang');
  if (langParam) {
    const lang = langParam.toLowerCase();
    if (lang === 'zh-cn' || lang === 'cn') return 'zh-CN';
    if (lang === 'zh-tw') return 'zh-TW';
    if (lang === 'en') return 'en';
    if (lang === 'ja' || lang === 'jp') return 'jp';
  }
  const savedLang = localStorage.getItem('bilibili-qr-lang');
  if (savedLang && ['zh-CN', 'zh-TW', 'en', 'jp'].includes(savedLang)) {
    return savedLang;
  }
  const browserLangs = navigator.languages || [navigator.language];
  for (const browserLang of browserLangs) {
    const lang = browserLang.toLowerCase();
    if (lang === 'zh-cn' || lang === 'zh_cn' || lang === 'cn' || lang.startsWith('zh-cn')) return 'zh-CN';
    if (lang === 'zh-tw' || lang === 'zh_tw' || lang.startsWith('zh-tw') || lang.startsWith('zh-hk') || lang.startsWith('zh-mo')) return 'zh-TW';
    if (lang === 'en' || lang.startsWith('en')) return 'en';
    if (lang === 'ja' || lang === 'jp' || lang.startsWith('ja') || lang.startsWith('jp')) return 'jp';
    if (lang.startsWith('zh')) return 'zh-CN';
  }
  return 'zh-CN';
}

function getTranslations(lang) {
  const translations = {
    'zh-CN': {
      title: { login: '哔哩哔哩登录', cookieTool: '哔哩哔哩 Cookie 获取工具' },
      description: '哔哩哔哩二维码登录工具 - 使用手机APP扫码快速登录哔哩哔哩，安全获取Cookie信息',
      keywords: '哔哩哔哩,bilibili,二维码登录,QR码,Cookie获取,扫码登录,B站登录',
      siteName: '哔哩哔哩二维码登录工具',
      image: { url: '/favicon.svg', alt: '哔哩哔哩二维码登录工具图标' }
    },
    'zh-TW': {
      title: { login: 'bilibili 登入', cookieTool: 'Bilibili Cookie 取得工具' },
      description: 'bilibili 二維碼登入工具 - 使用手機APP掃碼快速登入bilibili，安全取得Cookie資訊',
      keywords: 'bilibili,二維碼登入,QR碼,Cookie取得,掃碼登入,B站登入',
      siteName: 'bilibili 二維碼登入工具',
      image: { url: '/favicon.svg', alt: 'bilibili 二維碼登入工具圖標' }
    },
    'en': {
      title: { login: 'Bilibili Login', cookieTool: 'Bilibili Cookie Tool' },
      description: 'Bilibili QR Code Login Tool - Quickly login to Bilibili using mobile app QR scan, securely obtain Cookie information',
      keywords: 'bilibili,QR code,login,cookie,scan,mobile app,authentication',
      siteName: 'Bilibili QR Login Tool',
      image: { url: '/favicon.svg', alt: 'Bilibili QR Login Tool Icon' }
    },
    'jp': {
      title: { login: 'bilibili ログイン', cookieTool: 'Bilibili Cookie 取得ツール' },
      description: 'bilibili QRコードログインツール - モバイルアプリのQRスキャンでbilibiliに迅速ログイン、Cookieを安全取得',
      keywords: 'bilibili,QRコード,ログイン,Cookie,スキャン,モバイルアプリ,認証',
      siteName: 'bilibili QRログインツール',
      image: { url: '/favicon.svg', alt: 'bilibili QRログインツールアイコン' }
    }
  };
  return translations[lang] || translations['zh-CN'];
}

function setMetaTag(name, content, property = false) {
  const attribute = property ? 'property' : 'name';
  let meta = document.querySelector(`meta[${attribute}="${name}"]`);
  if (!meta) {
    meta = document.createElement('meta');
    meta.setAttribute(attribute, name);
    document.head.appendChild(meta);
  }
  meta.setAttribute('content', content);
}

try {
  const currentLang = detectLanguage();
  const t = getTranslations(currentLang);
  const PARAM_MODE = new URLSearchParams(window.location.search).get('mode') || '';
  const currentUrl = window.location.href;
  const pageTitle = PARAM_MODE ? t.title.login : t.title.cookieTool;
  const imageUrl = new URL(t.image.url, window.location.origin).href;

  document.documentElement.lang = currentLang;
  document.title = pageTitle;
  setMetaTag('description', t.description);
  setMetaTag('keywords', t.keywords);

  setMetaTag('og:url', currentUrl, true);
  setMetaTag('og:title', pageTitle, true);
  setMetaTag('og:description', t.description, true);
  setMetaTag('og:image', imageUrl, true);
  setMetaTag('og:image:alt', t.image.alt, true);
  setMetaTag('og:site_name', t.siteName, true);
  setMetaTag('og:locale', currentLang, true);

  setMetaTag('twitter:url', currentUrl);
  setMetaTag('twitter:title', pageTitle);
  setMetaTag('twitter:description', t.description);
  setMetaTag('twitter:image', imageUrl);
  setMetaTag('twitter:image:alt', t.image.alt);

  const canonicalLink = document.getElementById('canonical-url');
  if (canonicalLink) {
    canonicalLink.href = currentUrl;
  }

  const ogSiteName = document.querySelector('meta[property="og:site_name"]');
  if (ogSiteName) {
    ogSiteName.setAttribute('content', t.siteName);
  }
} catch (error) {
  console.error('语言初始化失败，使用默认设置:', error);
  document.documentElement.lang = 'zh-CN';
  document.title = '哔哩哔哩 Cookie 获取工具';
  setMetaTag('description', '哔哩哔哩二维码登录工具 - 使用手机APP扫码快速登录哔哩哔哩，安全获取Cookie信息');
  setMetaTag('keywords', '哔哩哔哩,bilibili,二维码登录,QR码,Cookie获取,扫码登录,B站登录');
  setMetaTag('og:title', '哔哩哔哩 Cookie 获取工具', true);
  setMetaTag('og:description', '哔哩哔哩二维码登录工具 - 使用手机APP扫码快速登录哔哩哔哩，安全获取Cookie信息', true);
  setMetaTag('twitter:title', '哔哩哔哩 Cookie 获取工具');
  setMetaTag('twitter:description', '哔哩哔哩二维码登录工具 - 使用手机APP扫码快速登录哔哩哔哩，安全获取Cookie信息');
}
```

--------------------------------

### Convert Cookie String to JSON

Source: https://context7.com/wittf/bilibili-qr-login/llms.txt

This API endpoint converts a Bilibili cookie string into a structured JSON format compatible with TinyDB for browser automation. It accepts a JSON payload with a `cookies` field containing the cookie string. The response is a JSON object representing the cookies, including details like name, value, domain, and expiration.

```bash
curl -X POST http://localhost:3000/api/convert \
  -H "Content-Type: application/json" \
  -d '{ "cookies": "SESSDATA=cb06b5c2%2C1641234567%2Cb1a2c*31; bili_jct=abc123def456; DedeUserID=123456789" }'

# Response:
# {
#   "_default": {
#     "1": {
#       "key": "cookie",
#       "value": [
#         {
#           "name": "SESSDATA",
#           "value": "cb06b5c2%2C1641234567%2Cb1a2c*31",
#           "domain": ".bilibili.com",
#           "path": "/",
#           "expires": 1672567890.123,
#           "httpOnly": true,
#           "secure": true,
#           "sameSite": "Lax"
#         },
#         {
#           "name": "bili_jct",
#           "value": "abc123def456",
#           "domain": ".bilibili.com",
#           "path": "/",
#           "expires": 1672567890.123,
#           "httpOnly": false,
#           "secure": false,
#           "sameSite": "Lax"
#         },
#         {
#           "name": "DedeUserID",
#           "value": "123456789",
#           "domain": ".bilibili.com",
#           "path": "/",
#           "expires": 1672567890.123,
#           "httpOnly": false,
#           "secure": false,
#           "sameSite": "Lax"
#         }
#       ]
#     }
#   }
# }
```

--------------------------------

### JavaScript: Detect User Language for Bilibili QR Login Tool

Source: https://github.com/wittf/bilibili-qr-login/blob/main/dev/index.html

This function detects the user's preferred language for the Bilibili QR Login Tool. It checks URL parameters, local storage, and browser language settings, supporting Chinese (Simplified and Traditional), English, and Japanese. It prioritizes specific language codes and falls back to a default.

```javascript
function detectLanguage() {
    const urlParams = new URLSearchParams(window.location.search);
    const langParam = urlParams.get('lang');
    if (langParam) {
        // 标准化语言代码
        const lang = langParam.toLowerCase();
        if (lang === 'zh-cn' || lang === 'cn') return 'zh-CN';
        if (lang === 'zh-tw') return 'zh-TW';
        if (lang === 'en') return 'en';
        if (lang === 'ja' || lang === 'jp') return 'jp';
    }
    const savedLang = localStorage.getItem('bilibili-qr-lang');
    if (savedLang && ['zh-CN', 'zh-TW', 'en', 'jp'].includes(savedLang)) {
        return savedLang;
    }
    const browserLangs = navigator.languages || [navigator.language];
    for (const browserLang of browserLangs) {
        const lang = browserLang.toLowerCase();
        if (lang === 'zh-cn' || lang === 'zh_cn' || lang === 'cn' || lang.startsWith('zh-cn')) return 'zh-CN';
        if (lang === 'zh-tw' || lang === 'zh_tw' || lang.startsWith('zh-tw') || lang.startsWith('zh-hk') || lang.startsWith('zh-mo')) return 'zh-TW';
        if (lang === 'en' || lang.startsWith('en')) return 'en';
        if (lang === 'ja' || lang === 'jp' || lang.startsWith('ja') || lang.startsWith('jp')) return 'jp';
        if (lang.startsWith('zh')) return 'zh-CN';
    }
    return 'zh-CN';
}
```
Tokens:
Raw