From 1d8315c83cba63c92364bf63006adf49a22ce9b8 Mon Sep 17 00:00:00 2001 From: Lyonnet Date: Sat, 30 Nov 2024 18:44:13 +0800 Subject: [PATCH] Update docs, add funding and new the fingerprint report template --- .github/ISSUE_TEMPLATE/fingerprint_report.md | 33 ++++++++++++++++++++ FUNDING.yml | 1 + LICENSE | 3 +- docs/changelog.rst | 2 +- docs/faq.rst | 1 - docs/impersonate.rst | 4 +++ docs/install.rst | 2 ++ 7 files changed, 42 insertions(+), 4 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/fingerprint_report.md diff --git a/.github/ISSUE_TEMPLATE/fingerprint_report.md b/.github/ISSUE_TEMPLATE/fingerprint_report.md new file mode 100644 index 0000000..c191733 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/fingerprint_report.md @@ -0,0 +1,33 @@ +--- +name: Fingerprint report +about: Report a new fingerprint not supported by curl_cffi +title: "New Fingerprint: " +labels: "" +--- + +Please make sure you fill out all the sections below, otherwise it will not be checked. + +**Fingerprint** + +Wireshark or similar tools are preferred, if you can not use them in your case, use: https://tls.browserleaks.com/json + +- ja3n(tls fingerprint): +- akamai(http2 fingerprint): +- other bits not covered by above: + +**Platform** + +If you are reporint fingerprints from an app, it's your responsibility to figure out +which http client the app is using. + +- Software: (e.g. Chrome, okhttp...) +- Version: (e.g. 131) +- OS and version: (e.g. Android 14, Windows 11) + +**Additional context** + +Have you checked that there is no custom options or extensions that will alter the TLS hello packet or HTTP/2 settings frame? + +Can the fingerprint be impersonated via `ja3=` and `akamai=` parameters? + +Paste the stack trace if it's not working. diff --git a/FUNDING.yml b/FUNDING.yml index e04a975..f906230 100644 --- a/FUNDING.yml +++ b/FUNDING.yml @@ -1 +1,2 @@ +github: lexiforest buy_me_a_coffee: yifei diff --git a/LICENSE b/LICENSE index c155422..ecd84fa 100644 --- a/LICENSE +++ b/LICENSE @@ -1,7 +1,6 @@ MIT License -Copyright (c) 2018 multippt -Copyright (c) 2022 perker +Copyright (c) 2024 curl_cffi developers Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/docs/changelog.rst b/docs/changelog.rst index 400b042..27e52ae 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -7,7 +7,7 @@ v0.8 ---- - v0.8.0 - - Added more recent impersonate versions, Safari 18.0 for iOS and macOS. + - Added more recent impersonate versions, Safari 18.0 for iOS and macOS, Chrome 131. - Added ``quote`` parameter for setting which letter should be quoted in URL. - Added ``response_class`` parameter for using a customized ``Response`` class. diff --git a/docs/faq.rst b/docs/faq.rst index 5ca3518..b0d76a9 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -37,7 +37,6 @@ a better proxy IP provider and use browser automation tools like playwright. If you are in a hurry or just want the professionals to take care of the hard parts, you can consider the commercial solutions from our sponsors: -- `Scrapfly `_, Cloud-based scraping platform. - `Yescaptcha `_, captcha resolver and proxy service for bypassing Cloudflare. - `ScrapeNinja `_, Managed web scraping API. diff --git a/docs/impersonate.rst b/docs/impersonate.rst index 1399567..90ac9b5 100644 --- a/docs/impersonate.rst +++ b/docs/impersonate.rst @@ -25,6 +25,7 @@ to specify your own customized fingerprints. See below for details. - chrome120 :sup:`1` - chrome123 :sup:`3` - chrome124 :sup:`3` +- chrome131 :sup:`4` - chrome99_android - edge99 - edge101 @@ -32,12 +33,15 @@ to specify your own customized fingerprints. See below for details. - safari15_5 :sup:`2` - safari17_0 :sup:`1` - safari17_2_ios :sup:`1` +- safari18_0 :sup:`4` +- safari18_0_ios :sup:`4` Notes: 1. Added in version `0.6.0`. 2. Fixed in version `0.6.0`, previous http2 fingerprints were `not correct `_. 3. Added in version `0.7.0`. +4. Added in version `0.8.0`. Which version to use? --------------------- diff --git a/docs/install.rst b/docs/install.rst index 08aaeff..95554fa 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -44,3 +44,5 @@ To install the latest unstable version from GitHub: cd curl_cffi make preprocess pip install . + +Or you can download the wheels from github actions artifacts.