agentsclimarketplace
Sign in

Xpull

Skill sanjeevneo/xpull

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

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.

4 things to look at

  • reads credentialsReads from 2 credential sources: `XAI_API_KEY` and 1 more.
  • 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.
  • runs commandsInstructs the agent to run 6 commands, including `node {baseDir}/scripts/fx-fetch.mjs "<url>"` and 5 more.
  • fetches URLsInstructs the agent to fetch 2 URLs, including api.fxtwitter.com and 1 more.

SKILL.md

1.8 KB, 420 tokens by cl100k_base, 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

VariableRequiredDefaultDescription
XAI_API_KEYFor Grok features—xAI API key. Get one at console.x.ai.
GROK_DAILY_CAPNo20Max 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.

What ships with it: 5 files

10.1 KB alongside SKILL.md, 2 of them executable

scripts/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.