Fetch X/Twitter tweets, replies, timelines, search, Lists and X Articles without login or API keys. Python CLI + library for AI agents: FxTwitter / Nitter / browser backends with auto fallback, unified JSON, optional SQLite archive. ε η»ε½ε API ζεζ¨ηΉζ¨ζγ
curl -fsSL https://cookapps.net/api/skills/install?skills=β’β’β’β’β’β’β’ | nodeFetch tweets from X/Twitter without authentication. For agent-use stories, failures, and field reports, start from **#22 Teahouse / θΆεΊ§**.
| Feature | Command | Dependencies |
|---|---|---|
| Single tweet | xtf --url <tweet_url> | None (zero deps) |
| Reply threads | xtf --url <tweet_url> --replies | Nitter or browser |
| User timeline | xtf --user <username> --limit 50 | Nitter or browser |
| Search | xtf --search "<query>" | Nitter |
| User profile | xtf --user-info <username> | None (zero deps) |
| X List | xtf --list <list_url_or_id> | Nitter, browser fallback (Camofox/Playwright) |
| X Article | xtf --article <url_or_id> | Browser (Camofox/Playwright) |
| Mentions monitor | xtf --monitor @<username> | Nitter or browser |
python3 scripts/fetch_tweet.py accepts the same flags (v1-compatible entry point).
# JSON output (default) xtf --url https://x.com/user/status/1234567890 # Human-readable xtf --url https://x.com/user/status/1234567890 --text-only # Output covers: text, author, stats (likes/retweets/views), media URLs, # quoted tweets, and full article text for tweet-embedded articles.
export XTF_NITTER=http://127.0.0.1:8788 # your instance; comma-separate for failover xtf --user elonmusk --limit 20 xtf --search "openclaw" --limit 10 xtf --url https://x.com/user/status/123 --replies
Backend selection: --backend auto (default, Nitter first then browser), --backend nitter, --backend browser.
Lists try Nitter first (plain HTTP) and fall back to the browser; Articles need the browser.
# Articles (and the Lists browser fallback) need a browser driver: # Camofox running on localhost:9377 (default), or: export XTF_BROWSER=playwright xtf --list https://x.com/i/lists/1455045069516357634 --limit 30 xtf --article https://x.com/i/article/2011779830157557760
Note: full X Article text requires X login; without it you get title + public preview (is_partial: true).
xtf --monitor @yourhandle # exit 0 = no new mentions, 1 = new mentions found, 2 = setup error # First run builds a baseline silently; later runs report only new URLs.
Every error result includes error (message) and error_code:
invalid_input Β· not_found Β· rate_limited Β· upstream_down Β· backend_unavailable Β· all_backends_failed (with per-backend error_causes).
from xtf import Router
router = Router()
tweets = router.fetch_timeline("elonmusk", limit=20) # list[Tweet]
print(tweets[0].to_dict())src/xtf/ βββ backends/ # fxtwitter.py, nitter.py, browser.py βββ parsers/ # pure parsing functions, fixture-tested βββ router.py # auto-fallback βββ monitor.py # mentions monitor βββ cli.py # the `xtf` command scripts/fetch_tweet.py # v1-compatible shim
Looking for Chinese-platform fetching (Weibo/Bilibili/WeChat) or tweet growth tracking? Those moved out of this repo in v2 β see MIGRATION.md.
One MCP for reverse engineering across binaries, applications, and runtime behavior. Point your AI coding agent at any compiled app to understand its mechanics down to the binary level.
The definitive suite of 39 production grade agent skills by Matt Pocock for real software engineering, domain modeling, rigorous alignment grilling, TDD, and deep module architecture.
Get instant access to complete setup guides, repository source code, and integration assets.