F2 是一个 Python 库，提供多平台的作品下载与接口数据处理。支持抖音、TikTok、Twitter、Instagram等平台，且方便适配更多平台。
当升级到F2的0.0.1.5版本时，请注意以下关键更新。
0.0.1.5的XBogus参数支持了自定义UA，请注意UA规范。- 重建的数据库包含接口的原始数据，所以你需要删除旧的数据库文件。如果你想保留记录请注意迁移。
- 所有的
fetch方法返回的类型已统一为过滤器类型，所以你需要注意这个变化。 - 过滤器添加了
_to_raw方法，可以将过滤器转换为原始接口数据。 - 文件名模板已经更新，如果你的文件名不符合规范，将会抛出异常。
douyin合集页链接无法解析的查看抖音合集作品。- 更多变化查看ChangeLog。
F2的目标是提供一个简单易用的接口，让用户可以快速获取作品数据。
在preview版本中很多功能没有完善，如果你发现了问题，请在F2项目中提交issue。项目文档还在完善中，存在滞后的情况，请保持关注。
- 将在
0.0.1.6版本中添加对weibo，x的支持。 - 将在
0.0.1.6版本中添加更多douyin，tiktok的接口。 - 将在
0.0.1.6版本中修复旧版本已知的问题。
功能状态：🟢代表已经实现，🟡代表正在实现，🟤代表暂时不实现，🔵代表未来实现，🔴代表将会弃用。 账号状态：⚪代表未知，🟣代表需要登录（无视自己账号隐私设置），⚫代表不需要登录（游客状态能看到的）。
🎶 DouYin
- 🟣 表示需要登录才可以下载仅自己可见的作品、收藏作品、收藏夹作品或点赞作品等。（登录后无视自己的私密设置、可获取个性化内容）
- ⚫ 表示不需要登录下载公开的作品、收藏夹作品、点赞作品等。（仅下载他人公开可见作品与页面）
| 功能 | 账号状态 | 接口 | 功能状态 |
|---|---|---|---|
| 用户信息 | 🟣⚫ | handler_user_profile |
🟢 |
| 单个作品（视频、图集、日常） | 🟣⚫ | fetch_one_video |
🟢 |
| 主页作品 | 🟣⚫ | fetch_user_post_videos |
🟢 |
| 点赞作品 | 🟣⚫ | fetch_user_like_videos |
🟢 |
| 收藏夹作品 | 🟣⚫ | fetch_user_collects_videos |
🟢 |
| 收藏作品 | 🟣 | fetch_user_collection_videos |
🟢 |
| 收藏原声 | 🟣 | fetch_user_music_collection |
🟢 |
| 收藏合集 | 🟣 | fetch_user_mix_collection |
🔵 |
| 收藏短剧 | 🟣 | fetch_user_series_collection |
🟤 |
| 合集作品 | ⚫ | fetch_user_mix_videos |
🟢 |
| 首页推荐作品 | 🟣⚫ | fetch_user_feed_videos |
🟡 |
| 相似推荐作品 | ⚫ | fetch_related_videos |
🔵 |
| 直播间信息（流下载） | ⚫ | fetch_user_live_videos、fetch_user_live_videos_by_room_id |
🟢 |
| 直播间弹幕 | ⚫ | fetch_user_live_danmu |
🔵 |
| 关注用户开播 | 🟣⚫ | fetch_user_following_lives |
🔵 |
| 关注用户信息 | 🟣⚫ | fetch_user_following |
🟢 |
| 粉丝用户信息 | 🟣⚫ | fetch_user_follower |
🟢 |
| 关注用户作品 | 🟣⚫ | fetch_user_following_videos |
🟤 |
| 粉丝用户作品 | 🟣⚫ | fetch_user_follower_videos |
🟤 |
| 朋友作品 | 🟣 | fetch_user_friend_videos |
🔵 |
| 搜索视频 | ⚫ | fetch_search_videos |
🔵 |
| 搜索用户 | ⚫ | fetch_search_users |
🔵 |
| 搜索直播 | ⚫ | fetch_search_lives |
🔵 |
| 猜你想搜（相关搜索） | ⚫ | fetch_search_suggest |
🟤 |
| 抖音热点 | ⚫ | fetch_hot_search |
🟤 |
| 作品评论 | 🟣⚫ | fetch_video_comments |
🔵 |
| 观看历史 | 🟣 | fetch_user_history_read |
🟤 |
| 稍后再看 | 🟣 | fetch_user_watch_later |
🟤 |
| ... | ... | ... | ... |
🎶 TikTok
- 🟣 表示需要登录才可以下载仅自己可见的作品、收藏作品、收藏夹作品或点赞作品等。（登录后无视自己的私密设置、可获取个性化内容）
- ⚫ 表示不需要登录下载公开的作品、收藏夹作品、点赞作品等。（仅下载他人公开可见作品与页面）
| 功能 | 账号状态 | 接口 | 功能状态 |
|---|---|---|---|
| 用户信息 | 🟣⚫ | handler_user_profile |
🟢 |
| 单个作品 | 🟣⚫ | fetch_one_video |
🟢 |
| 主页作品 | 🟣⚫ | fetch_user_post_videos |
🟢 |
| 点赞作品 | 🟣⚫ | fetch_user_like_videos |
🟢 |
| 收藏作品 | 🟣⚫ | fetch_user_collect_videos |
🟢 |
| 播放列表作品 | 🟣⚫ | fetch_user_mix_videos |
🟢 |
| ... | ... | ... | ... |
🎬 DouYin
支持合集里任意作品链接解析
合集链接解析
ps. 0.0.1.5 relase版本需要拉取这2个提交补丁来修复 4b81457 eb763eb ps. 从main分支安装的不需要更新
📁 项目目录
.
├── .github
│ ├── ISSUE_TEMPLATE
│ │ ├── ask-question.md
│ │ ├── bug-report.md
│ │ └── feature_request.md
│ └── workflows
│ └── Codecov.yml
│ └── deploy.yml
├── .gitignore
├── .vscode
│ └── settings.json
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── CONTRIBUTORS.md
├── LICENSE
├── README.en.md
├── README.md
├── SECURITY.md
├── docs
│ ├── .vitepress
│ │ ├── config.mts
│ │ └── theme
│ │ ├── index.ts
│ │ └── styles
│ │ └── vars.css
│ ├── advance-guide.md
│ ├── cli.md
│ ├── en
│ │ ├── advance-guide.md
│ │ ├── api-examples.md
│ │ ├── cli.md
│ │ ├── guide
│ │ │ └── what-is-f2.md
│ │ ├── index.md
│ │ ├── install.md
│ │ ├── markdown-examples.md
│ │ ├── quick-start.md
│ │ └── site-config.md
│ ├── guide
│ │ ├── api-examples.md
│ │ ├── apps
│ │ │ ├── douyin
│ │ │ │ └── index.md
│ │ │ └── tiktok
│ │ │ └── index.md
│ │ └── what-is-f2.md
│ ├── index.md
│ ├── install.md
│ ├── package-lock.json
│ ├── package.json
│ ├── public
│ │ ├── douyin
│ │ │ ├── cli-start-2.png
│ │ │ ├── cli-start.png
│ │ │ ├── code-start-2.png
│ │ │ ├── code-start.png
│ │ │ ├── log-2-console.png
│ │ │ ├── pytest-ok.png
│ │ │ └── set-debug.png
│ │ ├── f2-help.png
│ │ ├── f2-logo-with-no-shadow.png
│ │ ├── f2-logo-with-shadow-mini.png
│ │ ├── [email protected]
│ │ ├── [email protected]
│ │ ├── [email protected]
│ │ ├── [email protected]
│ │ ├── [email protected]
│ │ ├── [email protected]
│ │ ├── f2-logo-with-shadow.png
│ │ └── f2-logo.ico
│ ├── question-answer
│ │ └── qa.md
│ ├── quick-start.md
│ ├── reference
│ │ └── runtime-api.md
│ ├── site-config.md
│ ├── snippets
│ │ ├── QA.md
│ │ ├── douyin
│ │ │ ├── aweme-id.py
│ │ │ ├── format-file-name.py
│ │ │ ├── mstoken-false.py
│ │ │ ├── mstoken-real.py
│ │ │ ├── one-video.py
│ │ │ ├── s_v_web_id.py
│ │ │ ├── sec-user-id.py
│ │ │ ├── show-qrcode.py
│ │ │ ├── sso-login.py
│ │ │ ├── support-link.md
│ │ │ ├── ttwid.py
│ │ │ ├── user-collection.py
│ │ │ ├── user-collects.py
│ │ │ ├── user-folder.py
│ │ │ ├── user-follower.py
│ │ │ ├── user-following.py
│ │ │ ├── user-get-add.py
│ │ │ ├── user-like.py
│ │ │ ├── user-live-room-id.py
│ │ │ ├── user-live.py
│ │ │ ├── user-mix.py
│ │ │ ├── user-nickname.py
│ │ │ ├── user-post.py
│ │ │ ├── user-profile.py
│ │ │ ├── verify_fp.py
│ │ │ ├── video-get-add.py
│ │ │ ├── webcast-id.py
│ │ │ └── xbogus.py
│ │ ├── set-debug.py
│ │ ├── tiktok
│ │ │ ├── aweme-id.py
│ │ │ ├── format-file-name.py
│ │ │ ├── one-video.py
│ │ │ ├── sec-uid.py
│ │ │ ├── support-link.md
│ │ │ ├── token-manager.py
│ │ │ ├── unique-id.py
│ │ │ ├── user-collect.py
│ │ │ ├── user-folder.py
│ │ │ ├── user-get-add.py
│ │ │ ├── user-like.py
│ │ │ ├── user-mix.py
│ │ │ ├── user-nickname.py
│ │ │ ├── user-playlist.py
│ │ │ ├── user-post.py
│ │ │ ├── user-profile.py
│ │ │ ├── video-get-add.py
│ │ │ └── xbogus.py
│ │ └── user-profile.py
├── f2
│ ├── __init__.py
│ ├── __main__.py
│ ├── apps
│ │ ├── __apps__.py
│ │ ├── __init__.py
│ │ ├── douyin
│ │ │ ├── api.py
│ │ │ ├── cli.py
│ │ │ ├── crawler.py
│ │ │ ├── db.py
│ │ │ ├── dl.py
│ │ │ ├── filter.py
│ │ │ ├── handler.py
│ │ │ ├── help.py
│ │ │ ├── model.py
│ │ │ ├── test
│ │ │ │ ├── test_apps_model.py
│ │ │ │ ├── test_aweme_id.py
│ │ │ │ ├── test_crawler.py
│ │ │ │ ├── test_handler.py
│ │ │ │ ├── test_lrc.py
│ │ │ │ ├── test_room_id.py
│ │ │ │ ├── test_sec_user_id.py
│ │ │ │ └── test_webcast_id.py
│ │ │ └── utils.py
│ │ ├── tiktok
│ │ │ ├── api.py
│ │ │ ├── cli.py
│ │ │ ├── crawler.py
│ │ │ ├── db.py
│ │ │ ├── dl.py
│ │ │ ├── filter.py
│ │ │ ├── handler.py
│ │ │ ├── help.py
│ │ │ ├── model.py
│ │ │ └── utils.py
│ │ ├── twitter
│ │ │ ├── api.py
│ │ │ ├── cli.py
│ │ │ ├── crawler.py
│ │ │ ├── db.py
│ │ │ ├── dl.py
│ │ │ ├── filter.py
│ │ │ ├── handler.py
│ │ │ ├── help.py
│ │ │ ├── model.py
│ │ │ └── utils.py
│ ├── cli
│ │ ├── __init__.py
│ │ ├── cli_commands.py
│ │ └── cli_console.py
│ ├── conf
│ │ ├── app.yaml
│ │ ├── conf.yaml
│ │ ├── defaults.yaml
│ │ └── test.yaml
│ ├── crawlers
│ │ └── base_crawler.py
│ ├── db
│ │ └── base_db.py
│ ├── dl
│ │ └── base_downloader.py
│ ├── exceptions
│ │ ├── __init__.py
│ │ ├── api_exceptions.py
│ │ ├── db_exceptions.py
│ │ └── file_exceptions.py
│ ├── helps.py
│ ├── i18n
│ │ └── translator.py
│ ├── languages
│ │ ├── en_US
│ │ │ └── LC_MESSAGES
│ │ │ └── en_US.mo
│ │ └── zh_CN
│ │ └── LC_MESSAGES
│ │ └── zh_CN.mo
│ ├── log
│ │ └── logger.py
│ └── utils
│ ├── __init__.py
│ ├── _dl.py
│ ├── _signal.py
│ ├── _singleton.py
│ ├── conf_manager.py
│ ├── json_filter.py
│ ├── mode_handler.py
│ ├── utils.py
│ └── xbogus.py
│ ├── app.yaml
│ ├── conf.yaml
│ └── defaults.yaml
├── package-lock.json
├── package.json
├── pyproject.toml
├── tests
│ ├── test_cli_console.py
│ ├── test_desc_limit.py
│ ├── test_dl.py
│ ├── test_excetions.py
│ ├── test_i18n.py
│ ├── test_logger.py
│ ├── test_signal.py
│ ├── test_singleton.py
│ ├── test_utils.py
│ └── test_xbogus.py
如果你有兴趣为F2做拓展新应用，请查看贡献指南。
- Windows Terminal
- Python
- click
- rich
- httpx
- aiofiles
- aiosqlite
- jsonpath-ng
- m3u8
- pyyaml
- pytest
- browser_cookie3
- pydantic
- qrcode
- vitepress
没有这些库和程序，F2将无法实现这些功能，对于他们的贡献和努力，表示由衷的感谢。
- 请严格遵守爬虫规范，不要使用此项目进行任何违法行为。
- 不出售、共享、加密、上传、研究和传播任何个人信息。
- 项目及其相关代码仅供学习与研究使用，不构成任何明示或暗示的保证。
- 使用者因使用此项目及其代码可能造成的任何形式的损失，使用者应当自行承担一切风险。
- 请遵守Apache-2.0开源协议，不要删除或修改代码中的任何版权信息。
- 使用者不得将此项目及其代码用于任何形式的商业用途和商业行为。
- 如果使用者使用此项目及其代码，即代表使用者同意遵守上述规定。
Copyright (c) 2023 JohnserfSeed
只回答关于F2的问题，可以通过以下方式联系我，请耐心等待，会尽快回复你。
- Mail：[email protected]
- Discord：F2
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent