Xpull

Pull tweets, threads, and articles from X/Twitter without login or API keys*. Agent Skill.

Install

npx -y skills add sanjeevneo/xpull

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Pull tweets, threads, articles, and replies from X/Twitter. FxTwitter API primary (free), Grok x_search fallback (paid).

SKILL.md

1.8 KB, as published. Nobody here has run it

xpull

Scripts

node {baseDir}/scripts/fx-fetch.mjs "<url>" — single tweet or article
node {baseDir}/scripts/fx-fetch.mjs "<url>" --thread — thread (OP only, walks upward)
node {baseDir}/scripts/grok-x-search.mjs thread "<url>" — full thread from root (requires XAI_API_KEY)
node {baseDir}/scripts/grok-x-search.mjs replies "<url>" — replies (requires XAI_API_KEY)
node {baseDir}/scripts/grok-x-search.mjs search "<query>" — search (requires XAI_API_KEY)
node {baseDir}/scripts/grok-x-search.mjs search "<query>" --from <handle> — search by author (requires XAI_API_KEY)

All Grok commands accept optional --images (analyse images in posts) and --video (analyse videos in posts). Off by default — adds token cost when enabled.

Configuration

Variable	Required	Default	Description
`XAI_API_KEY`	For Grok features	—	xAI API key. Get one at console.x.ai.
`GROK_DAILY_CAP`	No	`20`	Max Grok calls per day. Resets at midnight UTC.

Set XAI_API_KEY as an environment variable or in a .env file in the working directory.

Notes

fx-fetch.mjs — free, no credentials, no state. Calls api.fxtwitter.com only.
grok-x-search.mjs — requires XAI_API_KEY. Writes .grok-state.json next to the script to enforce the daily cap. Calls api.x.ai only.
Grok calls cost $5 per 1,000 x_search tool uses + token costs.