radimbig-pinchana-twitter 1.0.0

Unofficial PyPI distribution of Pinchana Twitter/X scraper maintained by radimbig

radimbig-pinchana-twitter

Unofficial PyPI distribution of the Pinchana Twitter/X scraper, maintained by radimbig for use as both a Pinchana plugin and an importable Python package.

Original project and copyright belong to Pinchana. This fork keeps the original logic and adds packaging metadata plus a small synchronous library wrapper.

Strategy

1. Primary: X internal GraphQL (TweetResultByRestId) using guest token activation + CSRF (ct0) handling.
2. Resilience: Automatic VPN IP rotation via Gluetun on rate limits (429/403).
3. Fallback: api.fxtwitter.com for public tweet metadata when GraphQL is blocked.
4. Media: Download media to local cache and expose via /media/twitter/{tweet_id}/{file}.

API

• POST /scrape — scrape a tweet URL
• GET /media/twitter/{tweet_id}/{filename} — serve cached media
• GET /health — VPN status

Library Usage

Install the package:

pip install radimbig-pinchana-twitter

Import the package as pinchana_twitter:

from pinchana_twitter import download_x_post_assets

result = download_x_post_assets(
    post_url="https://x.com/user/status/1234567890",
    temp_directory="./temp_videos",
    user_id=42,
    request_id="abc123",
)

print(result["text"])
print(result["author_username"])
print(result["files"])

The synchronous wrapper returns:

{
    "text": "...",
    "author_username": "user",
    "files": [{"path": "...", "media_type": "photo"}],
}

Use media_type == "photo" for images and media_type == "video" for videos.

Publishing

The package publishes to PyPI when a v* tag is pushed and the repository has a PYPI_API_TOKEN secret configured.