Freelancer Parser: Automated Message Thread Archiving for eDiscovery

📄 What Is the Freelancer Parser?

The Freelancer Parser is a commercial-grade forensic utility designed to extract, archive, and preserve private message threads from Freelancer.com. Developed by Digital Shield Inc., this tool enables investigators, litigation support teams, and eDiscovery professionals to capture complete communication threads—including messages, attachments, and metadata—in a defensible format suitable for courtroom presentation.

⚙️ How It Works

1. Manual Login for Secure Access
The process starts with the user manually logging into their Freelancer account using Firefox. This step ensures compatibility with 2FA and protects credentials.

2. Automated Thread Processing
Once logged in, the tool systematically:

• Identifies all threads in the inbox
• Opens each one
• Scrolls fully to load all content
• Extracts

the message content, timestamps, sender IDs, and embedded attachments

3. Forensic Output Generation
Each message thread produces:

• A PDF report formatted to mirror Freelancer’s native chat layout
• A .txt transcript preserving emoji, timestamps, and sender names
• A CSV log of all exports, with MD5/SHA1 hashes for chain-of-custody validation
• An Attachments folder per thread with original media
• A Thumbnails folder for previewing attachments inside the PDF and HTML output

🧾 Output Structure

PDF Reports/
├── 123456789.pdf
├── 123456789.txt

Attachments/
└── 123456789/
└── image1.jpg

CSV Report/
└── file_tracker.csv

Thumbnails/
└── thumb_image1.jpg

 

📌 Key Features

🔐 Forensic Integrity: All files are hashed (MD5 + SHA1)

🧠 Smart Extraction: Uses JavaScript-based DOM parsing to preserve sender context, emojis, and timestamps

🖼️ Attachment Archiving: JPG, PNG, and TIFF files extracted and embedded into reports with thumbnails

🧾 PDF Styling: Clean UI emulates real Freelancer conversation flow

📊 CSV Logging: Tracks thread ID, file type, filenames, hashes, and export path

✅ System Requirements

Python 3.10+
Firefox (latest)
Geckodriver (must be in system PATH)
wkhtmltopdf (used for PDF generation)
pip install -r requirements.txt

▶️ How to Use

1. Run python freelancer.py
2. Log in to Freelancer manually
3. Navigate to the Inbox and select the first message thread
4. Press Enter in the terminal
5. The script automatically
   • Captures the conversation
   • Extracts media
   • Generates PDF and text transcripts
   • Logs the export

🛡️ Digital Shield Inc. – Evidence You Can Trust

The Freelancer Parser is engineered for compliance, transparency, and repeatability. It is ideal for:
Civil litigation and breach of contract cases
Cyber investigations and insider threat reviews
Remote collaboration audits and HR inquiries
For licensing, private training, or API integration, contact:
📧 consulting@digitalshield.net | 🌐 www.digitalshield.net