infofeeder-bot/vendor/extract-x-bookmarks/README.md

46 lines
1.9 KiB
Markdown

# extract-x-bookmarks
Written by ChatGPT, not me.
[Works fine](https://x.com/thegeneralist01/status/2003819489989926932).
## Requirements
- Python
- Dependencies in `requirements.txt`
## Usage
- Create a virtual environment if you want (`uv venv .venv` or whatever), then activate it. (This is absolutely optional).
- Install dependencies:
```bash
pip install -r requirements.txt
```
- Now, to get the **Cloudflare cookies,** this is quickest way I use:
- Download the [Cookie-Editor extension](https://cookie-editor.com/).
- Open your browser and go to [Twitter](https://x.com).
- Open the Cookie-Editor extension, press the export button (bottom right) and export as Header String. (It will copy it to the clipboard).
- Open the terminal, and run (the python file):
```bash
python isolate_cookies.py
```
- Paste the clipboard content.
- It will then put the two needed cookies into `creds.txt`, which the script will use.
- **If you want to do that without installing the extension,** the `creds.txt` file will have the following format:
```
auth_token=blablabla;ct0=blablabla
```
- A few things to know before running the script:
- It will create a `bookmarks.txt` file with the URLs of your bookmarks.
- The script reads all paginated bookmark responses and, by default, keeps running until there are no bookmarks left.
- Write mode defaults to append (`a`) so new runs continue the timeline in order (newest first to oldest).
- If needed, you can still choose interactively with `python main.py --mode ask`.
- It will take some time in the end to **unbookmark** the fetched bookmarks. Each time 10 new bookmarks are unbookmarked, it will print a message.
- Run the script until you have all your bookmarks extracted:
```bash
python main.py
```
## License
Licensed under the [MIT License](LICENSE).