Metadata-Version: 2.4
Name: osint-social-media-pkg
Version: 0.1.0
Summary: Async OSINT wrapper for social media
Project-URL: Homepage, https://bitbucket.org/inits/osint-social-search-pkg
Project-URL: Source, https://bitbucket.org/inits/osint-social-search-pkg/src/master/
Requires-Python: >=3.8
Requires-Dist: certifi>=2023.7.22
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# 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

```bash
pip install osint-social-media-pkg
```

### Code Examples: Manager vs. Direct Tool
Scenario A: Using the Manager (Unified Feel)
```bash
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)

```bash
# 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")
```