qdrant-file-exporter

Export PDF text chunks from Qdrant to a plain text file.

Updated Oct 9, 2025
One-click install
npx skills add https://github.com/techybolek/child --skill qdrant-file-exporter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qdrant-file-exporter
Source: https://github.com/techybolek/child/tree/main/.claude/skills/qdrant-file-exporter
Command: npx skills add https://github.com/techybolek/child --skill qdrant-file-exporter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires qdrant-client, and includes scripts (resource) components.

What problem does it solve?

This Skill enables exporting all text chunks for a specific PDF document stored in the Qdrant vector database to a plain text file, including the three-tier contextual embeddings (master context, document context, and chunk-specific contexts), for offline inspection, analysis, or auditing.

Core Features & Use Cases

  • Bulk Export: Retrieve and save all chunks for a given PDF in a single operation.
  • Three-Tier Contexts: Includes master context, document context, and chunk-specific context to enhance understanding and debugging.
  • Sequential Order: Chunks are output in the original document order (by chunk_index) for fidelity.
  • Plain Text Output: Clean, readable text file saved to the UTIL directory.
  • Contextful Output: Output includes master/document contexts to support deeper analysis.

Quick Start

Use the qdrant file exporter to dump all chunks for a specific PDF from Qdrant into a text file:

  • Run: python .claude/skills/qdrant-file-exporter/scripts/export_chunks.py "your-document.pdf"

Frequently Asked Questions about qdrant-file-exporter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export all text chunks from a PDF stored in Qdrant?

Export all text chunks by running the qdrant-file-exporter script with your PDF filename. The tool connects to Qdrant, filters chunks by filename, retrieves them in batches, sorts by chunk index, and saves to a plain text file in the UTIL directory with full contextual metadata.

What contextual information is included when exporting PDF chunks from Qdrant?

Exported chunks include three-tier contexts: master context, document context, and chunk-specific context. This hierarchical metadata preserves the semantic relationships and enhances offline inspection and analysis of each extracted chunk.

Can I preserve chunk order when exporting from a Qdrant vector database?

Yes, chunks are automatically sorted by chunk_index during export, maintaining the original document order. This ensures sequential fidelity and readability in the output text file.

Does the PDF chunk export work with large documents in Qdrant?

The exporter handles documents at scale by scrolling through results in batches of up to 100 chunks per request. This batch processing enables efficient retrieval and export of PDFs with hundreds or thousands of chunks.

What do I need to set up before exporting chunks from Qdrant?

Configure QDRANT_API_URL and QDRANT_API_KEY environment variables to connect to your Qdrant instance. Ensure the qdrant-client dependency is installed and your PDF has been indexed into the tro-child-3-contextual collection.

Can I use Qdrant chunk export for auditing or offline analysis?

Yes, the plain text output is designed for offline inspection, compliance auditing, and detailed analysis of document chunks outside the vector database, with all contextual layers preserved for comprehensive review.