菜单
Use twitter-cli for ALL Twitter/X operations — reading tweets, posting, replying, quoting, liking, retweeting, following, searching, and user lookups. Invoke whenever the user requests any Twitter/X interaction.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/hwj123hwj/custom-skills --skill twitter-cli命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
Ask which skill or flow fits your situation. A router over the skills in this repo.
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.
| name | twitter-cli |
| displayName | Twitter CLI |
| description | Use twitter-cli for ALL Twitter/X operations — reading tweets, posting, replying, quoting, liking, retweeting, following, searching, and user lookups. Invoke whenever the user requests any Twitter/X interaction. |
| author | jackwener |
| upstream | public-clis/twitter-cli |
| upstreamSha | 7c634e0d396b1e7af9f63315b414925fe4f29ae7 |
| version | 0.8.0 |
| tags | ["Social","Search","CLI"] |
| aliases | ["Twitter","X","推特","推文"] |
| scenarios | ["搜索 Twitter/X 推文或话题","查看时间线、书签或用户动态","对推文执行点赞、转推、回复、引用等操作"] |
Binary: twitter
Credentials: browser cookies (auto-extracted) or env vars
# Install (requires Python 3.8+)
uv tool install twitter-cli
# Or: pipx install twitter-cli
# Upgrade to latest (recommended to avoid API errors)
uv tool upgrade twitter-cli
# Or: pipx upgrade twitter-cli
IMPORTANT FOR AGENTS: Before executing ANY twitter-cli command, you MUST first check whether credentials exist. If not, proactively guide the user through authentication. Do NOT assume credentials are configured.
CRITICAL: Write operations (posting tweets, replying, quoting) require full browser cookies. Only providing auth_token + ct0 via env vars may trigger HTTP 226 ("looks like automated behavior"). Prefer browser cookie extraction whenever possible.
twitter status --yaml >/dev/null && echo "AUTH_OK" || echo "AUTH_NEEDED"
If AUTH_OK, continue to the command reference.
If AUTH_NEEDED, guide the user using one of the following methods.
Method A: Browser cookie extraction (recommended)
Ensure the user is logged into x.com in Arc, Chrome, Edge, Firefox, or Brave. twitter-cli auto-extracts cookies.
TWITTER_CHROME_PROFILE="Profile 2" twitter feedTWITTER_BROWSER=chrome twitter feedVerify with:
twitter whoami
Method B: Environment variables
export TWITTER_AUTH_TOKEN="<auth_token from browser>"
export TWITTER_CT0=
twitter
Method C: Full cookie string (for cloud/remote agents)
Ask the user to export cookies from a logged-in browser session, then extract:
FULL_COOKIE="<user's cookie string>"
export TWITTER_AUTH_TOKEN=$(echo "$FULL_COOKIE" | grep -oE 'auth_token=[a-f0-9]+' | cut -d= -f2)
export TWITTER_CT0=$(echo "$FULL_COOKIE" | grep -oE 'ct0=[a-f0-9]+' | cut -d= -f2)
twitter whoami
| Symptom | Agent action |
|---|---|
No Twitter cookies found | Guide user to log into x.com in a supported browser, or set env vars |
| Read works, write returns 226 | Full cookies are missing; use browser cookie extraction instead of env vars |
Cookie expired (401/403) | Ask user to re-login to x.com and retry |
| User changed password | All old cookies are invalidated; re-extract cookies |
twitter feed
Non-TTY stdout defaults to YAML automatically. Use OUTPUT=yaml|json|rich|auto to override.
twitter feed --yaml
twitter feed --json | jq '.[0].text'
All machine-readable output uses the envelope documented in SCHEMA.md. Tweet and user payloads live under .data.
--full-textUse --full-text when the user wants complete post bodies in terminal tables. It affects rich table list views such as feed, bookmarks, search, user-posts, likes, list, and reply tables in tweet.
twitter feed --full-text
twitter search "AI agent" --full-text
twitter user-posts elonmusk --max 20 --full-text
twitter tweet 1234567890 --full-text
-cUse compact mode when token efficiency matters.
twitter -c feed --max 10
twitter -c search "AI" --max 20
Compact tweet fields: id, author, text, likes, rts, time
twitter status
twitter status --yaml
twitter whoami
twitter whoami --yaml
twitter whoami --json
twitter user elonmusk
twitter user elonmusk --json
twitter feed
twitter feed -t following
twitter feed --max 50
twitter feed --full-text
twitter feed --filter
twitter feed --yaml > tweets.yaml
twitter feed --input tweets.json
twitter bookmarks
twitter bookmarks --full-text
twitter bookmarks --max 30 --yaml
twitter search "keyword"
twitter search "AI agent" -t Latest --max 50
twitter search "AI agent" --full-text
twitter search "topic" -o results.json
twitter tweet 1234567890
twitter tweet 1234567890 --full-text
twitter tweet https://x.com/user/status/12345
twitter show 2
twitter show 2 --full-text
twitter show 2 --json
twitter list 1539453138322673664
twitter list 1539453138322673664 --cursor "<next-cursor>"
twitter list 1539453138322673664 --full-text
twitter user-posts elonmusk --max 20
twitter user-posts elonmusk --full-text
twitter likes elonmusk --max 30
twitter likes elonmusk --full-text
twitter followers elonmusk --max 50
twitter following elonmusk --max 50
twitter post "Hello from twitter-cli!"
twitter post "Hello!" --image photo.jpg
twitter post "Gallery" -i a.png -i b.jpg
twitter reply 1234567890 "Great tweet!"
twitter reply 1234567890 "Nice!" -i pic.png
twitter post "reply text" --reply-to 1234567890
twitter quote 1234567890 "Interesting take"
twitter quote 1234567890 "Look" -i chart.png
twitter delete 1234567890
twitter like 1234567890
twitter unlike 1234567890
twitter retweet 1234567890
twitter unretweet 1234567890
twitter bookmark 1234567890
twitter unbookmark 1234567890
twitter follow elonmusk
twitter unfollow elonmusk
Image upload notes:
--image / -i (repeatable)twitter -c feed -t following --max 30
twitter -c bookmarks --max 20
twitter feed -t following --max 20 --full-text
twitter search "AI agent" --max 20 --full-text
twitter feed -t following --max 30 -o following.json
twitter bookmarks --max 20 -o bookmarks.json
twitter search "AI safety" --max 20 --json | jq '[.data[] | select(.metrics.likes > 100)]'
twitter search "rust lang" --max 10 --json | jq '.data[] | {author: .author.screenName, text: .text[:100]}'
twitter search "topic" --max 20 --json | jq '.data | sort_by(.metrics.likes) | reverse | .[:5] | .[].id'
twitter likes works only for your own account because likes are private