21 Intelligence Gathering Functions

• Keyword search across BlueSky
• Hashtag monitoring
• Advanced search with filters
• Trending posts discovery
• User mention tracking

• Complete profile analysis
• Timeline collection & archiving
• Liked posts analysis
• Reply pattern tracking
• Activity & engagement statistics

• Follower/following lists
• Network Mapper - Compare 2 accounts, find shared connections
• Community Detection - Analyze account structure & social role

• Single user tracking
• Hashtag trend monitoring
• Multi-user simultaneous tracking

• Loading animations & progress bars
• Color-coded output
• Emoji icons for clarity
• Clean terminal UI

• Python 3.7+
• BlueSky account
• Internet connection

git clone https://github.com/OSINTCabal/OSINTSky.git
cd OSINTSky
pip install -r requirements.txt
python3 blueskyosint.py

pip install atproto colorama
python3 blueskyosint.py

Login with your BlueSky credentials when prompted:

Handle: your.handle.bsky.social
Password: your_password

Security Tips:

• Credentials are NOT stored
• Session-only authentication
• Use app passwords for security
• See AUTHENTICATION.md for details

python3 blueskyosint.py

1. Profile User (Option 6) → Get overview
2. Collect Timeline (Option 7) → Archive posts  
3. Activity Analysis (Option 10) → Statistics
4. Export Results (Option 18) → Save as JSON

Network Mapper (Option 13)
  Account 1: suspect1.bsky.social
  Account 2: suspect2.bsky.social
  Result: Shared followers & following

Monitor User (Option 15)
  Track: target.bsky.social
  Interval: 60 seconds
  Duration: 300 seconds

• AUTHENTICATION.md - Security & login guide
• NETWORK_ANALYSIS_GUIDE.md - Advanced network analysis
• QUICKSTART.md - 5-minute getting started guide
• CONTRIBUTING.md - Contribution guidelines

proxychains4 python3 blueskyosint.py

• Use VPN/Tor for anonymity
• Create dedicated investigation account
• Use app passwords
• Export to encrypted storage
• Rotate credentials regularly

For Legitimate Use Only

✅ Licensed investigators
✅ Law enforcement
✅ Security researchers
✅ Journalists
✅ Academic research

❌ Harassment
❌ Unauthorized surveillance
❌ Commercial scraping
❌ ToS violations

You are responsible for legal compliance.

• atproto - AT Protocol SDK
• colorama - Terminal colors

• app.bsky.feed.searchPosts
• app.bsky.actor.getProfile
• app.bsky.feed.getAuthorFeed
• app.bsky.graph.getFollowers
• app.bsky.graph.getFollows

Authentication Failed

• Verify credentials
• Try app password
• Check 2FA is disabled

Network Error

• Check connection
• Try without proxy
• Verify BlueSky status

No Results

• Broaden search terms
• Check account privacy
• Verify handle spelling

Contributions welcome! See CONTRIBUTING.md

• Report bugs
• Suggest features
• Improve docs
• Submit PRs

• Advanced filtering
• Media downloads
• Graph visualization
• Sentiment analysis
• CSV export
• Historical comparison

OSINTCabal

• GitHub: @OSINTCabal
• BlueSky: @osintcabal.bsky.social

• ChanSINT - 4chan/8kun OSINT
• TelegramOSINT-Kit - Telegram Intelligence
• SneakLeak - Breach Data Analysis

MIT License - See LICENSE