Welcome to Saved Posts Tracker

Saved Posts Tracker is a production-grade, self-hosted web application designed to automatically synchronize, mirror, and intelligently index your saved Instagram bookmarks into a database and media storage that you control.

+--------------------------------------------------------------------+
|                      Saved Posts Tracker                           |
|                                                                    |
|  +----------------+   +-------------------+   +-----------------+  |
|  | Multi-Profile  |-->| Resumable Scraper |-->| Cloudinary Sync |  |
|  +----------------+   +-------------------+   +-----------------+  |
|                                                       |            |
|  +----------------+   +-------------------+           v            |
|  | Event Timeline |<--| Qdrant Vector AI  |<-- [ High-Res CDN ]    |
|  +----------------+   +-------------------+                        |
+--------------------------------------------------------------------+

Why We Built This

Instagram saved collections suffer from several critical shortcomings:

1. Expiring Media Signatures: Direct Instagram CDN URLs expire after a short time.
2. Account Deletions & Renames: When creators change their handle or get banned, links break permanently.
3. Zero Semantic Search: Native Instagram offers no visual concept or facial recognition search.
4. Single-Account Friction: Switching between research and personal accounts requires continuous logout/login cycles.

Saved Posts Tracker addresses every one of these problems with a unified, self-hosted architecture.

Key Capabilities

• Netflix-Style Multi-Profile Architecture: Connect multiple Instagram accounts with isolated cookies, custom user-agents, avatars, and separate datasets.
• Resumable Checkpoint Scraper: Uses checkpointMaxId to safely pause and resume scraping across rate limits and network interruptions without duplicates.
• Append-Only Event Timelines: Detects and logs username renames (from @old to @new), account deletions (lost), recoveries, and privacy flips.
• Cloudinary CDN Mirroring: Automatically syncs photos, multi-slide carousels, and video clips to permanent cloud storage.
• Qdrant Vector AI (Beta, optional): 512-dimensional CLIP multimodal search and face-descriptor matching. Off by default — see AI Vector Search to enable it.

Next Steps

• Check out the Quickstart Guide to deploy in 5 minutes.
• Learn about the System Architecture.

🗺️ Documentation Index

🚀 Getting Started

• Quickstart Guide: Get up and running in under 5 minutes with automated scripts or manual setup.
• How to Get Your Instagram Cookie: Visual walkthrough to securely extract your session cookie from Chrome, Firefox, Safari, or extensions.

🏛️ System Architecture

• System Architecture Overview: Data models, Prisma schema, background pipelines, and storage engines.
• Multi-Profile Isolation: Managing multiple accounts with isolated credentials and datasets.
• Resumable Scraping Engine: Checkpoint pagination, backoff retry logic, and error classification.

✨ Features & Integrations

• Cloudinary Permanent CDN: Permanent media hosting to protect against expiring Instagram CDN links.
• AI Vector Search & Face Recognition (Beta, optional — off by default): Multimodal CLIP search and biometric face clustering.

🚢 Deployment Guides

• Docker Compose: Standalone server, home lab, and VPS deployment.
• Coolify Self-Hosting: 1-click Docker Compose apps on Coolify PaaS.
• Dokploy Self-Hosting: Multi-service stack with automated Traefik SSL on Dokploy.
• Reverse Proxy & Authentik SSO: Protecting your instance behind Cloudflare Tunnels, Nginx Proxy Manager, and Authentik SSO.

🛠️ Operations & Maintenance

• Backup & Restore: Automated MongoDB dump/restore procedures and volume management.
• Troubleshooting & FAQ: Solving Instagram rate limits, checkpoint challenges, and common Docker issues.