🔗 ParseHub

社交媒体聚合解析器

轻量、异步、开箱即用的社交媒体聚合解析库，支持 16+ 平台 🚀

快速开始 · 支持平台 · 高级用法 · TG Bot

---

✨ 特性

• 🌍 广泛的平台支持 — 覆盖国内外 16+ 主流社交媒体
• 🧹 隐私保护 — 自动清除链接中的跟踪参数, 返回干净的原始链接
• 🎬 多媒体支持 — 视频 / 图文 / 动图 / 实况照片，一网打尽
• 📦 开箱即用 — async/await 原生支持，API 极简
• 🤖 Telegram Bot — 基于本项目的 Bot 已上线 → @ParsehuBot

📦 安装

# pip
pip install parsehub

# uv (推荐)
uv add parsehub

要求 Python ≥ 3.12

🚀 快速开始

import asyncio
from parsehub import ParseHub


async def main():
    ph = ParseHub()
    # parse() 会自动识别链接所属平台，返回对应的解析结果。支持短链、分享文本等多种输入格式。
    result = await ph._do_parse("https://x.com/elonmusk/status/1234567890")

    print(result.title)  # 标题
    print(result.content)  # 正文
    print(result.platform)  # 平台
    print(result.raw_url)  # 清理追踪参数后的原始链接
    print(result.media)  # 媒体信息 (VideoRef / [ImageRef, ...] 等)


asyncio.run(main())

下载媒体

result = await ph._do_parse("https://www.bilibili.com/video/BV1xx411c7mD")

download_result = await result.download()

print(download_result.media)  # 本地文件信息

🌐 支持平台

平台	视频	图文	其他
Twitter / X	✅	✅
Instagram	✅	✅
YouTube	✅		🎵 音乐
Facebook	✅
Threads	✅	✅
Bilibili	✅		📝 动态
抖音 / TikTok	✅	✅
微博	✅	✅
小红书	✅	✅
贴吧	✅	✅
微信公众号		✅
快手	✅
酷安	✅	✅
皮皮虾	✅	✅
最右	✅	✅
小黑盒	✅	✅

🔧 更多平台持续接入中...

🔑 高级用法

Cookie 登录 & 代理

部分平台的内容需要登录才能访问，通过 Cookie 即可解锁：

from parsehub import ParseHub
from parsehub.config import ParseConfig

config = ParseConfig(
    cookie="key1=value1; key2=value2",  # 从浏览器中获取
    proxy="http://127.0.0.1:7890",  # 可选
)
ph = ParseHub(config=config)

Cookie 支持多种格式传入：

# 字符串
ParseConfig(cookie="key1=value1; key2=value2")

# JSON 字符串
ParseConfig(cookie='{"key1": "value1", "key2": "value2"}')

# 字典
ParseConfig(cookie={"key1": "value1", "key2": "value2"})

目前支持 Cookie 登录的平台:

Twitter · Instagram · Kuaishou · Bilibili · YouTube

全局配置

from parsehub.config import GlobalConfig

# 自定义默认下载目录
GlobalConfig.default_save_dir = "./my_downloads"

# 视频时长限制 (超过此时长将下载最低画质，0 为不限制)
GlobalConfig.duration_limit = 600  # 秒

🤝 参考项目

• Evil0ctal/Douyin_TikTok_Download_API
• yt-dlp/yt-dlp
• instaloader/instaloader
• SocialSisterYi/bilibili-API-collect
• Nemo2011/bilibili-api

📜 开源协议

本项目基于 MIT License 开源。

---

如果这个项目对你有帮助，欢迎点个 ⭐ Star！