Skip to content

Commit

Permalink
Update docs, add funding and new the fingerprint report template
Browse files Browse the repository at this point in the history
  • Loading branch information
lexiforest committed Nov 30, 2024
1 parent 132b8b3 commit 1d8315c
Show file tree
Hide file tree
Showing 7 changed files with 42 additions and 4 deletions.
33 changes: 33 additions & 0 deletions .github/ISSUE_TEMPLATE/fingerprint_report.md
Original file line number Diff line number Diff line change
@@ -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.
1 change: 1 addition & 0 deletions FUNDING.yml
Original file line number Diff line number Diff line change
@@ -1 +1,2 @@
github: lexiforest
buy_me_a_coffee: yifei
3 changes: 1 addition & 2 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/changelog.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
1 change: 0 additions & 1 deletion docs/faq.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://scrapfly.io/?utm_source=github&utm_medium=sponsoring&utm_campaign=curl_cffi>`_, Cloud-based scraping platform.
- `Yescaptcha <https://yescaptcha.com/i/stfnIO>`_, captcha resolver and proxy service for bypassing Cloudflare.
- `ScrapeNinja <https://scrapeninja.net/?utm_source=github&utm_medium=banner&utm_campaign=cffi>`_, Managed web scraping API.

Expand Down
4 changes: 4 additions & 0 deletions docs/impersonate.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,19 +25,23 @@ 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
- safari15_3 :sup:`2`
- 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 <https://github.com/lwthiker/curl-impersonate/issues/215>`_.
3. Added in version `0.7.0`.
4. Added in version `0.8.0`.

Which version to use?
---------------------
Expand Down
2 changes: 2 additions & 0 deletions docs/install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.

0 comments on commit 1d8315c

Please sign in to comment.