How do I install the Falcon skill?

Run npx skillmds@latest add modbender/falcon in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Falcon skill do?

Search, read, and interact with Twitter/X via TwexAPI It is listed under Coding & Dev Tools on SkillMD.

Is Falcon safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Falcon?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Falcon free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Falcon?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Falcon by modbender — Agent Skill

Name: Falcon
Rating: 4.2 (5 reviews)
Author: modbender

File contents

falcon

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

Quick start

falcon check
falcon user elonmusk
falcon tweets elonmusk 5
falcon read <url-or-id>
falcon search "bitcoin" 10

Reading users

falcon user <username>               Profile info for a single user
falcon users <u1,u2,...>             Look up multiple users (comma-separated)
falcon find <keyword> [count]        Search for users by keyword (default: 5)
falcon followers <username> [count]  List followers (default: 20)
falcon following <username> [count]  List following (default: 20)

Reading tweets

falcon tweets <username> [count]     User's tweets and replies (default: 20)
falcon read <id-or-url> [...]        Read one or more tweets by ID or URL
falcon replies <id-or-url> [count]   Replies to a tweet (default: 20)
falcon similar <id-or-url>           Find similar tweets
falcon retweeters <id-or-url> [cnt]  Who retweeted a tweet (default: 20)

Searching

falcon search <query> [count]        Advanced search (default: 10)
falcon hashtag <tag> [count]         Search by hashtag (default: 20)
falcon cashtag <tag> [count]         Search by cashtag (default: 20)
falcon trending [country]            Trending topics (default: worldwide)

Posting (confirm with user first)

falcon tweet "text"
falcon reply <id-or-url> "text"
falcon quote <tweet-url> "text"

Engagement (confirm with user first)

falcon like <id-or-url>
falcon unlike <id-or-url>
falcon retweet <id-or-url>
falcon bookmark <id-or-url>
falcon follow <username>
falcon unfollow <username>

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.

---name: falcondescription: Search, read, and interact with Twitter/X via TwexAPI--- falcon Use falcon to read, search, and interact with Twitter/X. Quick start falcon check falcon user elonmusk falcon tweets elonmusk 5 falcon read <url-or-id> falcon search "bitcoin" 10 Reading users falcon user <username> Profile info for a single user falcon users <u1,u2,...> Look up multiple users (comma-separated) falcon find <keyword> [count] Search for users by keyword (default: 5) falcon followers <username> [count] List followers (default: 20) falcon following <username> [count] List following (default: 20) Reading tweets falcon tweets <username> [count] User's tweets and replies (default: 20) falcon read <id-or-url> [...] Read one or more tweets by ID or URL falcon replies <id-or-url> [count] Replies to a tweet (default: 20) falcon similar <id-or-url> Find similar tweets falcon retweeters <id-or-url> [cnt] Who retweeted a tweet (default: 20) Searching falcon search <query> [count] Advanced search (default: 10) falcon hashtag <tag> [count] Search by hashtag (default: 20) falcon cashtag <tag> [count] Search by cashtag (default: 20) falcon trending [country] Trending topics (default: worldwide) Posting (confirm with user first) falcon tweet "text" falcon reply <id-or-url> "text" falcon quote <tweet-url> "text" Engagement (confirm with user first) falcon like <id-or-url> falcon unlike <id-or-url> falcon retweet <id-or-url> falcon bookmark <id-or-url> falcon follow <username> falcon unfollow <username> 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.

Frequently asked questions

Falcon