Document-level facts: page count, PDF version, encryption flag, first-page size, title/author/producer and the font names the pages reference.

Use this first to learn how many pages a document has before calling the page tools. Returns the extractor's metadata dictionary unchanged (pages, version, encrypted, page_w, page_h, title, author, producer, fonts).

Extract every object of one page: characters, words, rectangles, lines, curves, images and tables.

page is 1-based and must be within the document. The result is one PageData object (width, height and one array per object type), suitable for inspecting layout, text runs and detected tables. Very large pages are rejected: use pdf_export with output_path for those.

Extract every object of every page in a range: the whole document, or first_page..last_page.

Omit both bounds for the whole document. Returns {'metadata', 'pageCount', 'pages'} where pages holds one PageData object per extracted page and pageCount is the number of pages actually returned, not the document's total. Large documents should be read in ranges, or exported with pdf_export.

Per-font usage statistics: character count, pages, size range and colours.

Omit both bounds to analyse the whole document. Returns {'fonts': [...]} sorted by charCount descending; each entry has fontname, pages, charCount, sizeMin, sizeMax and colors. Use it to find which text is prominent without extracting whole pages.

Fetch one embedded image's bytes as base64, addressed by the stream_id reported for that image.

Call pdf_extract_page/pdf_extract_document first and take stream_id from an object of type image (p<page>_img_<index>, index is 0-based within the page). On success returns {'base64', 'format', 'mime_type', 'byte_length'} with the full, untruncated payload; images in non-web formats are transcoded to PNG. On failure returns {'error': '...'} unchanged.

The complete base64 payload is always returned inline: this tool is the one deliberate exception to the 1 MB inline limit the other tools enforce, because the image is the whole point of the call. Large images therefore produce a large response.

Export extracted PDF data as JSON or CSV, either inline or to a file.

This is the tool for anything bigger than a single page: JSON keeps the same shapes as the extract tools (metadata, page count, object types, pages) and CSV lays out one # <type> section per type. Choose scope='page' with page for one page, or scope='document' with optional first_page/last_page. object_types trims the payload and output_path writes the file to disk; otherwise the content comes back inline unless it exceeds the inline limit, in which case it is written to a file in the OS temp directory and that path is returned instead.