B站用户数据查询程序

项目简介

一个用于查询B站用户数据的Python程序，通过B站API获取用户信息、关注/粉丝数量、播放量和点赞数等数据，并支持下载用户头像、头像框和勋章图片，同时生成可视化信息卡片。github地址：https://github.com/PrliStrxs/BiliUserQuery

功能特性

查询用户基本信息（ID、昵称、性别、签名、等级、会员信息等）
获取关注数和粉丝数，获取播放量和点赞数
下载用户头像、头像框和勋章图片
数据以JSON格式保存到本地
网络请求失败自动重试机制，支持批量查询多个用户，提供Web API接口，支持HTTP请求查询
生成用户信息可视化卡片图片
自动管理查询历史记录，保留最新3个用户的查询结果
支持命令行交互和Web API两种使用方式
自动化数据文件管理，历史数据自动清理

前置要求

Python 3.6+
requests库
Pillow库
Flask库

安装依赖

pip install requests pillow flask

代码示例 - static/data/code/relation_stat.py

⬇️ 下载

import requests
import time

def get_relation_stat(mid, headers):
    """
    获取用户的关注和粉丝数量
    API: https://api.bilibili.com/x/relation/stat?vmid={mid}
    """
    url = f"https://api.bilibili.com/x/relation/stat"
    params = {
        'vmid': mid
    }
    
    try:
        response = requests.get(url, params=params, headers=headers, timeout=10)
        response.raise_for_status()
        data = response.json()
        
        if data.get('code') == 0:
            return data
        else:
            error_msg = data.get('message', '未知错误')
            print(f"API返回错误: {error_msg}")
            return None
            
    except requests.exceptions.RequestException as e:
        print(f"网络请求失败: {e}")
        return None
    except Exception as e:
        print(f"处理数据时出错: {e}")
        return None

def extract_relation_stat(relation_data):
    """
    从关系数据中提取指定信息
    """
    if not relation_data or 'data' not in relation_data:
        return None
    
    data = relation_data['data']
    
    # 提取指定的字段
    extracted_info = {
        'following': data.get('following'),  # 关注数量
        'follower': data.get('follower')     # 粉丝数量
    }
    
    return extracted_info

def get_relation_stat_with_retry(mid, headers, max_retries=3, delay=3):

    """

    带重试功能的关注粉丝数量查询，返回提取后的数据

    """

    for attempt in range(max_retries):

        result = get_relation_stat(mid, headers)

        if result:

            # 提取指定数据

            extracted_data = extract_relation_stat(result)

            if extracted_data:

                return extracted_data

        

        # 如果不是最后一次尝试，则等待后重试

        if attempt < max_retries - 1:

            print(f"等待 {delay} 秒后重试... ({attempt + 1}/{max_retries})")

            time.sleep(delay)

        else:

            print(f"经过 {max_retries} 次尝试后仍失败，放弃查询")

    

    return None

代码示例 - static/data/code/upstat.py

⬇️ 下载

import requests
import time

def get_upstat(mid, headers):
    """
    获取用户的播放量和点赞数量
    API: https://api.bilibili.com/x/space/upstat?mid={mid}
    """
    url = f"https://api.bilibili.com/x/space/upstat"
    params = {
        'mid': mid
    }
    
    try:
        response = requests.get(url, params=params, headers=headers, timeout=10)
        response.raise_for_status()
        data = response.json()
        
        if data.get('code') == 0:
            return data
        else:
            error_msg = data.get('message', '未知错误')
            print(f"API返回错误: {error_msg}")
            return None
            
    except requests.exceptions.RequestException as e:
        print(f"网络请求失败: {e}")
        return None
    except Exception as e:
        print(f"处理数据时出错: {e}")
        return None

def extract_upstat(upstat_data):
    """
    从播放点赞数据中提取指定信息
    """
    if not upstat_data or 'data' not in upstat_data:
        return None
    
    data = upstat_data['data']
    
    # 提取指定的字段
    extracted_info = {
        'view': data.get('archive', {}).get('view', 0),  # 播放量
        'likes': data.get('likes', 0)  # 点赞总数
    }
    
    return extracted_info

def get_upstat_with_retry(mid, headers, max_retries=3, delay=3):

    """

    带重试功能的播放点赞数量查询，返回提取后的数据

    """

    for attempt in range(max_retries):

        result = get_upstat(mid, headers)

        if result:

            # 提取指定数据

            extracted_data = extract_upstat(result)

            if extracted_data:

                return extracted_data

        

        # 如果不是最后一次尝试，则等待后重试

        if attempt < max_retries - 1:

            print(f"等待 {delay} 秒后重试... ({attempt + 1}/{max_retries})")

            time.sleep(delay)

        else:

            print(f"经过 {max_retries} 次尝试后仍失败，放弃查询")

    

    return None

代码示例 - static/data/code/user_info.py

⬇️ 下载

import requests
import time
import os

def get_user_info(mid, headers):
    """
    获取用户基本信息
    API: https://api.bilibili.com/x/space/acc/info?mid={mid}
    """
    url = f"https://api.bilibili.com/x/space/acc/info"
    params = {
        'mid': mid
    }
    
    try:
        response = requests.get(url, params=params, headers=headers, timeout=10)
        response.raise_for_status()
        data = response.json()
        
        # 检查API返回状态
        if data.get('code') == 0:
            return data
        else:
            error_msg = data.get('message', '未知错误')
            print(f"API返回错误: {error_msg}")
            return None
            
    except requests.exceptions.RequestException as e:
        print(f"网络请求失败: {e}")
        return None
    except Exception as e:
        print(f"处理数据时出错: {e}")
        return None

def download_image(url, filepath, headers):
    """
    下载图片到指定路径
    """
    try:
        if not url:
            print(f"图片URL为空，跳过下载")
            return False
            
        response = requests.get(url, headers=headers, timeout=10)
        response.raise_for_status()
        
        # 确保目录存在
        os.makedirs(os.path.dirname(filepath), exist_ok=True)
        
        with open(filepath, 'wb') as f:
            f.write(response.content)
        
        print(f"图片已下载: {filepath}")
        return True
        
    except Exception as e:
        print(f"下载图片失败 {url}: {e}")
        return False

def extract_user_info(user_data):
    """
    从用户数据中提取指定信息（不包含图片URL）
    """
    if not user_data or 'data' not in user_data:
        return None
    
    data = user_data['data']
    
    # 提取指定的字段（不包含图片URL）
    extracted_info = {
        'mid': data.get('mid'),  # 用户ID
        'name': data.get('name'),  # 用户名
        'sex': data.get('sex'),  # 性别
        'sign': data.get('sign'),  # 签名
        'level': data.get('level'),  # 等级
        'vip_text': data.get('vip', {}).get('label', {}).get('text', ''),  # 会员信息
        'official_title': data.get('official', {}).get('title', ''),  # 标识
        'attestation_title': data.get('attestation', {}).get('common_info', {}).get('prefix_title', ''),  # 认证信息
        'nameplate_name': data.get('nameplate', {}).get('name', ''),  # 勋章名字
        'pendant_name': data.get('pendant', {}).get('name', '')  # 头像框
    }
    
    return extracted_info

def download_user_images(mid, user_data, headers):
    """
    下载用户头像、头像框和勋章图片
    """
    if not user_data or 'data' not in user_data:
        return
    
    data = user_data['data']
    
    # 下载头像
    face_url = data.get('face')
    if face_url:
        # 从URL中提取文件扩展名
        file_extension = '.jpg'  # 默认使用jpg
        if '.' in face_url:
            ext = face_url.split('.')[-1].split('?')[0]
            if ext in ['jpg', 'jpeg', 'png', 'gif', 'webp']:
                file_extension = f'.{ext}'
        
        face_path = f"img/{mid}_face{file_extension}"
        download_image(face_url, face_path, headers)
    
    # 下载头像框
    pendant_image_url = data.get('pendant', {}).get('image')
    if pendant_image_url:
        # 从URL中提取文件扩展名
        file_extension = '.png'  # 默认使用png
        if '.' in pendant_image_url:
            ext = pendant_image_url.split('.')[-1].split('?')[0]
            if ext in ['jpg', 'jpeg', 'png', 'gif', 'webp']:
                file_extension = f'.{ext}'
        
        pendant_path = f"img/{mid}_pendant{file_extension}"
        download_image(pendant_image_url, pendant_path, headers)
    
    # 下载勋章
    nameplate_image_url = data.get('nameplate', {}).get('image')
    if nameplate_image_url:
        # 从URL中提取文件扩展名
        file_extension = '.png'  # 默认使用png
        if '.' in nameplate_image_url:
            ext = nameplate_image_url.split('.')[-1].split('?')[0]
            if ext in ['jpg', 'jpeg', 'png', 'gif', 'webp']:
                file_extension = f'.{ext}'
        
        nameplate_path = f"img/{mid}_nameplate{file_extension}"
        download_image(nameplate_image_url, nameplate_path, headers)

def get_user_info_with_retry(mid, headers, max_retries=3, delay=3):
    """
    带重试功能的用户信息查询，返回提取后的数据
    """
    for attempt in range(max_retries):
        result = get_user_info(mid, headers)
        if result:
            # 下载用户图片
            download_user_images(mid, result, headers)
            
            # 提取指定数据（不包含图片URL）
            extracted_data = extract_user_info(result)
            if extracted_data:
                return extracted_data
        
        # 如果不是最后一次尝试，则等待后重试
        if attempt < max_retries - 1:
            print(f"等待 {delay} 秒后重试... ({attempt + 1}/{max_retries})")
            time.sleep(delay)
        else:
            print(f"经过 {max_retries} 次尝试后仍失败，放弃查询")
    
    return None

运行项目

python app.py

说明

请勿用于商业用途，遵守B站的隐私政策和使用条款。

项目结构

贡献指南

欢迎提交bug进github。

联系方式

如有问题，请联系：prlistrxs@gmail.com

B站用户数据查询程序

技术栈

📖 README.md

项目简介

功能特性

前置要求

说明

项目结构

贡献指南

联系方式

B站用户数据查询程序

技术栈

📖 README.md

项目简介

功能特性

前置要求

说明

项目结构

贡献指南

联系方式

分享项目