extract-blockchain-media

b-open-io's avatarfrom b-open-io

Extract media files (images, videos, documents) from BSV blockchain transactions using the txex CLI tool. Retrieves inscribed ordinals and embedded files.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026
[Document Data Extraction]

When & Why to Use This Skill

This Claude skill facilitates the seamless extraction of embedded media and digital assets from the BSV blockchain. By integrating the txex CLI tool, it allows users to retrieve images, videos, audio, and documents directly from transaction IDs, making it an essential tool for managing on-chain data, ordinal inscriptions, and NFT assets with high efficiency and precision.

Use Cases

  • NFT and Ordinal Retrieval: Automatically download and save high-quality images, videos, or audio files inscribed as ordinals for local archiving or marketplace display.
  • On-chain Data Auditing: Extract and verify the integrity of documents, JSON data, or binary files stored within specific blockchain transactions for technical or legal compliance.
  • Blockchain Content Archiving: Efficiently backup media assets stored on-chain to local directories, ensuring permanent access to decentralized data without relying on external gateways.
  • Developer Resource Management: Streamline the process of fetching raw transaction data and converting it into usable file formats for blockchain-based application development.
nameextract-blockchain-media
descriptionExtract media files (images, videos, documents) from BSV blockchain transactions using the txex CLI tool. Retrieves inscribed ordinals and embedded files.
allowed-tools"Bash(bun:*)"

Extract Blockchain Media

Extract media files from BSV blockchain transactions using txex CLI.

When to Use

  • Extract ordinal inscriptions from transactions
  • Retrieve embedded images/videos/files from blockchain
  • Download NFT assets
  • Access on-chain stored media

Usage

# Extract media from transaction ID
bun run /path/to/skills/extract-blockchain-media/scripts/extract.ts <txid>

# Extract to specific output directory
bun run /path/to/skills/extract-blockchain-media/scripts/extract.ts <txid> /path/to/output

What Gets Extracted

The txex tool extracts:

  • Images (PNG, JPG, GIF, WEBP)
  • Videos (MP4, WEBM)
  • Audio files
  • Text/JSON data
  • Any binary data inscribed in transaction

Output

Files are saved with:

  • Original filename (if embedded in tx)
  • Auto-detected file extension
  • Saved to current directory or specified path

Requirements

  • txex CLI installed: bun add -g txex
  • Transaction ID of ordinal/inscription
  • Internet connection to fetch from blockchain

CLI Reference

txex <txid>                 # Extract to current directory
txex <txid> -o /path        # Extract to specific path

Common Use Cases

  1. View NFT Images: Extract ordinal inscription image
  2. Download Files: Retrieve documents stored on-chain
  3. Archive Media: Backup ordinals locally
  4. Content Verification: Check what's actually inscribed