mcpField
T
twitter-reader

twitter-reader

github.com/nicepkgProductivity28898 installsUpdated 41w ago
Repository

About twitter-reader

twitter-reader is a skill for retrieving Twitter/X post content without JavaScript or authentication. With a Jina API key, it fetches post text and metadata and can save individual results or batch-fetch multiple URLs.

Key features

  1. 01Fetches posts without JavaScript
  2. 02Works without Twitter authentication
  3. 03Returns post metadata and Markdown
  4. 04Supports individual and batch retrieval
  5. 05Accepts X and Twitter URL formats

Use cases

  1. 01Reading a post from its URL
  2. 02Saving a post as Markdown
  3. 03Fetching several posts in one run
  4. 04Retrieving posts for review without browser scripting

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nicepkg/ai-workflow --skill twitter-reader

After installing, type/twitter-readerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.security-scan-passed
scripts/
fetch_tweet.py
fetch_tweets.sh

Details

From the project README

Twitter Reader

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

Prerequisites

You need a Jina API key to use this skill:

  1. Visit https://jina.ai/ to sign up (free tier available)
  2. Get your API key from the dashboard
  3. 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

Comments

Markdown supported