SkillHub

xpull

v1.0.1

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

Sourced from ClawHub, Authored by Neo

Installation

Please help me install the skill `xpull` from SkillHub official store. npx skills add 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)

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.