{"id":31836222,"url":"https://github.com/z-mio/parse_hub_bot","last_synced_at":"2026-05-23T10:09:47.974Z","repository":{"id":262426839,"uuid":"862401468","full_name":"z-mio/parse_hub_bot","owner":"z-mio","description":"Telegram 多平台聚合解析机器人","archived":false,"fork":false,"pushed_at":"2026-03-26T16:49:04.000Z","size":1272,"stargazers_count":328,"open_issues_count":0,"forks_count":27,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-27T06:52:55.672Z","etag":null,"topics":["bot","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/ParseHubot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/z-mio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-09-24T14:36:19.000Z","updated_at":"2026-03-27T03:52:54.000Z","dependencies_parsed_at":"2025-02-12T06:33:26.358Z","dependency_job_id":"3e1a5c2b-c58f-444b-a561-051a5ed5f2b6","html_url":"https://github.com/z-mio/parse_hub_bot","commit_stats":null,"previous_names":["z-mio/parse_hub_bot"],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/z-mio/parse_hub_bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z-mio%2Fparse_hub_bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z-mio%2Fparse_hub_bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z-mio%2Fparse_hub_bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z-mio%2Fparse_hub_bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/z-mio","download_url":"https://codeload.github.com/z-mio/parse_hub_bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z-mio%2Fparse_hub_bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32889981,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"online","status_checked_at":"2026-05-11T02:00:05.975Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","telegram-bot"],"created_at":"2025-10-12T01:28:05.386Z","updated_at":"2026-05-23T10:09:47.962Z","avatar_url":"https://github.com/z-mio.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🔗 ParseHubBot\n\n**Telegram 多平台聚合解析机器人**\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/z-mio/Parse_Hub_Bot/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/z-mio/Parse_Hub_Bot?style=flat-square\u0026color=5D6D7E\" alt=\"License\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.python.org/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Python-3.12+-blue?style=flat-square\u0026logo=python\u0026logoColor=white\" alt=\"Python\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://t.me/ParseHubot\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Telegram-Bot-2CA5E0?style=flat-square\u0026logo=telegram\u0026logoColor=white\" alt=\"Telegram Bot\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/astral-sh/uv\"\u003e\n    \u003cimg src=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json\u0026style=flat-square\" alt=\"uv\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n[**🤖 实例演示**](https://t.me/ParseHubot) ·\n[**📚 相关项目**](https://github.com/z-mio/ParseHub) ·\n[**🐛 问题反馈**](https://github.com/z-mio/Parse_Hub_Bot/issues)\n\n\u003c/div\u003e\n\n---\n\n\u003e 官方实例：[@ParseHubot](https://t.me/ParseHubot)\n\n## ✨ 功能特性\n\n- 🎬 **多平台解析** — 抖音、B站、YouTube、小红书、Twitter 等 16+ 主流平台一站搞定\n- ⚡ **内联模式** — 在任意聊天窗口输入 `@BotUsername \u003c链接\u003e` 即可解析\n- 🖼️ **Tg 兼容** — 自动转码、长图切割、大视频分段\n- 📦 **多种模式** — 在线预览, 原始文件, 打包下载\n- 🐳 **Docker 部署** — 开箱即用\n\n## 📦 支持平台一览\n\n| 平台              | 视频 | 图文 |  其他   |\n|:----------------|:--:|:--:|:-----:|\n| **Twitter / X** | ✅  | ✅  | 📝 文章 |\n| **Instagram**   | ✅  | ✅  |       |\n| **YouTube**     | ✅  |    | 🎵 音乐 |\n| **Facebook**    | ✅  |    |       |\n| **Threads**     | ✅  | ✅  |       |\n| **Bilibili**    | ✅  |    | 📝 动态 |\n| **抖音**          | ✅  | ✅  |       |\n| **TikTok**      | ✅  | ✅  |       |\n| **微博**          | ✅  | ✅  |       |\n| **小红书**         | ✅  | ✅  |       |\n| **贴吧**          | ✅  | ✅  |       |\n| **微信公众号**       |    | ✅  |       |\n| **快手**          | ✅  |    |       |\n| **酷安**          | ✅  | ✅  |       |\n| **皮皮虾**         | ✅  | ✅  |       |\n| **最右**          | ✅  | ✅  |       |\n| **小黑盒**         | ✅  | ✅  |       |\n\n\u003e 🔧 更多平台持续接入中...\n\n## 🚀 快速开始\n\n### 🐳 Docker 运行 (推荐)\n\n```bash\nmkdir parse_hub_bot \u0026\u0026 cd parse_hub_bot\n\ndocker run -d \\\n  --restart=always \\\n  -e API_ID=你的API_ID \\\n  -e API_HASH=你的API_HASH \\\n  -e BOT_TOKEN=你的BOT_TOKEN \\\n  -v ./logs:/app/logs \\\n  -v ./data:/app/data \\\n  --name parse-hub-bot \\\n  ghcr.io/z-mio/parse_hub_bot:latest\n```\n\n### 💻 源码运行\n\n```bash\nuv sync\nuv run bot.py\n```\n\n---\n\n## ⚙️ 配置说明\n\n- **环境变量:** 基础配置\n- **平台配置 (可选):** 平台代理和 Cookie\n\n### 📝 环境变量\n\n```dotenv\n# ✅ 必填\nAPI_ID=        # Telegram API ID，登录 https://my.telegram.org 获取\nAPI_HASH=      # Telegram API Hash，同上获取\nBOT_TOKEN=     # 机器人 Token，向 @BotFather 申请\n\n# 🔲 可选\nBOT_PROXY=     # Bot 连接 TG 使用的代理，例：http://127.0.0.1:7890\n```\n\n### 🌐 平台配置\n\n用于为各解析平台单独配置**代理**和 **Cookie**，位于 `data/config/platform_config.yaml`\n\n```yaml\n# ═══════════════════════ 全局默认代理 ═══════════════════════\n# 当某平台未单独配置代理时，会使用全局默认代理\n# 支持填写单个地址(字符串)或多个地址(列表，随机选取)\n\ndefault_parser_proxies: http://127.0.0.1:7890        # 解析代理（单个）\ndefault_downloader_proxies: # 下载代理（代理池）\n  - http://127.0.0.1:7890\n  - http://127.0.0.1:7891\n\n# ═══════════════════════ 平台独立配置 ═══════════════════════\nplatforms:\n  \u003cplatform_id\u003e: # 平台 ID，见下方支持列表\n    disable_parser_proxy: false          # 是否禁用解析代理（直连）\n    disable_downloader_proxy: false      # 是否禁用下载代理（直连）\n    parser_proxies: # 该平台专用解析代理池\n      - http://proxy1:port\n    downloader_proxies: # 该平台专用下载代理池\n      - http://proxy2:port\n    cookies: # 该平台 Cookie 列表（随机选取）\n      - \"cookie_string_1\"\n      - \"cookie_string_2\"\n```\n\n### 🔀 代理优先级\n\n解析代理和下载代理各自遵循相同的优先级逻辑：\n\n```\n禁用代理 (disable_*_proxy: true)\n  ↓ 未禁用\n平台专用代理 (parser_proxies / downloader_proxies)\n  ↓ 未配置\n全局默认代理 (default_parser_proxies / default_downloader_proxies)\n  ↓ 未配置\n直连（不使用代理）\n```\n\n\u003e 💡 当代理池中有多个地址时，每次请求会**随机选取**一个\n\n### 🔑 支持的平台 ID\n\n`\u003cplatform_id\u003e` 必须是以下合法的平台 ID：\n\n| 平台 ID       | 对应平台        |\n|:------------|:------------|\n| `twitter`   | Twitter / X |\n| `instagram` | Instagram   |\n| `youtube`   | YouTube     |\n| `facebook`  | Facebook    |\n| `threads`   | Threads     |\n| `bilibili`  | 哔哩哔哩        |\n| `douyin`    | 抖音          |\n| `tiktok`    | TikTok      |\n| `weibo`     | 微博          |\n| `xhs`       | 小红书         |\n| `tieba`     | 百度贴吧        |\n| `wechat`    | 微信公众号       |\n| `kuaishou`  | 快手          |\n| `coolapk`   | 酷安          |\n| `pipixia`   | 皮皮虾         |\n| `zuiyou`    | 最右          |\n| `xiaoheihe` | 小黑盒         |\n\n### 🍪 支持 Cookie 的平台\n\n- `Twitter / X`\n- `Instagram`\n- `YouTube`\n- `Bilibili`\n- `抖音`\n- `TikTok`\n- `快手`\n- `小红书`\n\n### 📌 配置示例\n\n##### 示例 1：国内平台直连，海外平台走代理\n\n```yaml\ndefault_parser_proxies: http://127.0.0.1:7890\ndefault_downloader_proxies: http://127.0.0.1:7890\n\nplatforms:\n  bilibili:\n    disable_parser_proxy: true\n    disable_downloader_proxy: true\n  douyin:\n    disable_parser_proxy: true\n    disable_downloader_proxy: true\n  xhs:\n    disable_parser_proxy: true\n    disable_downloader_proxy: true\n```\n\n#### 示例 2：Twitter 配置 Cookie + 使用全局代理\n\n```yaml\ndefault_parser_proxies: http://127.0.0.1:7890\ndefault_downloader_proxies: http://127.0.0.1:7890\n\nplatforms:\n  twitter:\n    cookies:\n      - \"auth_token=your_token_here; ct0=your_ct0_here\"\n```\n\n#### 示例 3：YouTube 使用独立代理池\n\n```yaml\nplatforms:\n  youtube:\n    parser_proxies:\n      - http://proxy-us-1:8080\n      - http://proxy-us-2:8080\n      - http://proxy-eu-1:8080\n    downloader_proxies:\n      - http://proxy-us-1:8080\n      - http://proxy-eu-1:8080\n```\n\n#### 示例 4：B站指定 Cookie 轮换 + 解析直连 + 下载走代理\n\n```yaml\nplatforms:\n  bilibili:\n    disable_parser_proxy: true\n    downloader_proxies:\n      - http://127.0.0.1:7890\n    cookies:\n      - \"SESSDATA=xxx; bili_jct=xxx; buvid3=xxx\"\n      - \"SESSDATA=yyy; bili_jct=yyy; buvid3=yyy\"\n```\n\n## 🌟 Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=z-mio/Parse_Hub_Bot\u0026type=Date)](https://star-history.com/#z-mio/Parse_Hub_Bot\u0026Date)\n\n## 🤝 参与贡献\n\n欢迎提交 Pull Request 或 Issue！\n\n- 核心解析相关请前往 [ParseHub](https://github.com/z-mio/ParseHub)。\n- Bug 反馈请附上相关 URL 和日志信息。\n\n## 📄 开源协议\n\n本项目基于 [MIT License](LICENSE) 协议开源。\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**如果这个项目对你有帮助，欢迎点个 ⭐ Star！**\n\n\u003c/div\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fz-mio%2Fparse_hub_bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fz-mio%2Fparse_hub_bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fz-mio%2Fparse_hub_bot/lists"}