Search Twitter/X and post tweets. Use for ALL X/Twitter data (tweets, user info, mentions, posting). Covers reading and writing to X.
Search Twitter/X and post tweets. All read functions return users with smart_followers count via Frontrun API.
Before running any functions, source the prod environment and venv. Use bash -c 'source /home/dev0xx/Documents/repos/tellr/tellrbot_env/prod.env && source /home/dev0xx/Documents/venvs/tellrbot/bin/activate && ...' to wrap commands. NEVER read the env file directly — it contains secrets.
Script location: /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py search_tweets "query here"
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py get_user_info "username"
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py get_user_tweets "username"
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py get_user_mentions "username"
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py search_users "keyword"
IMPORTANT: ALWAYS show the full tweet text to the user and get explicit approval before sending. Never send without confirmation.
Sends the tweet draft to the Telegram channel for manual posting. Supports replies and quote tweets.
# Simple tweet
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py send_tweet_to_telegram "Hello world"
# Reply to a tweet
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py send_tweet_to_telegram "Nice take" --reply-to 1234567890
# Quote a tweet
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py send_tweet_to_telegram "Check this out" --quote 1234567890
Directly posts a tweet via Tweepy. Currently not in use — use send_tweet_to_telegram instead.
python /home/dev0xx/Documents/repos/tellr/tellrbot-skills/twitter_search.py create_tweet "text" --reply-to <id> --quote <id>
User object (returned by read functions):
{
"username": "handle",
"name": "Display Name",
"followers": 12345,
"smart_followers": 89,
"verified": true,
"bio": "User bio text"
}
Tweet object (returned by search/tweet functions):
{
"id": "123456789",
"text": "Tweet content",
"timestamp": "2026-02-11T12:00:00Z",
"likes": 42,
"retweets": 7,
"replies": 3,
"views": 1500,
"author": { "...user object..." }
}