mcpbeat

Twitter Reader

nicepkg/twitter-reader

Fetch Twitter/X post content by URL using jina.ai API to bypass JavaScript restrictions. Use when Claude needs to retrieve tweet content including author, timestamp, post text, images, and thread replies. Supports individual posts or batch fetching from x.com or twitter.com URLs.

1k tokens
context cost
the whole folder, loaded on every use
4
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
275
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/nicepkg/ai-workflow --skill twitter-reader

The instruction itself

9 sections, as written by the author

Twitter Reader

Fetch Twitter/X post content without needing JavaScript or authentication.

Prerequisites

You need a Jina API key to use this skill:

  • Visit https://jina.ai/ to sign up (free tier available)
  • Get your API key from the dashboard
  • Set the environment variable:
export JINA_API_KEY="your_api_key_here"

Quick Start

For a single tweet, use curl directly:

curl "https://r.jina.ai/https://x.com/USER/status/TWEET_ID" \
  -H "Authorization: Bearer ${JINA_API_KEY}"

For multiple tweets, use the bundled script:

scripts/fetch_tweets.sh url1 url2 url3

What Gets Returned

  • Title: Post author and content preview
  • URL Source: Original tweet link
  • Published Time: GMT timestamp
  • Markdown Content: Full post text with media descriptions

Bundled Scripts

fetch_tweet.py

Python script for fetching individual tweets.

python scripts/fetch_tweet.py https://x.com/user/status/123 output.md

fetch_tweets.sh

Bash script for batch fetching multiple tweets.

scripts/fetch_tweets.sh \
  "https://x.com/user/status/123" \
  "https://x.com/user/status/456"

URL Formats Supported

  • https://x.com/USER/status/ID
  • https://twitter.com/USER/status/ID
  • https://x.com/... (redirects work automatically)

Environment Variables

  • JINA_API_KEY: Required. Your Jina.ai API key for accessing the reader API

How to use it

Copy the folder

Take nicepkg/twitter-reader from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.