/ README.md
README.md
1 # facecheck.id-results-extractor 2 3 A script written in JavaScript to extract URLs from FaceCheck.id results for free. This script extracts base64-encoded img.webp data from FaceCheck search results. After the results page is detected the script displays the results on the webpage as clickable links. *(The way the results are displayed is different depending on the version you use.) 4 5 ## Available Scripts 6 7 As of now there is one version of the script usable on desktop and mobile. 8 9 10 1. **facecheck-url-extractor-desktop&mobileV2.user.js**: Optimized for desktop use, this updated version introduces a new, interactive hover-based popup instead of a static results box. 11 12 * -> Sorting may change the order in which the links are displayed. I recommend trying both and finding your preference. 13 14 ## Details on Version 2 15 16 - Interactive Popups: Results appear dynamically when hovering over search images. 17 18 - Group Support: Automatically detects and displays related URLs for grouped images. 19 20 - Confidence Ratings: Visual ratings are displayed clearly: 21 - Green (90%+): Certain Match 22 - Yellow (83-89%): Confident Match 23 - Orange (70-82%): Uncertain Match 24 - Red (50-69%): Weak Match 25 - Grey (<50%): No Match 26 27 - Dynamic Theme Switching: Supports both dark and light themes based on your site's theme setting. 28 29 - Enhanced User Experience: Smooth animations, and responsive interactions. 30 31 - Added in extra mobile functionality 32 33 ## How to Install 34 35 ### For Desktop Browsers 36 37 1. Install Tampermonkey in your browser (available for Chrome, Firefox, and others). 38 2. Click on the Tampermonkey icon in your browser and select "Create a new script". 39 3. Copy the content from the desired script file: 40 - `facecheck-url-extractor-desktop&mobileV2.user.js` 41 4. Paste the copied content into the Tampermonkey editor. 42 5. Save the script. 43 44 ### For Mobile Browsers 45 46 To install on mobile, you need a mobile browser extension that supports running local JavaScript scripts ('Userscripts' app on iOS)('Tampermonkey' on Android). 47 48 1. **Install Userscripts/Tampermonkey**: 49 - On **Android**: Install a compatible browser, for example: **Firefox** or **Kiwi Browser**, from the Google Play Store, then add the Tampermonkey extension from the browser’s add-ons/extensions page. 50 - On **iOS**: Userscripts is available as a standalone app that can run user scripts in any browser. 51 I recommend watching a setup tutorial if you're confused about any of this. 52 53 2. **Add the Script**: 54 - Browse to the GitHub in your browser. 55 - Download the desired script file: 56 - `facecheck-url-extractor-desktop&mobileV2.user.js` 57 - Paste the script into the correct location. (Again, I recommend watching a setup tutorial if you're confused about any of this.) 58 59 ## How to Use 60 61 ### V2 (Mobile): 62 1. Navigate to the results page on FaceCheck.id. 63 2. Enable the script and use the FaceCheck.id search. 64 3. Will show the results on top of the picture below it (see the example) 65 66  67 68 69 70 ### V2(Desktop): 71 1. Navigate to FaceCheck.id and run your search. 72 2. Hover your cursor over individual results. 73 4. A popup will display URLs along with their confidence ratings. 74 5. Click URLs to open in new tabs. 75  76 77 78 ## What is FaceCheck.id? 79 80 FaceCheck.id is an online facial recognition tool that allows users to upload a photo and search the web for similar images or profiles. 81 The platform is often used to identify individuals by cross-referencing facial features with images found across various websites, including social media, blogs, and other public platforms. 82 FaceCheck.id used to be totally free. 83 While the service offers free searches, detailed results, such as links to the sources of the images, are placed behind a paywall. 84 85 ## Why Does This Work? 86 87 FaceCheck.id embeds search result images as a string of a base64-encoded webp file. These images often contain embedded metadata in the form of XMP (Extensible Metadata Platform) data, which is typically included in image files to store information such as copyright details, camera settings, or links related to the image. 88 89 In the case of FaceCheck.id, the XMP metadata often contains URLs to the website it got its images from, like social media profiles or other web pages related to the search result. 90 91 The critical point here is that FaceCheck.id does not strip or remove this XMP metadata before embedding the webp images on their results page. As a result, the metadata, including the URLs, remains intact within the image data, allowing it to be accessed and decoded without needing to pay for the results. 92 93 I have tried finding their contact info to let them know about this, but they didn't leave their info on their website, or pretty much anywhere else. So I thought I'd share this for casual users to use (while it still works). 94 95 ## Disclaimers 96 97 Please note that the results produced by this script may vary depending on the quality of the results provided by FaceCheck.id. 98 While the script successfully extracts URLs, the relevance and accuracy of these URLs are entirely dependent on the search results generated by FaceCheck.id. 99 100 ### Ethical Use 101 102 I do not condone or support the use of FaceCheck.id for doxing, harassment, or any other unethical or illegal activities. This script is intended for educational purposes and responsible use only. Please ensure that any use of the data extracted follows all applicable laws and respects the privacy and rights of individuals. 103 104 ### Legal Disclaimer 105 106 The use of this script to extract URLs from FaceCheck.id may be subject to the Terms of Service of the website. Bypassing paywalls or circumventing access restrictions can potentially violate the terms set by the service provider. It is the user's responsibility to ensure that they comply with all applicable laws, regulations, and terms of service when using this script. 107 108 I do not take responsibility for any misuse of this script or any legal consequences that may arise from its use. This script is intended for educational purposes and ethical use only. If you are uncertain about the legality of using this script in your region, please consult a legal professional.