# Xpull

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

- Skill: `sanjeevneo/xpull` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add sanjeevneo/xpull`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sanjeevneo/xpull/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: sanjeevneo (https://skillmd.com/u/sanjeevneo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sanjeevneo/xpull

---


# 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](https://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.