OSINT Social Media Wrapper

A unified, async-ready Python wrapper for scraping public data from major social media platforms.

This package provides a Manager for easy, single-key access to all supported platforms, as well as standalone classes for specific needs.

Features

• One API Key: Access Twitter, Instagram, Facebook, TikTok, Threads, and Truth Social with a single ScrapeCreators key.
• Free Tools: Includes a built-in Reddit scraper that requires no API key.
• Async-Ready: Designed to integrate easily into async workflows.
• Standardized Output: Returns clean Python dictionaries, not messy HTML.

Installation

pip install osint-social-media-pkg

Code Examples: Manager vs. Direct Tool

Scenario A: Using the Manager (Unified Feel)

from social_media_pkg import SocialMediaManager

# 1. Initialize once
bot = SocialMediaManager(api_key="master_key_123")

# 2. Use different tools easily
twitter_data = await bot.process_twitter_profile("elonmusk")
tiktok_data  = await bot.process_tiktok_profile("khabylame") 
reddit_data  = await bot.process_reddit_profile("spez") # No key needed, but Manager handles it

Scenario B: Using Only One Tool (Direct Import)

# 1. Import ONLY Instagram
from social_media_pkg import InstagramScrapeCreator

# 2. Initialize it directly
insta = InstagramScrapeCreator(api_key="master_key_123")

# 3. Call the specific method for Instagram
# Note: They must remember it is called 'get_user_posts', not 'process_instagram_profile'
photos = await insta.get_user_posts("zuck")