🚀 Xeepy¶

import asyncio
from xeepy import Xeepy

async def main():
    async with Xeepy() as x:
        # Get tweet replies (the original mission!)
        replies = await x.scrape.replies("https://x.com/elonmusk/status/123456")

        # Scrape user profiles
        profile = await x.scrape.profile("elonmusk")

        # Get followers with pagination
        followers = await x.scrape.followers("naval", limit=5000)

        # Search tweets
        tweets = await x.scrape.search("python programming", limit=100)

        # Export to CSV
        x.export.to_csv(replies, "replies.csv")

asyncio.run(main())

async with Xeepy() as x:
    # Unfollow non-followers (the #1 requested feature!)
    result = await x.unfollow.non_followers(
        max_unfollows=100,
        whitelist=["bestfriend", "mom"],
        dry_run=True  # Preview first
    )

    # Follow users from a competitor's followers
    await x.follow.target_followers(
        target="competitor",
        limit=50,
        filters={"min_followers": 100, "has_bio": True}
    )

from xeepy import UnfollowerDetector, GrowthTracker

# Detect who unfollowed you
detector = UnfollowerDetector(storage=storage, notifier=notifier)
report = await detector.detect("yourusername")
print(f"Lost {len(report.unfollowers)} followers today 😢")

# Track growth over time
tracker = GrowthTracker(storage=storage)
growth = tracker.generate_report("yourusername", days=30)
print(f"Gained {growth.net_change} followers this month! 🚀")

from xeepy.ai import ContentGenerator, SentimentAnalyzer

# Generate viral content
generator = ContentGenerator(provider="openai")
thread = await generator.generate_thread(
    topic="10 Python tips that will blow your mind",
    style="viral",
    num_tweets=10
)

# Analyze conversation sentiment
analyzer = SentimentAnalyzer()
result = await analyzer.analyze_conversation(replies)
print(f"Overall sentiment: {result.overall_sentiment}")

from xeepy.notifications import NotificationManager

manager = NotificationManager()
manager.add_channel("discord", WebhookNotifier(discord_url))
manager.add_channel("telegram", TelegramNotifier(bot_token, chat_id))
manager.add_channel("email", EmailNotifier(smtp_config))

# Now all your alerts go everywhere
await manager.notify(
    title="🚨 Viral Tweet Alert!",
    message="Your tweet just hit 10,000 likes!",
    level="success"
)