Falcon

falcon

Use falcon to read, search, and interact with Twitter/X.

Quick start

falcon check

falcon user elonmusk

falcon tweets elonmusk 5

falcon read

falcon search "bitcoin" 10

Reading users

falcon user Profile info for a single user

falcon users Look up multiple users (comma-separated)

falcon find [count] Search for users by keyword (default: 5)

falcon followers [count] List followers (default: 20)

falcon following [count] List following (default: 20)

Reading tweets

falcon tweets [count] User's tweets and replies (default: 20)

falcon read [...] Read one or more tweets by ID or URL

falcon replies [count] Replies to a tweet (default: 20)

falcon similar Find similar tweets

falcon retweeters [cnt] Who retweeted a tweet (default: 20)

Searching

falcon search [count] Advanced search (default: 10)

falcon hashtag [count] Search by hashtag (default: 20)

falcon cashtag [count] Search by cashtag (default: 20)

falcon trending [country] Trending topics (default: worldwide)

Posting (confirm with user first)

falcon tweet "text"

falcon reply "text"

falcon quote "text"

Engagement (confirm with user first)

falcon like

falcon unlike

falcon retweet

falcon bookmark

falcon follow

falcon unfollow

Account

falcon check Verify API key and cookie are set

falcon balance Check remaining API credits

Auth sources

TWEXAPI_KEY env var: TwexAPI bearer token (required for all commands)

TWITTER_COOKIE env var: Twitter auth cookie (required for write/engagement commands)

Important notes

• The falcon script lives at {baseDir}/falcon.sh
• All commands accept tweet URLs (x.com or twitter.com) or bare tweet IDs
• Always confirm with the user before executing any write or engagement command
• Search accepts any Twitter advanced search syntax
• Hashtags can be passed with or without the # prefix
• Cashtags can be passed with or without the $ prefix
• Country for trending uses slug format: united-states, united-kingdom, japan, etc.