x-tweet-fetcher

Name: x-tweet-fetcher
Author: ythx-101

github.com/ythx-101Data & databases994454 installsUpdated 2w ago

About x-tweet-fetcher

A CLI and Python library for fetching public X/Twitter content, including tweets, timelines, searches, and mentions. It supports multiple backends, with some tasks requiring Nitter or a browser.

Key features

01Fetch single tweets and user profiles
02Retrieve replies and user timelines
03Search posts and monitor mentions
04Read X Lists and Articles
05Route requests across Nitter and browser backends

Use cases

01Collect a tweet’s text, author, metrics, and media URLs
02Review a user’s timeline or search for posts
03Track new mentions of an account
04Fetch content from X Lists or Articles

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ythx-101/x-tweet-fetcher --skill x-tweet-fetcher

After installing, type/x-tweet-fetcherin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore

pyproject.toml

LICENSE

MIGRATION.md

CHANGELOG.md

VERSION

README.md

.github/workflows/

ci.yml

docs/

e2e-integration.md

scripts/

fetch_tweet.py

src/xtf/

__init__.py

cli.py

config.py

exceptions.py

http.py

i18n.py

ledger.py

monitor.py

models.py

src/xtf/backends/

__init__.py

base.py

_camofox_driver.py

_playwright_driver.py

browser.py

nitter.py

fxtwitter.py

src/xtf/parsers/

__init__.py

fxtwitter_json.py

nitter_html.py

urls.py

Details

From the project README

X Tweet Fetcher

Fetch tweets from X/Twitter without authentication. For agent-use stories, failures, and field reports, start from #22 Teahouse / 茶座.

Feature Overview

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>`	Browser (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).

Basic Usage (Zero Dependencies)

# 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.

Timeline / Search / Replies (Nitter)

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 & Articles (Browser)

# 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).

Mentions Monitor (cron-friendly)

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.

Error Handling for Agents

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).

Python API

from xtf import Router
router = Router()
tweets = router.fetch_timeline("elonmusk", limit=20)  # list[Tweet]
print(tweets[0].to_dict())

Directory Structure

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.

Comments

Markdown supported

Details

Author: ythx-101
Repository: ythx-101/x-tweet-fetcher
Category: Data & databases
Installs: 454
GitHub stars: 994

Report

More skills

All skills

hyperframes-core

github.com/heygen-com

930.6k

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

lark-base

open.feishu.cn

823.2k

Operate on Feishu Base: create tables, fields, records, and views; handle statistics, formulas/lookups, forms, dashboards, app mode (BaseApp/AppMode pages and components), Workspace directories, workflows, role permissions, and the template center (Base template categories, lists, and search). Use when encountering Base/multidimensional tables/bitable, BaseApp/AppMode, or /base/ or /app/ links. Do not use lark-apps for BaseApp; route file import/export to lark-drive and authentication/authorization to lark-shared.

lark-sheets

open.feishu.cn

821.8k

Feishu Spreadsheets: create and operate spreadsheets. Supports worksheets and row/column structures (add/delete/merge/size/hide/freeze/group), cell read/write (values/formulas/styles/comments/cell images), range copy/move/sort/fill, find and replace, bulk updates, and creating and maintaining objects such as charts, pivot tables, conditional formatting, filters and filter views, dropdown lists, sparklines, and floating images. Also supports formula validation, restoring historical versions, and importing/exporting local Excel/CSV files and Feishu spreadsheets. Use when users need to create or edit spreadsheets, summarize and visualize data, format spreadsheets, calculate formulas (including migrating Excel formulas), or build financial models (DCF, three statements, budgets, Sensitivity, etc.). For multidimensional tables (Base/bitable), use lark-base. If users want to search for spreadsheet files in cloud storage (Drive/cloud storage) by name or keyword, use lark-drive's drive +search to locate resources first. When users provide a doubao.com /sheets/ URL/token, use this skill directly; do not fall back to WebFetch because the domain is not Feishu. Routing is based on the URL path pattern and token, not the domain.

remotion-best-practices

github.com/remotion-dev

701.4k

Best practices and domain knowledge for building videos programmatically with Remotion (videos in React/TypeScript, rendered to MP4). Use whenever writing or editing Remotion code — scaffolding a video project, animating with interpolate/spring over useCurrentFrame(), sequencing scenes and transitions, captions/subtitles, audio, GIFs/Lottie/3D, charts, visual effects, dynamic duration via calculateMetadata, or rendering. Consult before reaching for a Remotion API, since its components and props evolve (e.g. @remotion/media).