# 🍪 CookieSpy
CookieSpy is a simple tool for retrieving, displaying, and exporting cookies from a URL.
Supports colorized CLI display (via `rich`), export to JSON/CSV, and a simple web-based GUI (Flask).
---
## FLowchart
<center>
<img src="./cookiespy-diagram.drawio.png" alt="diagram business for cookiespy" />
</center>
## Installation
Clone this repository
```bash
https://github.com/fdhliakbar/CookieSpy.git
```
Install requirements
```bash
pip install -r requirements.txt
```
Install as a package (recommended):
```bash
pip install -e .
```
## CLI Usage
```bash
🔍 Mengambil cookies...
✔ Cookies ditemukan: {'_gh_sess':
'3TLOJqcMKU9Mi5JN8EkecauN9FsSaImjhCOiKu8YDXpalofmkZbBe1xYtVDBFYf6bmbNh6MTfg8IVY2wsq%2FVN46DF2ok51y2O%2FHGYnq1X8qXX3zLmRFtZzierEp1O%2BuPy9StY3jL11vTVDNmjvX2%2Bdfy99JZ0fZOc
Dle6ZmLE0%2F8kvP6oMMB%2FGhOb0jGTwRPpEuAfmy%2BFmoGfg%2FqUZTpNk6JvPifKDVLAFwVPH08JyFwuf2YxM1tRs1S2Rx7H%2B%2Blo8mLWUKKDpVeGaONLYeNbQ%3D%3D--2bPnIxmDdV4DSGDx--L5Zjb9nicw2HqWy
0LoVW%2BQ%3D%3D', '_octo': 'GH1.1.89567047.1755552745', 'logged_in': 'no'}
``` -->
### Install Packages
```bash
pip install dist/cookiespy-0.1.0-py3-none-any.whl
Installing collected packages: cookiespy
Successfully installed cookiespy-0.1.0
```
### Run Program with CLI(Command Line Interface)
```bash
# Export with JSON
cookiespy https://youtube.com/ --export json
# Export with CSV
cookiespy https://youtube.com/ --export csv
```
### Output JSON
```bash
Fetching cookies from: https://facebook.com/
Cookies found: {'fr': '0qhvcEPszmVSmExBF..Boqw-r..AAA.0.0.Boqw-r.AWe5t84W9KkqFc6QoQPZqX7icCs', 'sb': 'qw-raOaLC5CvSSBM3qNhw0wf'}
[+] Cookies diexport ke cookies.json
Exported cookies to cookies.json
```
### Output CSV
```bash
Fetching cookies from: https://facebook.com/
Cookies found: {'fr': '0o5AyAWMjYLU5Wf8G..Boqw_G..AAA.0.0.Boqw_G.AWejVulJjL0qf-r097kKCKBqM4k', 'sb': 'xg-raIpCTxgOpbwcUJfHj7bj'}
[+] Cookies diexport ke cookies.csv
Exported cookies to cookies.csv
```
## Testing
Before testing, you must install the required packages. You can install all the required packages by
```bash
#Install requirement first
pip install -r requirements.txt
# Then you can enter the directory and run the program like this
cd test; pytest -v testing.py
# Output
========================================================================== test session starts ==========================================================================
platform win32 -- Python 3.13.3, pytest-8.4.1, pluggy-1.6.0 -- C:\Users\USER\AppData\Local\Programs\Python\Python313\python.exe
cachedir: .pytest_cache
rootdir: E:\Github-Database\CookieSpy
configfile: pyproject.toml
plugins: anyio-4.9.0
collected 1 item
testing.py::test_fetch_cookies_google PASSED [100%]
=========================================================================== 1 passed in 1.25s ===========================================================================
```
---
<img src="https://i.pinimg.com/1200x/2c/be/1d/2cbe1db9099cfd8409444f5837d16afb.jpg" alt="Anime Banner" />
Raw data
{
"_id": null,
"home_page": null,
"name": "cookiespy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "cookies, cli, http, export",
"author": null,
"author_email": "Fadhli Akbar <fadhliakbar125@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/3d/5d/e42473f4275537807ca5444ec1ee92439e3008ee804aa4566cf3c0d29bc3/cookiespy-0.1.0.tar.gz",
"platform": null,
"description": "# \ud83c\udf6a CookieSpy\r\n\r\nCookieSpy is a simple tool for retrieving, displaying, and exporting cookies from a URL. \r\nSupports colorized CLI display (via `rich`), export to JSON/CSV, and a simple web-based GUI (Flask).\r\n\r\n---\r\n\r\n## FLowchart\r\n\r\n<center>\r\n<img src=\"./cookiespy-diagram.drawio.png\" alt=\"diagram business for cookiespy\" />\r\n</center>\r\n\r\n\r\n## Installation\r\n\r\nClone this repository\r\n```bash\r\nhttps://github.com/fdhliakbar/CookieSpy.git\r\n```\r\n\r\nInstall requirements\r\n```bash\r\npip install -r requirements.txt\r\n```\r\n\r\nInstall as a package (recommended):\r\n```bash\r\npip install -e .\r\n```\r\n\r\n## CLI Usage\r\n\r\n```bash\r\n\ud83d\udd0d Mengambil cookies...\r\n\r\n\u2714 Cookies ditemukan: {'_gh_sess': \r\n'3TLOJqcMKU9Mi5JN8EkecauN9FsSaImjhCOiKu8YDXpalofmkZbBe1xYtVDBFYf6bmbNh6MTfg8IVY2wsq%2FVN46DF2ok51y2O%2FHGYnq1X8qXX3zLmRFtZzierEp1O%2BuPy9StY3jL11vTVDNmjvX2%2Bdfy99JZ0fZOc\r\nDle6ZmLE0%2F8kvP6oMMB%2FGhOb0jGTwRPpEuAfmy%2BFmoGfg%2FqUZTpNk6JvPifKDVLAFwVPH08JyFwuf2YxM1tRs1S2Rx7H%2B%2Blo8mLWUKKDpVeGaONLYeNbQ%3D%3D--2bPnIxmDdV4DSGDx--L5Zjb9nicw2HqWy\r\n0LoVW%2BQ%3D%3D', '_octo': 'GH1.1.89567047.1755552745', 'logged_in': 'no'}\r\n``` -->\r\n\r\n### Install Packages\r\n\r\n```bash\r\npip install dist/cookiespy-0.1.0-py3-none-any.whl\r\n\r\nInstalling collected packages: cookiespy\r\nSuccessfully installed cookiespy-0.1.0\r\n```\r\n\r\n### Run Program with CLI(Command Line Interface)\r\n```bash\r\n# Export with JSON\r\ncookiespy https://youtube.com/ --export json\r\n\r\n# Export with CSV\r\ncookiespy https://youtube.com/ --export csv\r\n\r\n```\r\n\r\n### Output JSON\r\n```bash\r\nFetching cookies from: https://facebook.com/\r\nCookies found: {'fr': '0qhvcEPszmVSmExBF..Boqw-r..AAA.0.0.Boqw-r.AWe5t84W9KkqFc6QoQPZqX7icCs', 'sb': 'qw-raOaLC5CvSSBM3qNhw0wf'}\r\n[+] Cookies diexport ke cookies.json\r\nExported cookies to cookies.json\r\n```\r\n\r\n### Output CSV\r\n```bash\r\nFetching cookies from: https://facebook.com/\r\nCookies found: {'fr': '0o5AyAWMjYLU5Wf8G..Boqw_G..AAA.0.0.Boqw_G.AWejVulJjL0qf-r097kKCKBqM4k', 'sb': 'xg-raIpCTxgOpbwcUJfHj7bj'}\r\n[+] Cookies diexport ke cookies.csv\r\nExported cookies to cookies.csv\r\n```\r\n\r\n## Testing\r\n\r\nBefore testing, you must install the required packages. You can install all the required packages by\r\n\r\n```bash\r\n#Install requirement first\r\npip install -r requirements.txt\r\n\r\n\r\n# Then you can enter the directory and run the program like this\r\ncd test; pytest -v testing.py\r\n\r\n# Output \r\n\r\n========================================================================== test session starts ==========================================================================\r\nplatform win32 -- Python 3.13.3, pytest-8.4.1, pluggy-1.6.0 -- C:\\Users\\USER\\AppData\\Local\\Programs\\Python\\Python313\\python.exe\r\ncachedir: .pytest_cache\r\nrootdir: E:\\Github-Database\\CookieSpy\r\nconfigfile: pyproject.toml\r\nplugins: anyio-4.9.0\r\ncollected 1 item \r\n\r\ntesting.py::test_fetch_cookies_google PASSED [100%]\r\n\r\n=========================================================================== 1 passed in 1.25s ===========================================================================\r\n```\r\n\r\n---\r\n\r\n<img src=\"https://i.pinimg.com/1200x/2c/be/1d/2cbe1db9099cfd8409444f5837d16afb.jpg\" alt=\"Anime Banner\" />\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A simple cookie inspection & export CLI tool.",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/fdhliakbar/cookiespy",
"Issues": "https://github.com/fdhliakbar/cookiespy/issues"
},
"split_keywords": [
"cookies",
" cli",
" http",
" export"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8f6ac883859495f85793aeee9f1f3056d0a2221e3686aecdb802da57393418dd",
"md5": "7296f8310d72c13f890aea257271db1e",
"sha256": "b5cb86b812b04f93c251c82085ce1011dbde9c7f3d4a47f5f44fa19eadd81eea"
},
"downloads": -1,
"filename": "cookiespy-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7296f8310d72c13f890aea257271db1e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 5471,
"upload_time": "2025-08-24T14:05:46",
"upload_time_iso_8601": "2025-08-24T14:05:46.908434Z",
"url": "https://files.pythonhosted.org/packages/8f/6a/c883859495f85793aeee9f1f3056d0a2221e3686aecdb802da57393418dd/cookiespy-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3d5de42473f4275537807ca5444ec1ee92439e3008ee804aa4566cf3c0d29bc3",
"md5": "21c5aebecd88e040cd01a7ddf74db456",
"sha256": "72cd2a5542762f0cf7237bf74cef51c093b41b823d80da5154321205948843c8"
},
"downloads": -1,
"filename": "cookiespy-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "21c5aebecd88e040cd01a7ddf74db456",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 5244,
"upload_time": "2025-08-24T14:05:48",
"upload_time_iso_8601": "2025-08-24T14:05:48.420393Z",
"url": "https://files.pythonhosted.org/packages/3d/5d/e42473f4275537807ca5444ec1ee92439e3008ee804aa4566cf3c0d29bc3/cookiespy-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-24 14:05:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fdhliakbar",
"github_project": "cookiespy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "requests",
"specs": []
},
{
"name": "beautifulsoup4",
"specs": []
},
{
"name": "rich",
"specs": []
},
{
"name": "flask",
"specs": []
},
{
"name": "pandas",
"specs": []
},
{
"name": "pytest",
"specs": []
}
],
"lcname": "cookiespy"
}
JSON
