# 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.

- **Type:** Skill
- **Install:** `agentstack add skill-nicepkg-ai-workflow-twitter-reader`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nicepkg](https://agentstack.voostack.com/s/nicepkg)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nicepkg](https://github.com/nicepkg)
- **Source:** https://github.com/nicepkg/ai-workflow/tree/main/workflows/content-creator-workflow/.claude/skills/twitter-reader
- **Website:** https://ai-workflow.xiaominglab.com/

## Install

```sh
agentstack add skill-nicepkg-ai-workflow-twitter-reader
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:

```bash
export JINA_API_KEY="your_api_key_here"
```

## Quick Start

For a single tweet, use curl directly:

```bash
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:

```bash
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.

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

### fetch_tweets.sh

Bash script for batch fetching multiple tweets.

```bash
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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nicepkg](https://github.com/nicepkg)
- **Source:** [nicepkg/ai-workflow](https://github.com/nicepkg/ai-workflow)
- **License:** MIT
- **Homepage:** https://ai-workflow.xiaominglab.com/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-nicepkg-ai-workflow-twitter-reader
- Seller: https://agentstack.voostack.com/s/nicepkg
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.