Skip to content

Repository files navigation

xtrackerbot

Crypto alpha scraping bot that monitors curated X/Twitter accounts and keyword searches using Twitter's internal GraphQL API — no official API key required. Scores and filters tweets by engagement, chain, and category, then pushes actionable alerts to Telegram in real time.

Features

  • Monitors 30+ curated crypto alpha accounts
  • Keyword search rotation across DeFi, NFT, memecoin, and launch categories
  • Tweet scoring by followers, engagement, and chain priority
  • Home timeline scanning
  • Follow tracker — alerts when tracked accounts follow new projects
  • Auto cookie refresh via Playwright browser login
  • Custom keyword and account management via Telegram commands
  • SQLite persistence

Stack

  • Python 3 + httpx (async)
  • Playwright (browser-based fallback scraping)
  • python-telegram-bot
  • SQLite

Setup

pip install -r requirements.txt
cp .env.example .env
# Fill in your Twitter cookies and Telegram bot token
python3 bot.py

Getting Twitter Cookies

See COOKIE_GUIDE.md for step-by-step instructions.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages