.codex-plugin/plugin.json

{
  "name": "pdf-to-excel",
  "version": "1.0.0",
  "description": "Turn the tables in a text PDF into a real Excel workbook and CSV files.",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://pdf-to-excel.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "pdf to excel",
    "convert pdf to excel",
    "pdf table to excel",
    "pdf to csv",
    "extract table from pdf",
    "pdf to xlsx",
    "bank statement pdf to excel",
    "pdf to spreadsheet",
    "convert pdf to excel free",
    "copy table from pdf"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Zovo PDF to Spreadsheet",
    "shortDescription": "PDF tables into a spreadsheet",
    "longDescription": "Convert a PDF table to Excel and download real XLSX files that open in Excel: Zovo PDF to Spreadsheet reads the tables in a text-based PDF (bank statements, invoices, product lists, reports) and returns one Excel sheet per table plus a ZIP of CSV files. Numbers within spreadsheet precision stay numeric; higher-precision values remain text with a warning. Dates become spreadsheet dates in a US format, and each table comes with detected column types and a preview of the first rows so you can check the result before you use it.\n\nThe plugin finds a table by its rows and aligned columns (3 rows or more, 2 columns or more), joins the last table on a page to the first on the next page only when their column counts and source headers match after whitespace collapse. Rows outside detected tables are retained in an Other text sheet (Page, Line, Text) and other-text.csv. It reads numbers written as 1,234.56 or 1.234,56, negatives in parentheses or with a trailing minus, currency symbols and percent, and dates written as ISO (2026-03-05), MM/DD/YYYY or DD/MM/YYYY. A page with no text layer is reported as a scanned page instead of guessed.\n\nThe widget shows a preview of each table with a table selector and a per-column type switch (text, number or date) that changes the export, plus Download Excel and Download CSV files buttons. Generated files are kept for about one hour, then deleted.\n\nLimitations: text-based PDFs only (scanned pages are not read; run OCR first), complex layouts with merged cells may need a manual check, and a file is limited to 15 MB and 50 pages. A text cell over 32,767 characters must be split in the source before export. It does not edit the PDF and does not read image-only pages.",
    "developerName": "Zovo",
    "category": "Data & Analytics",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://pdf-to-excel.zovo.one",
    "supportURL": "https://pdf-to-excel.zovo.one/support",
    "privacyPolicyURL": "https://pdf-to-excel.zovo.one/privacy",
    "termsOfServiceURL": "https://pdf-to-excel.zovo.one/terms",
    "defaultPrompt": [
      "Convert the tables in the attached PDF to Excel, one sheet per table",
      "Extract the table from this PDF and give me a spreadsheet I can open",
      "Turn this bank statement PDF into an Excel workbook and CSV files"
    ],
    "brandColor": "#1D6F42",
    "brandColorDark": "#5BC98C",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/pdf-to-excel/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Price list with numbers and text",
              "prompt": "Convert the tables in the attached price-list PDF to Excel with one sheet per table",
              "tools_triggered": "convert_pdf_tables",
              "expected_behavior": "Calls convert_pdf_tables on the attached price-list PDF and reports 1 table with 5 data rows and 3 columns typed text, number, number. The preview shows 'Widget A' and the unit price 1,234.56 stored as the number 1234.56, and 7.99 as 7.99. The result offers an Excel workbook (one sheet, Table 1) and a CSV ZIP that holds table-1.csv."
            },
            {
              "description": "Inspect a bank statement before exporting",
              "prompt": "Show me what tables are in this PDF statement and how the columns are typed",
              "tools_triggered": "list_pdf_tables",
              "expected_behavior": "Calls list_pdf_tables on the statement PDF and reports 1 table with 60 data rows and 4 columns typed date, text, number, number; the pages 1 and 2 are joined and the repeated header appears once. No download files are offered, and the result suggests convert_pdf_tables for the Excel and CSV export."
            },
            {
              "description": "Two-page statement joined across pages",
              "prompt": "Turn this 2-page bank statement PDF into an Excel workbook and CSV files",
              "tools_triggered": "convert_pdf_tables",
              "expected_behavior": "Calls convert_pdf_tables and returns 1 table with 60 data rows and 4 columns. Amounts such as 2,450.00 become the number 2450 and -82.17 stays -82.17, dates are stored as Excel dates, and the downloads are an Excel workbook plus a CSV ZIP."
            },
            {
              "description": "A report with two different tables",
              "prompt": "Convert this PDF report to an Excel workbook; it has two different tables",
              "tools_triggered": "convert_pdf_tables",
              "expected_behavior": "Calls convert_pdf_tables and finds 2 tables: Table 1 (Item, Qty) with 5 data rows, and Table 2 (Name, Score, Grade) with 5 data rows and scores such as 91 kept as numbers. The workbook has two sheets and the CSV ZIP holds two files."
            },
            {
              "description": "Day-first dates in an orders list",
              "prompt": "Convert this orders PDF to Excel and keep the dates as dates",
              "tools_triggered": "convert_pdf_tables",
              "expected_behavior": "Calls convert_pdf_tables and reads the Placed column as dates with the DD/MM order, shown as 25/03/2026, and types Total as number so $1,200.00 becomes 1200. Downloads are an Excel workbook and a CSV ZIP."
            }
          ],
          "negative": [
            {
              "description": "Scans and photos are out of scope. Expected: the tool is not called; the assistant explains that a photo or scan has no text layer, says no OCR is done, and suggests running OCR first.",
              "prompt": "What does this photo of my receipt say?"
            },
            {
              "description": "PDF editing is out of scope. Expected: the tool is not called; the assistant explains that this plugin reads tables into Excel and CSV and does not delete or edit pages of a PDF.",
              "prompt": "Can you delete page 3 from my PDF?"
            },
            {
              "description": "QR codes are a different job. Expected: the tool is not called; the assistant explains it converts PDF tables to Excel, not QR codes.",
              "prompt": "Make a QR code for my restaurant menu"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://pdf-to-excel.zovo.one/widget-preview"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: find the tables in a text-based PDF, type their columns (text, number, date), and download an Excel workbook (one sheet per table) plus a ZIP of CSV files, with a preview and a per-column type switch in the widget.",
        "translations": {
          "pl-PL": {
            "subtitle": "Tabele z PDF do Excela i CSV",
            "description": "Konwertuj tabele z pliku PDF do skoroszytu Excel (jedno arkusze na tabel\u0119) oraz plik\u00f3w CSV. Wtyczka odczytuje tabele w tekstowym pliku PDF (wyci\u0105gi bankowe, faktury, cenniki, raporty), rozpoznaje typy kolumn i pokazuje podgl\u0105d pierwszych wierszy. Liczby pozostaj\u0105 liczbami, daty staj\u0105 si\u0119 datami Excel w formacie ameryka\u0144skim, a nag\u0142\u00f3wek powtarzany na kolejnej stronie jest usuwany przy \u0142\u0105czeniu tabeli. Ograniczenia: tylko pliki PDF z warstw\u0105 tekstow\u0105 (bez OCR), z\u0142o\u017cone uk\u0142ady z scalonymi kom\u00f3rkami mog\u0105 wymaga\u0107 sprawdzenia r\u0119cznego, maksymalnie 15 MB i 50 stron."
          },
          "de-DE": {
            "subtitle": "PDF-Tabellen zu Excel und CSV",
            "description": "Wandle die Tabellen in einer textbasierten PDF in eine Excel-Arbeitsmappe (ein Blatt pro Tabelle) und CSV-Dateien um. Das Plugin liest Tabellen in PDFs (Kontoausz\u00fcge, Rechnungen, Preislisten, Berichte), erkennt Spaltentypen und zeigt eine Vorschau der ersten Zeilen. Zahlen bleiben Zahlen, Datumsangaben werden zu Excel-Datumsangaben im US-Format, und eine auf der Folgeseite wiederholte Kopfzeile wird beim Zusammenf\u00fchren entfernt. Einschr\u00e4nkungen: nur PDFs mit Textebene (kein OCR), komplexe Layouts mit verbundenen Zellen k\u00f6nnen eine manuelle Pr\u00fcfung erfordern, h\u00f6chstens 15 MB und 50 Seiten."
          },
          "es-ES": {
            "subtitle": "Tablas de PDF a Excel y CSV",
            "description": "Convierte las tablas de un PDF con capa de texto en un libro de Excel (una hoja por tabla) y archivos CSV. La extensi\u00f3n lee las tablas de facturas, estados de cuenta, listas de precios e informes, detecta el tipo de cada columna y muestra una vista previa de las primeras filas. Los n\u00fameros siguen siendo n\u00fameros, las fechas se convierten en fechas de Excel con formato de EE. UU. y la fila de encabezado repetida en una p\u00e1gina siguiente se elimina al unir la tabla. Limitaciones: solo PDF con texto (sin OCR), los dise\u00f1os complejos con celdas combinadas pueden necesitar una revisi\u00f3n manual, y el archivo se limita a 15 MB y 50 p\u00e1ginas."
          },
          "fr-FR": {
            "subtitle": "Tableaux PDF vers Excel et CSV",
            "description": "Convertissez les tableaux d'un PDF texte en classeur Excel (une feuille par tableau) et en fichiers CSV. L'extension lit les tableaux des relev\u00e9s, factures, listes de prix et rapports, d\u00e9tecte le type de chaque colonne et affiche un aper\u00e7u des premi\u00e8res lignes. Les nombres restent des nombres, les dates deviennent des dates Excel au format am\u00e9ricain, et la ligne d'en-t\u00eate r\u00e9p\u00e9t\u00e9e sur la page suivante est supprim\u00e9e lors de la fusion du tableau. Limites : PDF avec couche de texte uniquement (pas d'OCR), les mises en page complexes avec cellules fusionn\u00e9es peuvent demander une v\u00e9rification manuelle, et le fichier est limit\u00e9 \u00e0 15 Mo et 50 pages."
          },
          "ja-JP": {
            "subtitle": "PDF\u306e\u8868\u3092Excel\u3068CSV\u306b\u5909\u63db",
            "description": "\u30c6\u30ad\u30b9\u30c8\u5f62\u5f0f\u306ePDF\u306b\u3042\u308b\u8868\u3092\u3001Excel\u30d6\u30c3\u30af\uff08\u8868\u3054\u3068\u306b1\u30b7\u30fc\u30c8\uff09\u3068CSV\u30d5\u30a1\u30a4\u30eb\u306b\u5909\u63db\u3057\u307e\u3059\u3002\u8acb\u6c42\u66f8\u3001\u660e\u7d30\u3001\u4fa1\u683c\u8868\u3001\u30ec\u30dd\u30fc\u30c8\u306a\u3069\u306ePDF\u304b\u3089\u8868\u3092\u8aad\u307f\u53d6\u308a\u3001\u5217\u306e\u7a2e\u985e\u3092\u5224\u5b9a\u3057\u3066\u5148\u982d\u884c\u306e\u30d7\u30ec\u30d3\u30e5\u30fc\u3092\u8868\u793a\u3057\u307e\u3059\u3002\u6570\u5024\u306f\u6570\u5024\u306e\u307e\u307e\u3001\u65e5\u4ed8\u306f\u7c73\u56fd\u5f62\u5f0f\u306eExcel\u306e\u65e5\u4ed8\u306b\u306a\u308a\u3001\u6b21\u30da\u30fc\u30b8\u3067\u7e70\u308a\u8fd4\u3055\u308c\u308b\u898b\u51fa\u3057\u884c\u306f\u8868\u3092\u7d50\u5408\u3059\u308b\u3068\u304d\u306b\u53d6\u308a\u9664\u304b\u308c\u307e\u3059\u3002\u5236\u9650\uff1a\u30c6\u30ad\u30b9\u30c8\u30ec\u30a4\u30e4\u30fc\u306e\u3042\u308bPDF\u306e\u307f\uff08OCR\u306a\u3057\uff09\u3001\u7d50\u5408\u30bb\u30eb\u3092\u542b\u3080\u8907\u96d1\u306a\u30ec\u30a4\u30a2\u30a6\u30c8\u306f\u624b\u52d5\u3067\u306e\u78ba\u8a8d\u304c\u5fc5\u8981\u306a\u5834\u5408\u304c\u3042\u308a\u307e\u3059\u3002\u30d5\u30a1\u30a4\u30eb\u306f\u6700\u592715 MB\u300150\u30da\u30fc\u30b8\u307e\u3067\u3067\u3059\u3002"
          },
          "pt-BR": {
            "subtitle": "Tabelas PDF para Excel e CSV",
            "description": "Converta as tabelas de um PDF com texto em uma pasta de trabalho do Excel (uma planilha por tabela) e arquivos CSV. A extens\u00e3o l\u00ea tabelas de extratos, faturas, listas de pre\u00e7os e relat\u00f3rios, detecta o tipo de cada coluna e mostra uma pr\u00e9via das primeiras linhas. Os n\u00fameros continuam sendo n\u00fameros, as datas viram datas do Excel no formato dos EUA, e a linha de cabe\u00e7alho repetida em uma p\u00e1gina seguinte \u00e9 removida ao juntar a tabela. Limita\u00e7\u00f5es: apenas PDF com camada de texto (sem OCR), layouts complexos com c\u00e9lulas mescladas podem exigir confer\u00eancia manual, e o arquivo \u00e9 limitado a 15 MB e 50 p\u00e1ginas."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}